Felo API PlatformFelo API Platform

Data API / DataForSEO / SERP

Live Google Organic SERP HTML

Returns the ranked results for a keyword on Google, synchronously. Raw page source rather than parsed results. Wrapped in DataForSEO's envelope: data in tasks[0].result, outcome in tasks[0].status_code - a rejected request still returns HTTP 200.

Параметры

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

Тело запроса

  • urlstringНеобязательный

    Direct URL of the search query

  • location_namestringНеобязательный

    Full name of search engine location

  • location_codeintegerНеобязательный

    Search engine location code

  • location_coordinatestringНеобязательный

    GPS coordinates of a location

  • language_namestringНеобязательный

    Full name of search engine language

  • language_codestringНеобязательный

    Search engine language code

  • devicestringНеобязательный

    Device type: desktop or mobile

  • osstringНеобязательный

    Device operating system

  • se_domainstringНеобязательный

    Custom search engine domain

  • depthintegerНеобязательный

    Parsing depth, default 100, max 700

  • max_crawl_pagesintegerНеобязательный

    Page crawl limit, max 100

  • search_paramstringНеобязательный

    Additional parameters of the search query

  • load_async_ai_overviewbooleanНеобязательный

    Load asynchronous AI overview

  • expand_ai_overviewbooleanНеобязательный

    Expand AI overview item

  • tagstringНеобязательный

    User-defined task identifier

  • keywordstringНеобязательный

    Keyword to search for.

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

curl -X POST "https://openapi.felo.ai/v1/beta/dataforseo/serp/google/organic/live/html" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "url": "<string>",
  "location_name": "<string>",
  "location_code": 0,
  "location_coordinate": "<string>",
  "language_name": "<string>",
  "language_code": "<string>",
  "device": "<string>",
  "os": "<string>"
}'

Ответ

Поля ответа

  • versionstringНеобязательный

    API version

  • status_codeintegerНеобязательный

    General status code

  • status_messagestringНеобязательный

    General informational message

  • timestringНеобязательный

    Execution time

  • costnumberНеобязательный

    Request cost in USD

  • tasks_countintegerНеобязательный

    Number of tasks returned

  • tasks_errorintegerНеобязательный

    Number of tasks returned with an error

  • tasksstringНеобязательный

    Array of live task objects

  • idstringНеобязательный

    Task identifier

  • resultstringНеобязательный

    Result array containing HTML pages

  • itemsstringНеобязательный

    HTML page items

  • htmlstringНеобязательный

    Raw HTML page content