DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Podsumowanie AI w SERP API
Zwraca przegląd AI, który Google wyświetla nad wynikami dla zapytania w Google. Zwraca keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count i items. Opakowane w kopertę DataForSEO: dane w tasks[0].result, wynik w tasks[0].status_code — odrzucone żądanie nadal zwraca HTTP 200.
Cennik referencyjny
- Rozliczanie: zgłoszony koszt odpowiedzi.
- Szacunek referencyjny dla żądania: USD 0.02.
- Referencyjny mnożnik klienta: 1.0. Nie stosuj go ponownie do rozliczonej kwoty klienta.
Wyłącznie metadane referencyjne, a nie wycena konta, gwarantowana cena lub limit wydatków. Kredyty zasobów nie są kredytami Felo. Ostateczne obciążenia są zgodne z zapisami rozliczeniowymi Felo.
- Typ: array (object | null)[]
- fetchTyp: boolean | null
_content pobieraj treść ze stron w SERP
pole opcjonalne
jeśli ustawisztrue, API pobierze treść ze stron występujących w wynikach SERP, a model AI uwzględni tę treść podczas generowania podsumowania w wyniku;
wartość domyślna:false - includeTyp: boolean | null
_links dołącz linki do źródeł w podsumowaniu
pole opcjonalne
jeśli ustawisztrue, polesummaryw odpowiedzi API będzie zawierać linki do źródeł wygenerowanego podsumowania;
wartość domyślna:false - promptTyp: string | null
prompt AI
pole opcjonalne
dodatkowe zadanie dla podsumowującego AI;
dowolna forma tekstu, pytania lub informacji, która przekazuje AI, jakiej odpowiedzi oczekujesz;
maksymalna liczba symboli lub znaków, którą możesz podać:2000;
uwaga: prompt musi być powiązany ze słowem kluczowym podanym w żądaniu POST do SERP API - supportTyp: boolean | null
_extra obsługuj dodatkowe funkcje SERP
pole opcjonalne
jeśli ustawisztrue, model AI uwzględni następujące dodatkowe funkcje SERP poza wynikamiorganic:answer_box,knowledge_graph,featured_snippet;
wartość domyślna:true - taskTyp: string
_id
- Typ: object | null · Response36Afe1097B20_SerpAiSummaryResponseInfo200
- Typ: number | null Format: doublecost
łączny koszt zadań, USD
- Typ: integer | nullstatus
_code ogólny kod statusu pełną listę kodów odpowiedzi znajdziesz tutaj
- Typ: string | nullstatus
_message ogólny komunikat informacyjny pełną listę ogólnych komunikatów informacyjnych znajdziesz tutaj
- Typ: array (object | null)[] | nulltasks
tablica zadań
- Typ: object | null · Response36Afe1097B20_SerpAiSummaryTaskInfo
- costTyp: number | null Format: double
łączny koszt zadań, USD
- dataTyp: object | null
zawiera te same parametry, które podano w żądaniu POST
- propertyTyp: object | null
Name
- idTyp: string | null
identyfikator zadania unikalny identyfikator zadania w naszym systemie w formacie UUID
- pathTyp: array (string | null)[] | null
ścieżka URL
- resultTyp: array (object | null)[] | null
tablica wyników
- itemsTyp: array (object | null)[] | null
tablica pozycji
- summaryTyp: string | null
wygenerowane podsumowanie
podsumowanie wygenerowane przez model AI zgodnie z parametrami podanymi w żądaniu
- itemsTyp: integer | null Format: int64
_count liczba pozycji w tablicy wyników
- resultTyp: integer | null Format: int64
_count liczba elementów w tablicy result
- statusTyp: integer | null
_code kod statusu zadania wygenerowany przez DataForSEO; może mieścić się w następującym zakresie: 10000-60000 pełną listę kodów odpowiedzi znajdziesz tutaj
- statusTyp: string | null
_message komunikat informacyjny zadania pełną listę ogólnych komunikatów informacyjnych znajdziesz tutaj
- timeTyp: string | null
czas wykonania, sekundy
- Typ: integer | null Format: int64tasks
_count liczba zadań w tablicy tasks
- Typ: integer | null Format: int64tasks
_error liczba zadań w tablicy tasks zwróconych z błędem
- Typ: string | nulltime
łączny czas wykonania, sekundy
- Typ: string | nullversion
bieżąca wersja interfejsu API
application/json - 400
Nie można przetworzyć żądania. Sprawdź parametry żądania.
- 401
Wymagany jest prawidłowy klucz API Felo.
- 402
Nie można kontynuować żądania, ponieważ nie spełniono wymogu rozliczeniowego.
- 403
Konto nie ma uprawnień do wykonania tej operacji.
- 429
Osiągnięto limit żądań lub wydatków.
- 502
Usługa nie mogła ukończyć żądania.
- 503
API lub usługa rozliczeniowa jest tymczasowo niedostępna.
- 504
Upłynął limit czasu usługi podczas przetwarzania żądania.
- default
Odpowiedź błędu; odpowiedzi przekazywane bezpośrednio od dostawcy upstream mogą używać formatów dostawcy
application/json
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
}
]
}
]
}
]
}