データ API / DataForSEO / SERP
Setting Google Dataset Search Tasks
Queues datasets matching a query in Google Dataset Search 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 datasets for
language_namestring任意Full name of search engine language
language_codestring任意Search engine language code
osstring任意Device operating system, such as windows or macos
last_updatedstring任意Last time the dataset was updated, such as 1m, 1y, or 3y
file_formatsstring[]任意Dataset file formats, such as other, archive, text, image, document, or tabular
usage_rightsstring任意Usage rights, such as commercial or noncommercial
priorityinteger任意Task priority
postback_urlstring任意URL for sending task results
pingback_urlstring任意Notification URL of a completed task
postback_datastring任意Postback datatype; possible value: advanced
リクエスト例
curl -X POST "https://openapi.felo.ai/v1/beta/dataforseo/serp/google/dataset_search/task_post" \
-H "Authorization: Bearer $FELO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"keyword": "<string>",
"language_name": "<string>",
"language_code": "<string>",
"os": "<string>",
"last_updated": "<string>",
"file_formats": [
"<string>"
],
"usage_rights": "<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