Feeds
List Campaign Rankings by Date
Arguments
campaign_id required intger (32) | The ID of the campaign to retrieve feed for |
start_date required date | The start of the range of results to return. Should be a string in the format of |
end_date required date | The end of the range of results to return. Should be a string in the format of |
search 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 |
compare_previous_period string | Enable comparison mode. When set to |
Endpoint
GET /v3/resources/rankings/campaign/date
Response
{ "metadata": { "total_records": 2, "total_pages": 1, "version": false }, "data": [ { "date": "2018-01", "googleRanking": 10, "googleRankingChange": -4, "googleRankings_1_3": 2, "googleRankings_4_10": 3, "googleRankings_11_20": 1, "googleRankings_21_50": 3, "googleRankings_51": 1, "googleMobileRanking": 10, "googleMobileRankingChange": -4, "googleMobileRankings_1_3": 2, "googleMobileRankings_4_10": 3, "googleMobileRankings_11_20": 1, "googleMobileRankings_21_50": 3, "googleMobileRankings_51": 1, "googlePlacesRanking": 10, "googlePlacesRankingChange": 0, "googlePlacesRankings_1_3": 2, "googlePlacesRankings_4_10": 3, "googlePlacesRankings_11_20": 1, "googlePlacesRankings_21_50": 3, "googlePlacesRankings_51": 1, "bingRanking": 10, "bingRankingChange": -5, "bingRankings_1_3": 2, "bingRankings_4_10": 3, "bingRankings_11_20": 1, "bingRankings_21_50": 3, "bingRankings_51": 1, "competitors": 132969000, "localMonthlySearches": 69260 } ], "totals": { "googleRanking": { "value": 10 }, "googleRankingChange": { "value": 10 }, "googleMobileRanking": { "value": 10 }, "googleMobileRankingChange": { "value": 3 }, "googlePlacesRanking": { "value": 10 }, "googlePlacesRankingChange": { "value": 15 }, "bingRanking": { "value": 10 }, "bingRankingChange": { "value": -7 }, "competitors": { "value": 320001000 }, "localMonthlySearches": { "value": 90750 } } }
List Campaign Rankings by Keyword
Arguments
campaign_id required intger (32) | The ID of the campaign to retrieve feed for |
start_date required date | The start of the range of results to return. Should be a string in the format of |
end_date required date | The end of the range of results to return. Should be a string in the format of |
search 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 |
compare_previous_period string | Enable comparison mode. When set to |
Endpoint
GET /v3/resources/rankings/campaign
Response
{ "metadata": { "total_records": 10, "total_pages": 1, "version": false }, "data": [ { "keywordId": 5, "keywordPhrase": "tesla used car price", "searchLocation": { "id": 4, "canonical_name": "toronto,ontario,canada", "country_code": "ca", target_type": "city }, "searchLanguage": { "id": 4, name": "English }, "primaryKeyword": "", "googleRanking": 37, "googleRankingChange": -4, "googleRankingUrl": "https://www.tesla.com/modelx/", "googleSerpUrl": null, "googleMobileRanking": 18, "googleMobileRankingChange": 7, "googleMobileRankingUrl": "https://www.tesla.com/models/", "googleMobileSerpUrl": null, "googlePlacesRanking": 81, "googlePlacesRankingChange": -1, "googleMapsSerpUrl": null, "bingRanking": 6, "bingRankingChange": 15, "bingRankingUrl": "https://www.tesla.com/models/", "bingSerpUrl": null, "localMonthlySearches": 0, "competitors": 0, "lastGoogleRankingDate": "2019-07-27", "lastGoogleMobileRankingDate": "2019-07-27", "lastGooglePlacesRankingDate": "2019-07-26", "lastBingRankingDate": "2019-07-27", "lastSearchVolumeDate": "2019-07-27", "lastStatPadderDate": "2019-07-26", "lastMetricRollupDate": "2019-07-27", "lastResultsDate": "2019-07-26", "tags": [ { "id": 2, label": "Secondary } ] } ] }
List Keyword Rankings by Date
Arguments
keyword_id required intger (32) | The ID of the keyword to retrieve feed for |
start_date required date | The start of the range of results to return. Should be a string in the format of |
end_date required date | The end of the range of results to return. Should be a string in the format of |
search 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 |
compare_previous_period string | Enable comparison mode. When set to |
Endpoint
GET /v3/resources/rankings/keyword/date
Response
{ "metadata": { "total_records": 2, "total_pages": 1, "version": false }, "data": [ { "date": "2018-01", "googleRanking": 86, "googleRankingUrl": "https://www.tesla.com/models/", "googleMobileRanking": 11, "googleMobileRankingUrl": "https://www.tesla.com/powerwall/", "googlePlacesRanking": 15, "bingRanking": 23, "bingRankingUrl": "https://www.tesla.com/models/", "competitors": 142409000, "localMonthlySearches": 64920 } ], "totals": { "googleRanking": { "value": 30 }, "googleMobileRanking": { "value": 30 }, "googlePlacesRanking": { "value": 23 }, "bingRanking": { "value": 70 }, "competitors": { "value": 320001000 }, "localMonthlySearches": { "value": 160010 } } }