SEOgadget Links API Extension for Excel - Mozcon 2012

Post on 26-Jan-2015

113 views 0 download

description

My presentation and technical documentation for the SEOgadget Links API Extension for Excel for Mozscape, SEOmoz's API service.

Transcript of SEOgadget Links API Extension for Excel - Mozcon 2012

Link Analytics Through APIs Richard Baxter

CEO + Senior Search Marketing Strategist

SEOgadget

SEOgadget.co.uk/mozscape

@richardbaxter

Data

It’s a problem.

............................................................................................................................................................

So,

Here’s something we made for Mozcon.

............................................................................................................................................................

Some text here

............................................................................................................................................................

............................................................................................................................................................

............................................................................................................................................................

............................................................................................................................................................

First

Some basics.

............................................................................................................................................................

http://api.sharedcount.com/?url=https://seogadget.co.uk/conversion-rate-optimisation/

{ "StumbleUpon":5, "Reddit":0, "Facebook": { "commentsbox_count":0, "click_count":0, "total_count":167, "comment_count":10, "like_count":94, "share_count":63 }, "Delicious":31, "GooglePlusOne":162, "Buzz":0, "Twitter":339, "Diggs":0, "Pinterest":5, "LinkedIn":109 }

............................................................................................................................................................

Go get SEO Tools For Excel: http://nielsbosma.se/projects/seotools/

AND YOU CAN DO THAT, IN EXCEL

=DownloadString()

=JsonPathOnUrl()

............................................................................................................................................................

GET CONTACTS WITH WHOIS

=JsonPathOnUrl(A1,"$..email")

Check out http://tools.seogadget.co.uk/use_api/

............................................................................................................................................................

It’s SEOmoz

So, let’s look at their API.

............................................................................................................................................................

Source: http://apiwiki.seomoz.org/w/browse/#view=ViewFolder&param=API%20Calls

URL Metrics

• Returns the metrics about a URL or set of URLs

Links API • Returns a set of links to a page or domain

Anchor Text

• Returns a set of anchor text terms or phrases aggregated across links to a page or domain

Top Pages • Returns the metrics about many URLs on a given subdomain

............................................................................................................................................................

EXAMPLE API CALL – URL METRICS

lsapi.seomoz.com/linkscape/url-metrics/SEOgadget.co.uk?Cols=103616137253&AccessID=[xx]member-[xx]&Expires=[xx]&Signature=[xx]

