v0.2.0-beta

OpenAPI 3.1.0

Отримання розширених результатів Google Dataset Search за id

Felo API Support

MIT

Сервер

https://openapi.felo.ai

Клієнтські бібліотеки

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO Операції

get/v1/beta/dataforseo/serp/google/dataset_search/task_get/advanced/{id}

Отримання розширених результатів Google Dataset Search за id

Отримує поставлений у чергу результат пошуку наборів даних Google за id. Повертає keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count і items. Обгорнуто в конверт DataForSEO: дані в tasks[0].result, результат у tasks[0].status_code — відхилений запит усе одно повертає HTTP 200.

Довідкові ціни

Тарифікація: вартість відповіді за даними постачальника.
Довідкова оцінка запиту: USD 0.02.
Довідковий множник для клієнта: 1.0. Не застосовуйте його повторно до вже розрахованої суми клієнта.

Лише довідкові метадані, а не котирування для облікового запису, гарантована ціна чи ліміт витрат. Кредити ресурсів — це не кредити Felo. Остаточні списання здійснюються за записами білінгу Felo.

Параметри шляху

id
Тип: string
обов'язкове

ідентифікатор завдання
унікальний ідентифікатор завдання в нашій системі у форматі UUID
протягом 30 днів ви зможете будь-коли запросити за ним результати завдання

Відповіді

200
Тип: object | null · Response36Afe1097B20_SerpGoogleDatasetSearchTaskGetAdvancedResponseInfo
cost
Тип: number | null Формат: double

загальна вартість завдань, USD

status_code
Тип: integer | null

загальний код стану. Повний список кодів відповіді можна знайти тут.

status_message
Тип: string | null

загальне інформаційне повідомлення. Повний список загальних інформаційних повідомлень можна знайти тут.

tasks
Тип: array (object | null)[] | null

масив завдань

Тип: object | null · Response36Afe1097B20_SerpGoogleDatasetSearchTaskGetAdvancedTaskInfo
cost
Тип: number | null Формат: double

загальна вартість завдань, USD

data
Тип: object | null

містить ті самі параметри, які ви вказали в POST-запиті

propertyName
Тип: object | null
id
Тип: string | null

ідентифікатор завдання унікальний ідентифікатор завдання в нашій системі у форматі UUID

path
Тип: array (string | null)[] | null

шлях URL

result
Тип: array (object | null)[] | null

масив результатів

check_url
Тип: string | null

прямий URL до результатів пошукової системи
за його допомогою можна переконатися, що ми надали точні результати

datetime
Тип: string | null

дата й час отримання результату
у форматі UTC: “yyyy-mm-dd hh-mm-ss +00:00”
приклад:
2019-11-15 12:57:46 +00:00

item_types
Тип: array (string | null)[] | null

типи результатів пошуку в SERP
містить типи результатів пошуку (items), знайдених у SERP.
можливий тип елемента: dataset

items
Тип: array (object | null)[] | null

елементи, що входять до елемента

area_covered
Тип: array (string | null)[] | null

список регіонів, охоплених набором даних
наприклад: Africa, Global

authors
Тип: array (object | null)[] | null

список авторів набору даних

domain
Тип: string | null

домен посилання автора

name
Тип: string | null

ім'я автора набору даних

type
Тип: string | null

тип елемента

url
Тип: string | null

URL посилання автора

dataset_description
Тип: object | null · Response36Afe1097B20_DatasetDescription

опис набору даних

links
Тип: array (object | null)[] | null

посилання, наведені в 'dataset_description'

description
Тип: string | null

опис елемента результатів

domain
Тип: string | null

домен, на який веде посилання

snippet
Тип: string | null

текст поруч із заголовком посилання

title
Тип: string | null

заголовок вказаного елемента-посилання

type
Тип: string | null

тип елемента

url
Тип: string | null

URL

xpath
Тип: string | null

XPath елемента

text
Тип: string | null

