SEOgadget Links API Extension for Excel - Mozcon 2012

33
Link Analytics Through APIs Richard Baxter CEO + Senior Search Marketing Strategist SEOgadget SEOgadget.co.uk/mozscape @richardbaxter

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

Page 1: 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

Page 2: SEOgadget Links API Extension for Excel - Mozcon 2012

Data

It’s a problem.

Page 3: SEOgadget Links API Extension for Excel - Mozcon 2012

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

So,

Here’s something we made for Mozcon.

Page 4: SEOgadget Links API Extension for Excel - Mozcon 2012

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

Some text here

Page 5: SEOgadget Links API Extension for Excel - Mozcon 2012

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

Page 6: SEOgadget Links API Extension for Excel - Mozcon 2012

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

Page 7: SEOgadget Links API Extension for Excel - Mozcon 2012

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

Page 8: SEOgadget Links API Extension for Excel - Mozcon 2012

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

First

Some basics.

Page 9: SEOgadget Links API Extension for Excel - Mozcon 2012

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

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 }

Page 10: SEOgadget Links API Extension for Excel - Mozcon 2012

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

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

AND YOU CAN DO THAT, IN EXCEL

=DownloadString()

=JsonPathOnUrl()

Page 11: SEOgadget Links API Extension for Excel - Mozcon 2012

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

GET CONTACTS WITH WHOIS

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

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

Page 12: SEOgadget Links API Extension for Excel - Mozcon 2012

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

It’s SEOmoz

So, let’s look at their API.

Page 13: SEOgadget Links API Extension for Excel - Mozcon 2012

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

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

Page 14: SEOgadget Links API Extension for Excel - Mozcon 2012

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

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

Page 15: SEOgadget Links API Extension for Excel - Mozcon 2012

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

BIT FLAGS ARE AWESOME

Cols=

Page 16: SEOgadget Links API Extension for Excel - Mozcon 2012

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

That’s cool

But what was that thing you showed us?

Page 17: SEOgadget Links API Extension for Excel - Mozcon 2012

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

SEOGADGET MOZSCAPE API EXTENSION FOR EXCEL

LINKS API EXTENSION FOR EXCEL

SEOgadget.co.uk/mozscape

Page 18: SEOgadget Links API Extension for Excel - Mozcon 2012

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

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

URL Metrics

• =SEOMOZ_URLMetrics()

Links API

• SEOMOZ_Linksapi()

Anchor Text

• =SEOMOZ_anchorTextAPI()

Top Pages

• =SEOMOZ_TopPages()

Page 19: SEOgadget Links API Extension for Excel - Mozcon 2012

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

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

Page 20: SEOgadget Links API Extension for Excel - Mozcon 2012

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

=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

Page 21: SEOgadget Links API Extension for Excel - Mozcon 2012

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

=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

Page 22: SEOgadget Links API Extension for Excel - Mozcon 2012

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

=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

Page 23: SEOgadget Links API Extension for Excel - Mozcon 2012

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

Build:

Open Site Explorer, in Excel

Page 24: SEOgadget Links API Extension for Excel - Mozcon 2012

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

Some text here

Page 25: SEOgadget Links API Extension for Excel - Mozcon 2012

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

Our Query

Data Validation (Drop down)

URL text entry

Uses Excel data validation to make the variables, variable.

Page 26: SEOgadget Links API Extension for Excel - Mozcon 2012

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

Find:

High volume, low competition keywords.

Page 27: SEOgadget Links API Extension for Excel - Mozcon 2012

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

Page 28: SEOgadget Links API Extension for Excel - Mozcon 2012

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

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

Page 29: SEOgadget Links API Extension for Excel - Mozcon 2012

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

Steal:

The contact details of your competitor’s most

valuable links.

Page 30: SEOgadget Links API Extension for Excel - Mozcon 2012

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

Page 31: SEOgadget Links API Extension for Excel - Mozcon 2012

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

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

Page 32: SEOgadget Links API Extension for Excel - Mozcon 2012

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

THANK YOU

@richardbaxter SEOgadget.co.uk

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

Email me: [email protected]

Download this presentation for the full extension query guide:

Page 33: SEOgadget Links API Extension for Excel - Mozcon 2012

Richard Baxter

CEO + Senior Search Marketing Strategist

SEOgadget

http://seogadget.co.uk

@richardbaxter

Download: SEOgadget.co.uk/mozscape