v0.2.0-beta

OpenAPI 3.1.0

AI-зведення SERP API

Felo API Support

MIT

Сервер

https://openapi.felo.ai

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

Shell Curl

DataForSEO

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

DataForSEO Операції

post/v1/beta/dataforseo/serp/ai_summary

AI-зведення SERP API

Повертає огляд AI, який Google показує над результатами за запитом. Повертає 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.

Тіло

application/json

Тип: array (object | null)[]
- fetch_content
  Тип: boolean | null
  
  отримувати контент зі сторінок у SERP
  необов'язкове поле
  якщо задати true, API отримає контент сторінок, наявних у результатах SERP, і AI-модель врахує цей контент під час формування підсумку в результаті;
  значення за замовчуванням: false
- include_links
  Тип: boolean | null
  
  включати посилання на джерела в підсумок
  необов'язкове поле
  якщо задати true, поле summary у відповіді API міститиме посилання на джерела сформованого підсумку;
  значення за замовчуванням: false
- prompt
  Тип: string | null
  
  AI-промпт
  необов'язкове поле
  додаткове завдання для AI-сумаризатора;
  будь-який текст, питання або інформація, що повідомляє AI, яку відповідь ви шукаєте;
  максимальна кількість символів: 2000;
  примітка: промпт має відповідати ключовому слову, вказаному в POST-запиті до SERP API
- support_extra
  Тип: boolean | null
  
  підтримка додаткових функцій SERP
  необов'язкове поле
  якщо задати true, AI-модель врахує наведені додаткові функції SERP, крім результатів organic: answer_box, knowledge_graph, featured_snippet;
  значення за замовчуванням: true
- task_id
  Тип: string
  
  ідентифікатор завдання
  обов'язкове поле
  унікальний ідентифікатор пов'язаного завдання у форматі UUID
  протягом 30 днів ви зможете будь-коли запросити за ним результати завдання

Відповіді

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

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

status_code
Тип: integer | null

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

status_message
Тип: string | null

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

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

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

Тип: object | null · Response36Afe1097B20_SerpAiSummaryTaskInfo
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

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

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

масив елементів

summary
Тип: string | null

згенерований підсумок
підсумок, згенерований AI-моделлю відповідно до параметрів, указаних у запиті

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

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

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

post/v1/beta/dataforseo/serp/ai_summary

curl https://openapi.felo.ai/v1/beta/dataforseo/serp/ai_summary \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "task_id": "07031739-1535-0139-0000-9d1e639a5b7d",
    "prompt": "explain what DataForSEO is",
    "include_links": true,
    "fetch_content": true
  }
]'

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

{
  "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": [
        {
          "items_count": null,
          "items": [
            {
              "summary": null
            }
          ]
        }
      ]
    }
  ]
}

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

AI-зведення SERP API

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

DataForSEO

AI-зведення SERP API

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