Felo API PlatformFelo API Platform

資料 API / DataForSEO / SERP

Setting Google Organic SERP Tasks

Queues the ranked results for a keyword on Google, returning a task id in tasks[0].id. Wrapped in DataForSEO's envelope: data in tasks[0].result, outcome in tasks[0].status_code - a rejected request still returns HTTP 200. The live twin answers immediately and is simpler for a single query; queue when the batch would outlast a tool call.

參數

沒有路徑、查詢或請求標頭參數。

請求主體

  • keywordstring必填

    Keyword to search for

  • 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

  • depthinteger選填

    Parsing depth, default 100, max 700

  • max_crawl_pagesinteger選填

    Page crawl limit, max 100

  • devicestring選填

    Device type: desktop or mobile

  • osstring選填

    Device operating system

  • group_organic_resultsboolean選填

    Display related results as grouped organic results

  • calculate_rectanglesboolean選填

    Calculate pixel rankings for SERP elements in advanced results

  • postback_urlstring選填

    Postback URL for completed task results

  • pingback_urlstring選填

    Pingback URL for task completion notification

  • postback_datastring選填

    Postback payload type

  • tagstring選填

    User-defined task identifier

請求範例

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

回應

回應欄位

  • versionstring選填

    API version

  • status_codeinteger選填

    General status code

  • status_messagestring選填

    General informational message

  • timestring選填

    Execution time

  • costnumber選填

    Total tasks cost in USD

  • tasks_countinteger選填

    Number of tasks in the request

  • tasks_errorinteger選填

    Number of tasks returned with an error

  • tasksstring選填

    Array of task objects

  • idstring選填

    Task identifier in UUID format

  • status_codeinteger選填

    Task status code

  • status_messagestring選填

    Task status message

  • costnumber選填

    Task cost

  • result_countinteger選填

    Number of result elements