Keyword Research

Export

This method allows users to retrieve various data points for a list of specified keywords within a given regional database. It’s designed for bulk analysis and returns metrics like search volume, CPC, competition, keyword difficulty, and historical search volume trends for each submitted keyword.

Request Parameters: export

Parameter	Location	Data Type	Mandatory	Default Value	Description	Acceptable Values	Example
source	query	string	Yes	N/A	Alpha-2 country code of the regional keyword database.	See Regional Database Codes.	us
keywords[]	form-data	string	Yes	N/A	For a single keyword, use one `keywords[]` parameter.		seo ranking
keywords[]	form-data	string	No	N/A	Repeat the `keywords[]` to analyze multiple keywords. A maximum of 5,000 keywords can be submitted per call.		seo competitors
sort	form-data	string	No	cpc	The field by which the returned list of keywords should be sorted. Common sortable fields include volume, cpc, difficulty, competition.	volume, cpc, difficulty, competition, history_trend	cpc
sort_order	form-data	string	No	desc	The order of sorting for the sort field.	asc: ascending desc: descending	desc
cols	form-data	string	No	keyword, volume, cpc, competition, difficulty, history_trend	A comma-separated list of specific response parameter names to include in the output for each keyword. If omitted, all available data points are returned.	keyword, volume, cpc, competition, difficulty, history_trend	keyword, volume, difficulty

POST Request

The request should be made as a POST request with parameters sent as form data. The source parameter should be included as a query parameter in the endpoint URL.

Title of the code block

Copy

curl -X POST 'https://api.seranking.com/v1/keywords/export?source=us' \

  -H 'Authorization: Token YOUR_API_KEY' \

  --form 'keywords[]="seo platform"' \

  --form 'keywords[]="seranking.com"' \

  --form 'sort="cpc"' \

  --form 'sort_order="desc"' \

  --form 'cols="keyword,volume,cpc,competition,difficulty,history_trend"'

Response Parameters: export

If successful, the server returns a JSON array. Each object in this array corresponds to one of the keywords submitted in the request and contains the requested data points.

Parameter	Data Type	Description	Example
is_data_found	boolean	Indicates whether data was successfully found and retrieved for this specific keyword. true if found, false otherwise.	TRUE
keyword	string	The keyword phrase itself, as submitted in the request.	“seranking.com”
volume	integer	The average monthly search volume for this keyword in the specified source database.	10
cpc	float	The average Cost Per Click (CPC) for this keyword.	0
competition	string or float	A score or indicator of the level of competition for this keyword (e.g., on a 0-1 or 0-100 scale). Example shows string.	“0.00”
difficulty	integer	A score representing the keyword’s ranking difficulty (often on a 0-100 scale), indicating how hard it is to rank organically for it.	90
history_trend	object	An object containing historical search volume data for the keyword. Each key is a “YYYY-MM-DD” string representing the first day of a month, and the value is the search volume for that month.	{“2020-03-01”: 10, “2020-04-01”: 10, …}

Sample Request: export

Title of the code block

Copy

curl -X POST 'https://api.seranking.com/v1/keywords/export?source=us' \

  -H 'Authorization: Token YOUR_API_KEY' \

  --form 'keywords[]="seo platform"' \

  --form 'keywords[]="seranking.com"' \

  --form 'sort="cpc"' \

  --form 'sort_order="desc"' \

  --form 'cols="keyword,volume,cpc,competition,difficulty,history_trend"'

Sample Response: export

Title of the code block

Copy

[

  {

    "is_data_found": true,

    "keyword": "seo platform",

    "volume": 160,

    "cpc": 4.86,

    "difficulty": 35,

    "competition": 0.07,

    "history_trend": {

      "2024-05-01": 130,

      "2024-06-01": 90,

      "2024-07-01": 90,

      "2024-08-01": 100,

      "2024-09-01": 160,

      "2024-10-01": 160,

      "2024-11-01": 160,

      "2024-12-01": 130,

      "2025-01-01": 190,

      "2025-02-01": 240,

      "2025-03-01": 290,

      "2025-04-01": 0

    }

  },

  {

    "is_data_found": true,

    "keyword": "seranking.com",

    "volume": 320,

    "cpc": 2.0,

    "difficulty": 19,

    "competition": 0.0,

    "history_trend": {

      "2024-05-01": 30,

      "2024-06-01": 30,

      "2024-07-01": 50,

      "2024-08-01": 40,

      "2024-09-01": 70,

      "2024-10-01": 20,

      "2024-11-01": 30,

      "2024-12-01": 40,

      "2025-01-01": 260,

      "2025-02-01": 1300,

      "2025-03-01": 1600,

      "2025-04-01": 0

    }

  }

]