Google Historical Serps Live
GoogleHistoricalSerpsLive
- Price
- 0.000120 USDT / request
- Status
- Available
- Official reference
- 0.000120 USDT / request
- Protocols
- REST · MCP
Run a test
Runs are submitted only when you click Run. Check the input and cost limit first.
Starting price shown. Get a quote for your current inputs; settlement uses actual consumption and refunds the difference.
Tests use your account balance and the selected key’s budget. The cost limit caps this API call; it does not include future calls or recurring upstream jobs.
Run a test to see its status, charges and response here.
API reference
A successful asynchronous create call returns a receipt. Use the provider’s status/result operation with that receipt ID to check whether the upstream job has completed.
curl https://gw.asale.ai/v1/tool-runs \
-H 'Authorization: Bearer <ASALE_API_KEY>' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: <UNIQUE_REQUEST_ID>' \
-d '{
"tool": "google.historical.serps.live",
"input": {
"body": [
{
"keyword": "IANA example domains"
}
]
},
"max_cost_micros": 120
}'curl https://gw.asale.ai/v1/tool-runs/<RUN_ID> -H 'Authorization: Bearer <ASALE_API_KEY>'| Parameter | Required | Type |
|---|---|---|
| body | No | array |
Full input schema
{
"$defs": {
"DataforseoLabsGoogleHistoricalSerpsLiveRequestInfo": {
"properties": {
"date_from": {
"anyOf": [
{
"description": "starting date of the time rangeoptional fieldif you don't specify this field, the API will return all SERPs collected for 365 days starting from the current datetime value;minimal possible value: 365 days from the current datetime value;date format: \"yyyy-mm-dd\"",
"type": "string"
},
{
"type": "null"
}
]
},
"date_to": {
"anyOf": [
{
"description": "ending date of the time rangeoptional fieldif you don't specify this field, the today's date will be used by default;date format: \"yyyy-mm-dd\";example:\"2021-09-01\"",
"type": "string"
},
{
"type": "null"
}
]
},
"keyword": {
"description": "keywordrequired fieldyou can specify up to 700 characters in the keyword field;all %## will be decoded (plus character ‘+’ will be decoded to a space character);if you need to use the “%” character for your keyword, please specify it as “%25”;if you need to use the “+” character for your keyword, please specify it as “%2B”",
"type": "string"
},
"language_code": {
"anyOf": [
{
"description": "unique language identifierrequired field if you don't specify language_nameNote: it is required to specify either language_name or language_codeyou can receive the list of available languages with their language_code parameters by making a separate request to the",
"type": "string"
},
{
"type": "null"
}
]
},
"language_name": {
"description": "full name of the languagerequired field if you don't specify language_codeNote: it is required to specify either language_name or language_codeyou can receive the list of available languages with their language_name parameters by making a separate request to the",
"type": "string"
},
"location_code": {
"description": "unique location identifierrequired field if you don't specify location_nameNote: it is required to specify either location_name or location_codeyou can receive the list of available locations with their location_code by making a separate request to",
"type": "integer"
},
"location_name": {
"description": "full name of the locationrequired field if you don't specify location_codeNote: it is required to specify either location_name or location_codeyou can receive the list of available locations with their location_name by making a separate request to Kingdom",
"type": "string"
},
"tag": {
"anyOf": [
{
"description": "user-defined task identifieroptional fieldthe character limit is 255you can use this parameter to identify the task and match it with the resultyou will find the specified tag value in the data object of the response",
"type": "string"
},
{
"type": "null"
}
]
}
},
"type": "object"
}
},
"additionalProperties": false,
"properties": {
"body": {
"items": {
"anyOf": [
{
"oneOf": [
{
"$ref": "#/$defs/DataforseoLabsGoogleHistoricalSerpsLiveRequestInfo"
}
],
"type": "object"
},
{
"type": "null"
}
]
},
"type": "array"
}
},
"required": [],
"type": "object"
}Price
0.000120 USDT / request
Starting price shown. Get a quote for your current inputs; settlement uses actual consumption and refunds the difference.
Tests use your account balance and the selected key’s budget. The cost limit caps this API call; it does not include future calls or recurring upstream jobs.
Price revision 5
Search
Asale matches available channels by price. The reference is the highest verified channel reference price. Only definite rejections may transfer to another channel; uncertain executions require reconciliation to avoid duplicate charges.
Supply channels: 1