データ API / DataForSEO / SERP

Live Google Local Finder SERP

Returns the expanded local results Google shows when a query is clearly local 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.

パラメータ

パス・クエリ・ヘッダーのパラメータはありません。

リクエストボディ

keywordstring必須
Keyword to search for
location_codeinteger任意
Search engine location code
location_namestring任意
Full name of search engine location
location_coordinatestring任意
GPS coordinates of a location
language_codestring任意
Search engine language code
language_namestring任意
Full name of search engine language
min_ratingnumber任意
Minimum rating filter
time_filterstring任意
Time filter

リクエスト例

curl -X POST "https://openapi.felo.ai/v1/beta/dataforseo/serp/google/local_finder/live/advanced" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "keyword": "<string>",
  "location_code": 0,
  "location_name": "<string>",
  "location_coordinate": "<string>",
  "language_code": "<string>",
  "language_name": "<string>",
  "min_rating": 0,
  "time_filter": "<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