Felo API PlatformFelo API Platform

Data 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