linkscape

0.1.2 • Public • Published

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

Keywords

none

Install

npm i linkscape

DownloadsWeekly Downloads

5

Version

0.1.2

License

none

Last publish

Collaborators

  • peterson514