{ "fmrp":5.389550819685061, "fmrr":5.252956368081573e-08, "frid":664825661, "pda":61.91763828018695, "prid":162039085,"ueid":7535, "uid":8534, "umrp":5.497289201302133, "umrr":3.812463025080019e-09, "upa":68.46560739776623, "us":301, "ut":"", "uu":"seogadget.co.uk/“ }

To generate a valid request: http://bit.ly/LzRG4W & to authenticate http://bit.ly/Occb5j

JSON response fields

URL Metric Big Flags

............................................................................................................................................................

BIT FLAGS ARE AWESOME

Cols=

............................................................................................................................................................

That’s cool

But what was that thing you showed us?

............................................................................................................................................................

SEOGADGET MOZSCAPE API EXTENSION FOR EXCEL

LINKS API EXTENSION FOR EXCEL

SEOgadget.co.uk/mozscape

............................................................................................................................................................

Take a look: http://seogadget.co.uk/mozscape

URL Metrics

• =SEOMOZ_URLMetrics()

Links API

• SEOMOZ_Linksapi()

Anchor Text

• =SEOMOZ_anchorTextAPI()

Top Pages

• =SEOMOZ_TopPages()

............................................................................................................................................................

The 1st argument [URL] can be either a single URL (without the http://) or a list of URLS (via a vertical or horizontal range). The 2nd argument is the bit flag to indicate which columns to return. Example: =SEOMOZ_URLMetrics_toFit(A1,"Cols=103079215109") Will return: Title (ut), URL (uu), Page Authority (upa), Domain Authority (pda)

=SEOMOZ_URLMetrics([URL],[BIT])

=SEOMOZ_URLMetrics_toFit(A1,"Cols=1"))

Read the API call documentation: http://bit.ly/Q9nIHS on SEOmoz

............................................................................................................................................................

=SEOMOZ_anchorTextAPI()

The 1st argument [URL] can be either a single URL (without the http://) or a list of URLS (via a vertical or horizontal range). The 2nd argument [SCOPE] eg: “page_to_page” Returns a set of Source pages linking to the specified Target page – for a full list see: http://bit.ly/MM826N The 3rd argument [SORT] eg: “page_authority” Sort results by Page Authority – for a full list see: http://bit.ly/MM826N The 4th argument [BIT] The bit flag to indicate which columns to return. Leave blank for this version of the release. The 5th argument [LIMIT] How many results do we require? Paid API will allow more results The 6th argument [CHUNK] Send request in batches – for example, fetch 100 results requesting in batches of 10 URLs per API call Example: =SEOMOZ_anchorTextAPI_toFit(A2,"phrase_to_domain","domains_linking_page",,100,) Will return: Internal Subdomains Linking (appif), Term or Phrase (appt), Internal Pages Linking (appef), External Subdomains Linking (appimp), Internal mozRank passed (appimp), External Pages Linking (appeu), External mozRankPassed (appemp), ExternalRoot DomainsLinking (appep), External Subdomains Linking (appf).

=SEOMOZ_anchorTextAPI_toFit ([URL],[SCOPE],[SORT],[BIT],[LIMIT],[CHUNK])

Limited and Chunked! This is a chunked API call – batches urls

and sends in single API calls. For example, you can fetch 100 results requesting in

batches of 10 URLs per API call.

Refer to the documentation: http://apiwiki.seomoz.org/w/page/13991127/Anchor%20Text%20API

............................................................................................................................................................

=SEOMOZ_TopPages_toFit()

The 1st argument [URL] can be either a single URL (without the http://) or a list of URLS (via a vertical or horizontal range). The 2nd argument [BIT] the bit flag to indicate which columns to return – refer to this list of bit fields http://bit.ly/Oe9C2F The 3rd argument [LIMIT] how many results do we require? Paid API will allow more results! The 4th argument [CHUNK] send request in batches – for example, fetch 100 results requesting in batches of 10 URLs per API call Example: =SEOMOZ_TopPages_toFit(A2,"Cols=103616137253",100,20) Will return linking title (ut), URL (uu), external links (ueid), links (uid), mozRank (umrp), mozRank raw (umrr), Subdomain mozRank (fmrp) + (fmrr), http status (us), Page Authority (upa) and Domain Authority (pda)

=SEOMOZ_TopPages_toFit ([URL],[BIT],[LIMIT],[CHUNK])

Refer to the documentation on SEOmoz: http://bit.ly/SLg8ku

............................................................................................................................................................

=SEOMOZ_Linksapi()

The 1st argument [URL] can be either a single URL (without the http://) or a list of URLS (via a vertical or horizontal range). The 2nd argument [SCOPE] eg: “page_to_page” Returns a set of Source pages linking to the specified Target page – for a full list see: http://bit.ly/MM826N The 3rd argument [SORT] eg: “page_authority” Sort results by Page Authority – for a full list see: http://bit.ly/MM826N The 4th argument [FILTER] apply a filter to the call, eg: “external+follow” for external, followed links – full list: http://bit.ly/MM826N The 5th argument [TARGETCOLS] specifies data about the target of the link is included eg: “TargetCols=8” would give the linked to subdomain The 6th argument [SOURCECOLS] specifies data about the source page of the link eg: “SourceCols=103079215109” would give OSE results! The 7th argument [LINKCOLS] specifies data about the link itself, eg “LinkCols=8” would give normalised anchor text The 8th argument [LIMIT] how many results do we require? Paid API will allow more results! The 9th argument [CHUNK] send request in batches – for example, fetch 100 results requesting in batches of 10 URLs per API call Example: =SEOMOZ_linksAPI_toFit(A7,"page_to_page","page_authority","external+follow","TargetCols=8","SourceCols=103079215109","LinkCols=8",1000,50)

=SEOMOZ_linksapi_toFit ([URL],[SCOPE],[SORT],[FILTER],

[TARGETCOLS],[SOURCECOLS],[LINKCOLS],[LIMIT],[CHUNK])

Refer to the documentation on SEOmoz: http://bit.ly/MM826N

............................................................................................................................................................

Build:

Open Site Explorer, in Excel

............................................................................................................................................................

Some text here

............................................................................................................................................................

Our Query

Data Validation (Drop down)

URL text entry

Uses Excel data validation to make the variables, variable.

............................................................................................................................................................

Find:

High volume, low competition keywords.

............................................................................................................................................................

............................................................................................................................................................

Av Search Volume

EPIC QUERY LENGTH

Keyword Ranking URLs

(1,23) Root domain links

Then we average out the linking root domains across the top 3 ranking URLs

............................................................................................................................................................

Steal:

The contact details of your competitor’s most

valuable links.

............................................................................................................................................................

............................................................................................................................................................

GET CONTACT DETAILS WITH OUR API

Woot! http://tools.seogadget.co.uk/use_api/

http://tools.seogadget.co.uk/api/v1/get_data?linking_url=http://www.iloveseo.net/&apikey=XXXX

............................................................................................................................................................

THANK YOU

@richardbaxter SEOgadget.co.uk

Thanks for listening! Email, Tweet or just say hi!

Email me: richard@seogadget.co.uk

Download this presentation for the full extension query guide:

Richard Baxter

CEO + Senior Search Marketing Strategist

SEOgadget

http://seogadget.co.uk

@richardbaxter

Download: SEOgadget.co.uk/mozscape