Konfiguracja zadań SERP Google Events
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Konfiguracja zadań SERP Google Events
Kolejkuje wydarzenia, które Google pokazuje dla zapytania i zwraca id zadania w tasks[0].id. Opakowane w kopertę DataForSEO: dane w tasks[0].result, wynik w tasks[0].status_code — odrzucone żądanie nadal zwraca HTTP 200. Wersja na żywo odpowiada natychmiast i jest prostsza przy pojedynczym zapytaniu; kolejkuj, gdy partia trwałaby dłużej niż wywołanie narzędzia.
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[]
- keywordTyp: stringwymagane
Słowo kluczowe do wyszukania
- languageTyp: string
_code Kod języka wyszukiwarki
- languageTyp: string
_name Pełna nazwa języka wyszukiwarki
- locationTyp: integer
_code Kod lokalizacji wyszukiwarki
- locationTyp: string
_coordinate Współrzędne GPS lokalizacji
- locationTyp: string
_name Pełna nazwa lokalizacji wyszukiwarki
- pingbackTyp: string
_url Adres URL powiadomienia o ukończonym zadaniu
- postbackTyp: string
_data Typ danych postback
- postbackTyp: string
_url Adres URL do wysyłania wyników zadania
- priorityTyp: integer
Priorytet zadania
- Typ: object200
Pomyślna odpowiedź
- Typ: numbercost
Łączny koszt zadań, USD
- Typ: integerstatus
_code Ogólny kod statusu
- Typ: stringstatus
_message Ogólny komunikat informacyjny
- Typ: array string[]tasks
Tablica obiektów zadań
- Typ: integertasks
_count Liczba zadań w tablicy zadań
- Typ: integertasks
_error Liczba zadań w tablicy zadań zwróconych z błędem
- Typ: numbertasks[]
.cost Koszt zadania, USD
- Typ: stringtasks[]
.id Identyfikator zadania w formacie UUID
- Typ: integertasks[]
.result _count Liczba elementów w tablicy wyników
- Typ: integertasks[]
.status _code Kod statusu zadania
- Typ: stringtasks[]
.status _message Komunikat statusu zadania
- Typ: stringtime
Czas wykonania, sekundy
- Typ: stringversion
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/google/events/task_post \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"keyword": "",
"location_code": 1,
"location_name": "",
"location_coordinate": "",
"language_code": "",
"language_name": "",
"priority": 1,
"postback_url": "",
"pingback_url": "",
"postback_data": ""
}
]'
{
"version": "string",
"status_code": 1,
"status_message": "string",
"time": "string",
"cost": 1,
"tasks_count": 1,
"tasks_error": 1,
"tasks": [
"string"
],
"tasks[].id": "string",
"tasks[].status_code": 1,
"tasks[].status_message": "string",
"tasks[].cost": 1,
"tasks[].result_count": 1
}