текст опису

dataset_id
Тип: string | null

ID набору даних

dataset_providers
Тип: array (object | null)[] | null

список установ, що надали набір даних

domain
Тип: string | null

домен у SERP

title
Тип: string | null

заголовок елемента

type
Тип: string | null

тип елемента

url
Тип: string | null

URL пошуку з параметрами уточнення

formats
Тип: array (object | null)[] | null

список форматів файлів набору даних

format
Тип: string | null

тип формату файлу набору даних
наприклад: zip, html, csv

size
Тип: integer | null Формат: int64

розмір файлу в байтах

type
Тип: string | null

тип елемента

image_url
Тип: string | null

URL зображення
URL, що веде до зображення на вихідному ресурсі або в сховищі DataForSEO (якщо вихідне джерело недоступне)

licenses
Тип: array (object | null)[] | null

список ліцензій, виданих на набір даних

domain
Тип: string | null

домен у SERP

title
Тип: string | null

заголовок елемента

type
Тип: string | null

тип елемента

url
Тип: string | null

URL пошуку з параметрами уточнення

links
Тип: array (object | null)[] | null

сайтлінки
посилання, що показуються під деякими результатами пошуку Google Dataset
якщо їх немає, дорівнює null

description
Тип: string | null

опис елемента результатів

domain
Тип: string | null

домен, на який веде посилання

snippet
Тип: string | null

текст поруч із заголовком посилання

title
Тип: string | null

заголовок вказаного елемента-посилання

type
Тип: string | null

тип елемента

url
Тип: string | null

URL

xpath
Тип: string | null

XPath елемента

period_covered
Тип: object | null · Response36Afe1097B20_PeriodCovered

період, охоплений набором даних

displayed_date
Тип: string | null

період, що відображається в SERP
приклад:
Mar 2, 2020 - Dec 9, 2022

end_date
Тип: string | null

дата й час закінчення періоду
у форматі UTC: “yyyy-mm-dd hh-mm-ss +00:00”
приклад:
2022-12-09 02:00:00 +00:00

start_date
Тип: string | null

дата й час початку періоду
у форматі UTC: “yyyy-mm-dd hh-mm-ss +00:00”
приклад:
2020-03-02 02:00:00 +00:00

position
Тип: string | null

вирівнювання елемента в SERP
може набувати таких значень:
left, right

rank_absolute
Тип: integer | null

абсолютний ранг у SERP
абсолютна позиція серед усіх елементів у SERP

rank_group
Тип: integer | null

груповий ранг у SERP
позиція всередині групи елементів з однаковими значеннями type
позиції елементів з іншими значеннями type не враховуються в rank_group

related_article
Тип: string | null

посилання на пов'язану статтю
посилання на опубліковану статтю, пов'язану з набором даних

scholarly_articles_url
Тип: string | null

URL наукових статей
посилання на список наукових статей у Google Scholar
приклад: https://scholar.google.com/scholar?q=%2210.6084%20m9%20figshare%207427933%20v1%22

scholarly_citations_count
Тип: integer | null Формат: int64

кількість статей, що посилаються на набір даних

title
Тип: string | null

заголовок елемента

type
Тип: string | null

тип елемента

unique_identifier
Тип: string | null

цифровий ідентифікатор об'єкта
унікальний цифровий ідентифікатор набору даних
приклад: https://doi.org/10.5061/dryad.hmgqnk9m3

updated_date
Тип: string | null

дата й час останнього оновлення результату
у форматі UTC: “yyyy-mm-dd hh-mm-ss +00:00”
приклад:
2022-11-27 02:00:00 +00:00

xpath
Тип: string | null

XPath елемента

items_count
Тип: integer | null Формат: int64

кількість результатів, повернутих у масиві items

keyword
Тип: string | null

ключове слово, отримане в масиві POST
ключове слово повертається з декодованими %## (символ '+' буде декодовано в пробіл)

language_code
Тип: string | null

