Feeds

List Campaign Rankings by Date

Arguments

campaign_id required intger (32)

The ID of the campaign to retreive feed for

start_date required date

The start of the range of results to return. Should be a string in the format of YYYY-MM-DD

end_date required date

The end of the range of results to return. Should be a string in the format of YYYY-MM-DD

filter string

fuzzy match

page string

The page to return

limit integer (32)

The number of records to return

sort_metric string

The field to sort results by

sort_direction string

The direction of the sort set by sort_metric. May be either asc or dsc.

compare_previous_period string

Enable comparison mode. When set to true, the data returned will represent the net change between the previous and current period. The current period is determined by start_date and end_date.

Endpoint

GET /v3/resources/rankings/campaign/date

Response

json
 {
  "metadata": {
    "total_pages": 1,
    "total_records": 1
  },
  "data": {
    "totals": false,
    "rows": [
      {
        "keywordId": 1260175,
        "keywordPhrase": "seo software",
        "primaryKeyword": "true",
        "googleRanking": 36,
        "googleRankingChange": -7,
        "googleRankingUrl": "http:\/\/www.myseotool.com\/",
        "googleSerpUrl": "https:\/\/www.google.ca\/...",
        "googlePlacesRanking": 0,
        "googlePlacesRankingChange": 0,
        "googleMapsSerpUrl": "https:\/\/www.google.ca\/maps\/...",
        "bingRanking": 0,
        "bingRankingChange": 0,
        "bingRankingUrl": null,
        "globalMonthlySearches": 8100,
        "localMonthlySearches": 260,
        "competitors": 74300,
        "gwtRanking": 41,
        "gwtClicks": 0,
        "gwtImpressions": 5930,
        "gwtCtr": 0,
        "backlinks": 0,
        "lastGoogleRankingDate": "2015-02-24 20:08:47",
        "lastGooglePlacesRankingDate": "2015-02-24 09:36:55",
        "lastBingRankingDate": "2015-02-25 00:14:45",
        "lastSearchVolumeDate": "2015-02-12",
        "tags": [
          {
            "id": 22289,
            label":"tester
          },
          {
            "id": 25054,
            label":"newtag
          }
        ]
      }
    ]
  }
}

List Campaign Rankings by Keyword

Arguments

campaign_id required intger (32)

The ID of the campaign to retreive feed for

start_date required date

The start of the range of results to return. Should be a string in the format of YYYY-MM-DD

end_date required date

The end of the range of results to return. Should be a string in the format of YYYY-MM-DD

filter string

fuzzy match

page string

The page to return

limit integer (32)

The number of records to return

sort_metric string

The field to sort results by

sort_direction string

The direction of the sort set by sort_metric. May be either asc or dsc.

compare_previous_period string

Enable comparison mode. When set to true, the data returned will represent the net change between the previous and current period. The current period is determined by start_date and end_date.

Endpoint

GET /v3/resources/rankings/campaign

Response

json
 {
  "metadata": {
    "total_pages": 1,
    "total_records": 1
  },
  "data": {
    "totals": false,
    "rows": [
      {
        "keywordId": 1260175,
        "keywordPhrase": "seo software",
        "primaryKeyword": "true",
        "googleRanking": 36,
        "googleRankingChange": -7,
        "googleRankingUrl": "http:\/\/www.myseotool.com\/",
        "googleSerpUrl": "https:\/\/www.google.ca\/...",
        "googlePlacesRanking": 0,
        "googlePlacesRankingChange": 0,
        "googleMapsSerpUrl": "https:\/\/www.google.ca\/maps\/...",
        "bingRanking": 0,
        "bingRankingChange": 0,
        "bingRankingUrl": null,
        "globalMonthlySearches": 8100,
        "localMonthlySearches": 260,
        "competitors": 74300,
        "gwtRanking": 41,
        "gwtClicks": 0,
        "gwtImpressions": 5930,
        "gwtCtr": 0,
        "backlinks": 0,
        "lastGoogleRankingDate": "2015-02-24 20:08:47",
        "lastGooglePlacesRankingDate": "2015-02-24 09:36:55",
        "lastBingRankingDate": "2015-02-25 00:14:45",
        "lastSearchVolumeDate": "2015-02-12",
        "tags": [
          {
            "id": 22289,
            label":"tester
          },
          {
            "id": 25054,
            label":"newtag
          }
        ]
      }
    ]
  }
}

List Keyword Rankings by Date

Arguments

keyword_id required intger (32)

The ID of the keyword to retreive feed for

start_date required date

The start of the range of results to return. Should be a string in the format of YYYY-MM-DD

end_date required date

The end of the range of results to return. Should be a string in the format of YYYY-MM-DD

filter string

fuzzy match

page string

The page to return

limit integer (32)

The number of records to return

sort_metric string

The field to sort results by

sort_direction string

The direction of the sort set by sort_metric. May be either asc or dsc.

compare_previous_period string

Enable comparison mode. When set to true, the data returned will represent the net change between the previous and current period. The current period is determined by start_date and end_date.

Endpoint

GET /v3/resources/rankings/keyword/date

Response

json
 {
  "metadata": {
    "total_pages": 1,
    "total_records": 1
  },
  "data": {
    "totals": false,
    "rows": [
      {
        "keywordId": 1260175,
        "keywordPhrase": "seo software",
        "primaryKeyword": "true",
        "googleRanking": 36,
        "googleRankingChange": -7,
        "googleRankingUrl": "http:\/\/www.myseotool.com\/",
        "googleSerpUrl": "https:\/\/www.google.ca\/...",
        "googlePlacesRanking": 0,
        "googlePlacesRankingChange": 0,
        "googleMapsSerpUrl": "https:\/\/www.google.ca\/maps\/...",
        "bingRanking": 0,
        "bingRankingChange": 0,
        "bingRankingUrl": null,
        "globalMonthlySearches": 8100,
        "localMonthlySearches": 260,
        "competitors": 74300,
        "gwtRanking": 41,
        "gwtClicks": 0,
        "gwtImpressions": 5930,
        "gwtCtr": 0,
        "backlinks": 0,
        "lastGoogleRankingDate": "2015-02-24 20:08:47",
        "lastGooglePlacesRankingDate": "2015-02-24 09:36:55",
        "lastBingRankingDate": "2015-02-25 00:14:45",
        "lastSearchVolumeDate": "2015-02-12",
        "tags": [
          {
            "id": 22289,
            label":"tester
          },
          {
            "id": 25054,
            label":"newtag
          }
        ]
      }
    ]
  }
}