Data API / DataForSEO / SERP

Setting Google Finance Quote SERP Tasks

Queues a ticker's quote as Google Finance shows it 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Обязательный
Ticker or stock symbol
location_namestringНеобязательный
Full name of search engine location
location_codeintegerНеобязательный
Search engine location code
language_namestringНеобязательный
Full name of search engine language
language_codestringНеобязательный
Search engine language code
osstringНеобязательный
Device operating system
windowstringНеобязательный
Time window for the quote graph, such as 1D, 5D, 1M, 6M, YTD, 1Y, 5Y, or MAX
priorityintegerНеобязательный
Task priority
postback_urlstringНеобязательный
URL for sending task results
pingback_urlstringНеобязательный
Notification URL of a completed task
postback_datastringНеобязательный
Postback datatype; possible values: advanced, html

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

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

Ответ

Поля ответа

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
tasks_countintegerНеобязательный
The number of tasks in the tasks array
tasks_errorintegerНеобязательный
The number of tasks in the tasks array 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Необязательный
Cost of the task, USD
result_countintegerНеобязательный
Number of elements in the result array