Get Keyword Data

GET

https://apigw.seomonitor.com/v3/research/v3.0/keywords

This endpoint returns the SERP, search and your ranking data for the keywords specified in the request.

Request

Authorization

Add parameter in header

Authorization

Example:

Authorization: ********************

Query Params

campaign_id

integer

required

(Required) This parameter specifies the ID of the campaign for which you want to return data.

Please refer to the Quick Start Guide to learn how to retrieve the IDs of your campaigns.

Example:

keywords

string

required

(Required) Comma-separated list of keyword phrases that you want to return data for.

Example:

limit

integer

optional

This parameter determines the maximum number of records to return in a single request.

Maximum Value: 1000 records per request

If you do not specify a limit, the default number of records returned per request will be 100.

Example:

offset

integer

optional

This parameter specifies the starting point within the collection of resource results. It's typically used with the limit parameter to implement pagination.

If you do not specify an offset, the API will start from the first record.

Example:

order_by

string

optional

This parameter enables you to sort the returned data based on a specified field.

The field names you can use to sort data are:

search_volume

year-over-year

rank

rank_trend

percentage_clicks

Example:

order_direction

string

optional

This parameter determines the sorting direction of the order_by field. You can sort the data in either ascending (asc) or descending (desc) order.

If you do not specify an order_direction, the default is asc.

Example:

Header Params

string

required

Example:

application/json

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request GET 'https://apigw.seomonitor.com/v3/research/v3.0/keywords?campaign_id={{campaign_id}}&keywords={{keywords}}&limit={{limit}}&offset={{offset}}&order_by={{order_by}}&order_direction={{order_direction}}' \
--header 'Accept: application/json' \
--header 'Authorization;'

Responses

🟢200Success

application/json

Body

array of:

keyword

string

optional

The exact keyword phrase.

search_data

object

optional

Parent field containing the data related to Google desktop search volumes.

search_volume

integer

optional

The average 12-month desktop search volume as provided by Google Ads.

year_over_year

number

optional

A numeric value representing the last month's search volume divided by the search volume of the same month of the previous year. E.g. +49% year-over-year search trend would be represented as 1.49. The returned values will be capped at 10, which represents "newcomers" (keywords that registered very low search volumes in the previous year).

monthly_searches

object

optional

An array of objects containing the search volumes for each of the previous 13 months as provided by Google Ads.

ranking_data

object

optional

Parent field containing the Google ranking data associated with the keyword.

updated_on

string

optional

The date when the latest crawl was performed, in YYYY-MM-DD format.

rank

integer

optional

The position on Google at the latest crawl date refreshed within the past 30 days, for desktop devices.

trend

integer

optional

The difference in positions on Google between the latest rank and the rank identified at the previous crawl, for desktop devices.

landing_page

string

optional

The landing page of your website that is currently ranking with the keyword on Google searches performed from desktop devices.

serp_data

object

optional

Parent field containing the SERP features data on desktop search results for the keyword recorded on the latest crawl date refreshed within the past 30 days. Please refer to the Quick Start Guide for the complete feature name of each abbreviation.

percentage_clicks

number

optional

The percentage of searches that end up clicking on organic results, based on the sum of Top 10 positions' CTRs after discounting the searches satisfied by SERP features.

serp_features

object

optional

Parent field containing the data for the SERP features present for the keyword on the latest crawl date.

tracked_keyword_id

integer

optional

The unique ID used to identify and reference the keyword in the system. Returned only if the keyword is tracked in the SEOmonitor campaign. It can be stored and used in other endpoints for filtering.

Example

[
  {
    "keyword": "seo research",
    "search_data": {
      "search_volume": 18100,
      "year_over_year": 1.49,
      "monthly_searches": [
        {
          "month": "August",
          "year": 2023,
          "search_volume": 27100
        }
      ]
    },
    "ranking_data": {
      "updated_on": "2023-09-06",
      "rank": 45,
      "trend": 3,
      "landing_page": "https://deliveroo.co.uk/restaurants/manchester/sale"
    },
    "serp_data": {
      "percentage_clicks": 0.77,
      "serp_features": [
        {
          "feature": "IMG",
          "position": 4
        }
      ]
    },
    "tracked_keyword_id": 1789784
  }
]

Modified at 2024-11-05 13:59:34

Get Ranking Keywords

Get Ranking Data