Asynchronous library to access the SEOmoz Linkscape API for nods.js
JavaScript
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
lib
.gitignore
LICENSE
README.md
package.json

README.md

SeoMOZ Linkscape API Library

Node-linkscape is a node.js module for asynchronously communicating with the seoMOZ linkscape APIs. It supports the url-metrics, links, anchor-text, and top-pages APIs.

Installation

Use npm to install node-linkscape

npm install linkscape

Usage

var Linkscape = require('linkscape').Linkscape;

var seomoz = new Linkscape('your-access-id', 'your-secret');
seomoz.urlMetrics('www.google.com', ['url', 'links'], function(err, res) {
    if (err) {
        console.log(err);
        return;
    }

    console.log(res);
});

Methods Available

urlMetrics

seomoz.urlMetrics(url, cols, callback)
  • url The URL you want metrics for, ex: 'www.google.com'
  • cols An array of strings for the columns you want in the response (see Linkscape.URL_METRICS_FLAGS). Ex: ['title', 'url', 'links']
  • callback A function to be called asynchronously once the response comes back from the API. The function should accept 2 arguments in the following order: error, result where error will either be an object or null, and result will be an object containing the response from seoMOZ.

links

seomoz.links(url, scope, options, callback)
  • url The URL you want to get links for, ex: www.google.com
  • scope The scope of the results as per the seoMOZ API docs, ex: page_to_page
  • options An object with any of the following:

    • sort As per the seoMOZ API docs, ex: page_authority
    • filter An array of strings, ex: ['internal', external', 'nofollow']
    • targetCols Array of strings for the columns returned for the target of the link, see Linkscape.URL_METRICS_FLAGS
    • sourceCols Array of strings for the columns returned for the source of the link, see Linkscape.URL_METRICS_FLAGS
    • linkCols Array of strings for the columns for the link itself, see Linkscape.LINK_FLAGS
  • callback Same as urlMetrics.

anchorText

seomoz.anchorText(url, scope, cols, callback)
  • url The URL you want to get anchor texts for, ex: www.google.com
  • scope Scope of the link as per the seoMOZ API docs, ex: phrase_to_page
  • cols Array of strings for the columns returned, see Linkscape.ANCHOR_TEXT_FLAGS
  • callback Same as urlMetrics.

topPages

seomoz.topPages(url, cols, options, callback)
  • url The subdomain you want results for
  • cols An array of strings for the columns you want in the response (see Linkscape.URL_METRICS_FLAGS). Ex: ['title', 'url', 'links']
  • options An object with any of the following:

    • offset Return starting at the nth result
    • limit How many results to return (max 1000)
  • callback Same as urlMetrics