Refresh a keyword list's metrics
https://seolyticize.com /api/v1/tools/refresh_keyword_list_metrics Re-reads volume, keyword difficulty, CPC, competition, intent and SERP features for every Google keyword on a list from DataForSEO Labs, in bulk (one read per market per 700 keywords), and stores them on the list. Answers 'update the numbers on that list'. onlyOlderThanDays skips keywords refreshed more recently, so a big list is not bought twice in a week. Keywords for other engines, or markets the research index does not cover, are skipped with the reason; terms the index has nothing for are listed in noData and their old figures cleared. clientId is the account billed: a client's list is refreshed under its own client, an agency list under any client the caller names. A paid lookup unless anyone read the same thing recently; quote it with estimate_cost.
Parameters
Idempotency-KeystringheaderRequest body
application/json
clientIdstringrequiredlistIdstringrequiredonlyOlderThanDaysintegermaxCostMicrosintegerdryRunboolean{
"clientId": "string",
"listId": "string",
"onlyOlderThanDays": null,
"maxCostMicros": 0,
"dryRun": true
}Code samples
cURL
curl -X POST "https://seolyticize.com/api/v1/tools/refresh_keyword_list_metrics" \
-H "Authorization: Bearer $SEOLYTICIZE_API_KEY" \
-H "Idempotency-Key: <value>" \
-H "Content-Type: application/json" \
-d '{"clientId":"string","listId":"string","onlyOlderThanDays":null,"maxCostMicros":0,"dryRun":true}'TypeScript
Python
Go
PHP
Ruby
Java
Responses
data, and its meta.Example
{
"data": {},
"meta": {
"requestId": "string",
"costMicros": 0,
"cached": true,
"cachedFrom": "string",
"dataAsOf": "string",
"sources": [
"string"
],
"partial": true,
"next": [
{
"tool": "string",
"args": {},
"why": "string"
}
],
"nextCursor": "string",
"dryRun": true
}
}Schema
datarequiredmetaobjectrequiredShow child parameters
requestIdstringrequiredcostMicrosintegerrequiredcachedbooleanrequiredcachedFromstringdataAsOfstringsourcesstring[]partialbooleanrequirednextobject[]requiredShow child parameters
toolstringargsobjectwhystringnextCursorstringdryRunbooleanX-RateLimit-LimitintegerX-RateLimit-RemainingintegerX-RateLimit-ResetintegerX-Request-IdstringExample
{
"error": "string",
"code": "string",
"next": "string",
"requestId": "string"
}Schema
errorstringrequiredcodestringnextstringrequestIdstringX-RateLimit-LimitintegerX-RateLimit-RemainingintegerX-RateLimit-ResetintegerSame as 400 · POST /api/v1/tools/refresh_keyword_list_metrics
WWW-AuthenticatestringSame as 400 · POST /api/v1/tools/refresh_keyword_list_metrics
X-RateLimit-LimitintegerX-RateLimit-RemainingintegerX-RateLimit-ResetintegerSame as 400 · POST /api/v1/tools/refresh_keyword_list_metrics
X-RateLimit-LimitintegerX-RateLimit-RemainingintegerX-RateLimit-ResetintegerSame as 400 · POST /api/v1/tools/refresh_keyword_list_metrics
X-RateLimit-LimitintegerX-RateLimit-RemainingintegerX-RateLimit-ResetintegerSame as 400 · POST /api/v1/tools/refresh_keyword_list_metrics
X-RateLimit-LimitintegerX-RateLimit-RemainingintegerX-RateLimit-ResetintegerSame as 400 · POST /api/v1/tools/refresh_keyword_list_metrics
X-RateLimit-LimitintegerX-RateLimit-RemainingintegerX-RateLimit-ResetintegerRetry-AfterintegerSame as 400 · POST /api/v1/tools/refresh_keyword_list_metrics
X-RateLimit-LimitintegerX-RateLimit-RemainingintegerX-RateLimit-Resetinteger