データ 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