Data API / DataForSEO / SERP

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.

Параметры

Параметров пути, запроса и заголовков нет.

Тело запроса

advertiser_idsstring[]Необязательный
Advertiser identifiers; required if target is not specified
targetstringНеобязательный
Domain name associated with an advertiser account; required if advertiser_ids is not specified
location_namestringНеобязательный
Full name of search engine location
location_codeintegerНеобязательный
Search engine location code
location_coordinatestringНеобязательный
GPS coordinates of a location

Пример запроса

curl -X POST "https://openapi.felo.ai/v1/beta/dataforseo/serp/google/ads_search/live/advanced" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "advertiser_ids": [
    "<string>"
  ],
  "target": "<string>",
  "location_name": "<string>",
  "location_code": 0,
  "location_coordinate": "<string>"
}'

Ответ

Поля ответа

versionstringНеобязательный
The current version of the API
status_codeintegerНеобязательный
General status code
status_messagestringНеобязательный
General informational message
timestringНеобязательный
Execution time, seconds
costnumberНеобязательный
Total tasks cost, USD
tasksstring[]Необязательный
Array of tasks
resultstring[]Необязательный
Array of live SERP results