DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Live Google Ads Search Advanced
Returns the ads running against a keyword on Google, synchronously. Returns keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count and items. advanced is the default choice; take regular when only the ranked list matters and html only to check what the parser dropped. Wrapped in DataForSEO's envelope: data in tasks[0].result, outcome in tasks[0].status_code - a rejected request still returns HTTP 200.
- 型: array object[]
- advertiser型: array string[]
_ids 必須Advertiser identifiers; required if target is not specified
- location型: integer
_code Search engine location code
- location型: string
_coordinate GPS coordinates of a location
- location型: string
_name Full name of search engine location
- target型: string
Domain name associated with an advertiser account; required if advertiser_ids is not specified
- 型: object200
Successful response
- 型: numbercost
Total tasks cost, USD
- 型: integerstatus
_code General status code
- 型: stringstatus
_message General informational message
- 型: array string[]tasks
Array of tasks
- 型: array string[]tasks[]
.result Array of live SERP results
- 型: stringtime
Execution time, seconds
- 型: stringversion
The current version of the API
application/json - 400
Bad request
- 401
Unauthorized
- 402
The request cannot proceed because a billing requirement is not met.
- 403
The account is not permitted to perform this operation.
- 429
Rate limit exceeded
- 500
Internal server error
- 502
The service could not complete the request.
- 503
The API or billing service is temporarily unavailable.
- 504
The service timed out while processing the request.
- default
The operation failed. Keep the response request ID when contacting Felo support.
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/ads_search/live/advanced \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{}
]'
{
"version": "string",
"status_code": 1,
"status_message": "string",
"time": "string",
"cost": 1,
"tasks": [
"string"
],
"tasks[].result": [
"string"
]
}