код мови в масиві POST

se_domain
Тип: string | null

домен пошукової системи в масиві POST

se_results_count
Тип: integer | null Формат: int64

загальна кількість результатів у SERP

spell
Тип: object | null · Response36Afe1097B20_SpellInfo

автокорекція пошукової системи
якщо пошукова система надала результати за виправленим ключовим словом, ми вкажемо виправлене пошуковою системою ключове слово та тип автокорекції

keyword
Тип: string | null

ключове слово, отримане в результаті автокорекції пошукової системи результати буде надано для виправленого ключового слова

type
Тип: string | null

тип автокорекції можливі значення: did_you_mean, showing_results_for, no_results_found_for, including_results_for примітка: Yahoo і Yandex підтримують лише такий тип автокорекції: including_results_for

result_count
Тип: integer | null Формат: int64

кількість елементів у масиві result

status_code
Тип: integer | null

код стану завдання формується DataForSEO, може перебувати в діапазоні 10000-60000 Повний список кодів відповіді можна знайти тут.

status_message
Тип: string | null

інформаційне повідомлення завдання Повний список загальних інформаційних повідомлень можна знайти тут.

time
Тип: string | null

час виконання, секунди

tasks_count
Тип: integer | null Формат: int64

кількість завдань у масиві tasks

tasks_error
Тип: integer | null Формат: int64

кількість завдань у масиві tasks, повернутих з помилкою

time
Тип: string | null

загальний час виконання, секунди

version
Тип: string | null

поточна версія API
application/json
400

Не вдалося обробити запит. Перевірте параметри запиту.
401

Потрібен дійсний API-ключ Felo.
402

Запит неможливо виконати: умови білінгу не виконано.
403

Обліковий запис не має дозволу на цю операцію.
429

Досягнуто ліміту запитів або витрат.
502

Служба не змогла виконати запит.
503

API або служба білінгу тимчасово недоступні.
504

Час очікування обробки запиту вичерпано.
default

Відповідь із помилкою; наскрізні відповіді апстріму можуть використовувати формати постачальника

application/json

get/v1/beta/dataforseo/serp/google/dataset_search/task_get/advanced/{id}

curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/dataset_search/task_get/advanced/00000000-0000-0000-0000-000000000000 \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

Показати схему

{
  "version": null,
  "status_code": null,
  "status_message": null,
  "time": null,
  "cost": null,
  "tasks_count": null,
  "tasks_error": null,
  "tasks": [
    {
      "id": null,
      "status_code": null,
      "status_message": null,
      "time": null,
      "cost": null,
      "result_count": null,
      "path": [
        null
      ],
      "data": null,
      "result": [
        {
          "keyword": null,
          "se_domain": null,
          "language_code": null,
          "check_url": null,
          "datetime": null,
          "spell": {
            "keyword": null,
            "type": null
          },
          "item_types": [
            null
          ],
          "se_results_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "rank_group": null,
              "rank_absolute": null,
              "position": null,
              "xpath": null,
              "dataset_id": null,
              "title": null,
              "image_url": null,
              "scholarly_citations_count": null,
              "scholarly_articles_url": null,
              "unique_identifier": null,
              "related_article": null,
              "links": [
                "[Max Depth Exceeded]"
              ],
              "dataset_providers": [
                "[Max Depth Exceeded]"
              ],
              "formats": [
                "[Max Depth Exceeded]"
              ],
              "authors": [
                "[Max Depth Exceeded]"
              ],
              "licenses": [
                "[Max Depth Exceeded]"
              ],
              "updated_date": null,
              "area_covered": [
                "[Max Depth Exceeded]"
              ],
              "period_covered": "[Max Depth Exceeded]",
              "dataset_description": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Успішна операція

Отримання розширених результатів Google Dataset Search за id

АвтентифікаціяRequired

DataForSEO

Отримання розширених результатів Google Dataset Search за id

Довідкові ціни