v0.2.0-beta

OpenAPI 3.1.0

Konfiguracja zadań Google Autocomplete

Felo API Support

MIT

Serwer

https://openapi.felo.ai

Biblioteki klienckie

Shell Curl

DataForSEO

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

DataForSEO Operacje

post/v1/beta/dataforseo/serp/google/autocomplete/task_post

Konfiguracja zadań Google Autocomplete

Kolejkuje podpowiedzi, które Google wyświetla w trakcie wpisywania 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.

Treść

application/json

Typ: array (object | null)[]
- client
  Typ: string | null
  
  klient wyszukiwania dla autouzupełniania
  
  pole opcjonalne
  
  wyniki autouzupełniania mogą się różnić w zależności od klienta wyszukiwania;
  
  możliwe wartości:
  
  chrome — używany, gdy wyszukiwanie Google jest otwarte w przeglądarce Google Chrome;
  
  chrome-omni — używany na pasku adresu w Chrome;
  
  gws-wiz — używany na stronie głównej wyszukiwarki Google;
  
  gws-wiz-serp — używany na stronie wyników wyszukiwania Google;
  
  safari — używany, gdy wyszukiwanie Google jest otwarte w przeglądarce Safari;
  
  firefox — używany, gdy wyszukiwanie Google jest otwarte w przeglądarce Firefox;
  
  psy-ab — może być używany, gdy wyszukiwanie Google jest otwarte w przeglądarce Google Chrome;
  
  toolbar — zwraca XML;
  
  youtube — zwraca JSONP;
  
  gws-wiz-local — używany w wyszukiwaniu lokalnym Google;
  
  img — używany w wyszukiwaniu obrazów Google;
  
  products-cc — używany w wyszukiwaniu Google Shopping
- cursor_pointer
  Typ: integer | null
  
  wskaźnik kursora paska wyszukiwania
  
  pole opcjonalne
  
  pozioma pozycja liczbowa kursora w obrębie słowa kluczowego na pasku wyszukiwania;
  
  zmieniając pozycję kursora, otrzymasz inne podpowiedzi autouzupełniania dla tego samego słowa kluczowego bazowego;
  
  wartość minimalna: 0
  
  wartość domyślna: numer ostatniego znaku podanego keyword
  
  przykład:
  
  |which query are s - "cursor_pointer": 0
  
  which query is s| - "cursor_pointer": 16
  
  which que|ry is s - "cursor_pointer": 9
- keyword
  Typ: string
  
  słowo kluczowe
  
  pole wymagane
  
  w polu keyword można podać do 700 znaków
  
  wszystkie sekwencje %## zostaną zdekodowane (znak „+” zostanie zdekodowany jako spacja)
  
  jeśli w polu keyword potrzebujesz użyć znaku „%”, podaj go jako „%25”;
  
  jeśli potrzebujesz użyć znaku „+” w polu keyword, podaj go jako „%2B”;
  
  więcej o zasadach i ograniczeniach pól keyword i keywords w interfejsach API DataForSEO znajdziesz w tym artykule Centrum pomocy
- language_code
  Typ: string
  
  kod języka wyszukiwarki
  
  pole wymagane, jeśli nie podasz language_name
  
  jeśli używasz tego pola, nie musisz podawać language_name
  
  listę dostępnych języków wyszukiwarki wraz z ich language_code można uzyskać, wysyłając osobne żądanie do https://api.dataforseo.com/v3/serp/google/languages
  
  przykład:
  
  en
- language_name
  Typ: string
  
  pełna nazwa języka wyszukiwarki
  
  pole wymagane, jeśli nie podasz language_code
  
  jeśli używasz tego pola, nie musisz podawać language_code;
  
  listę dostępnych języków wyszukiwarki wraz z ich language_name można uzyskać, wysyłając osobne żądanie do https://api.dataforseo.com/v3/serp/google/languages
  
  przykład:
  
  English
- location_code
  Typ: integer
  
  kod lokalizacji wyszukiwarki
  
  pole wymagane, jeśli nie podasz location_name;
  
  listę dostępnych lokalizacji wyszukiwarek wraz z ich location_code można uzyskać, wysyłając osobne żądanie do https://api.dataforseo.com/v3/serp/google/locations
  
  przykład:
  
  2840
- location_name
  Typ: string
  
  pełna nazwa lokalizacji wyszukiwarki
  
  pole wymagane, jeśli nie podasz location_code
  
  jeśli używasz tego pola, nie musisz podawać location_code;
  
  listę dostępnych lokalizacji wyszukiwarki wraz z ich location_name można uzyskać, wysyłając osobne żądanie do https://api.dataforseo.com/v3/serp/google/autocomplete/locations
  
  przykład:
  
  London,England,United Kingdom
- pingback_url
  Typ: string | null
  
  adres URL powiadomienia o zakończonym zadaniu
  
  pole opcjonalne
  
  po zakończeniu zadania powiadomimy Cię żądaniem GET wysłanym na podany adres URL
  
  możesz użyć ciągu ‘$id’ jako zmiennej $id, a ‘$tag’ jako zmiennej $tag zakodowanej w adresie URL. Przed wysłaniem żądania ustawimy wymagane wartości.
  
  przykład:
  
  http://your-server.com/pingscript?id=$id
  
  http://your-server.com/pingscript?id=$id&tag=$tag
  
  Uwaga: znaki specjalne w pingback_url zostaną zakodowane w adresie URL;
  
  m.in. znak # zostanie zakodowany jako %23
  
  więcej informacji w naszym Centrum pomocy
- postback_data
  Typ: string
  
  typ danych postback_url
  
  pole wymagane, jeśli podasz postback_url
  
  odpowiada typowi danych, który zostanie wysłany na Twój serwer
  
  możliwe wartości:
  
  advanced
- postback_url
  Typ: string | null
  
  adres URL do wysyłania wyników zadania
  
  pole opcjonalne
  
  po zakończeniu zadania wyślemy żądanie POST z wynikami skompresowanymi w formacie gzip na podany postback_url
  
  możesz użyć ciągu ‘$id’ jako zmiennej $id, a ‘$tag’ jako zmiennej $tag zakodowanej w adresie URL. Przed wysłaniem żądania ustawimy wymagane wartości.
  
  przykład:
  
  http://your-server.com/postbackscript?id=$id
  
  http://your-server.com/postbackscript?id=$id&tag=$tag
  
  Uwaga: znaki specjalne w postback_url zostaną zakodowane w adresie URL;
  
  m.in. znak # zostanie zakodowany jako %23
  
  więcej informacji znajdziesz w Centrum pomocy
- priority
  Typ: integer | null
  
  priorytet zadania
  
  pole opcjonalne
  
  może przyjmować następujące wartości:
  
  1 – normalny priorytet wykonania (ustawiany domyślnie)
  
  2 – wysoki priorytet wykonania
  
  Za zadania o wysokim priorytecie wykonania zostanie naliczona dodatkowa opłata.
  Koszt można obliczyć na stronie Cennik.
- tag
  Typ: string | null
  
  identyfikator zadania zdefiniowany przez użytkownika
  
  pole opcjonalne
  
  limit znaków to 255
  
  możesz użyć tego parametru, aby zidentyfikować zadanie i dopasować je do wyniku
  
  podaną wartość tag znajdziesz w obiekcie data odpowiedzi

Odpowiedzi

200
Typ: object | null · Response36Afe1097B20_SerpGoogleAutocompleteTaskPostResponseInfo
cost
Typ: number | null Format: double

łączny koszt zadań, USD

status_code
Typ: integer | null

ogólny kod statusu pełną listę kodów odpowiedzi znajdziesz tutaj

status_message
Typ: string | null

ogólny komunikat informacyjny pełną listę ogólnych komunikatów informacyjnych znajdziesz tutaj

tasks
Typ: array (object | null)[] | null

tablica zadań

Typ: object | null · Response36Afe1097B20_SerpGoogleAutocompleteTaskPostTaskInfo
cost
Typ: number | null Format: double

łączny koszt zadań, USD

data
Typ: object | null

zawiera te same parametry, które podano w żądaniu POST

propertyName
Typ: object | null
id
Typ: string | null

identyfikator zadania unikalny identyfikator zadania w naszym systemie w formacie UUID

path
Typ: array (string | null)[] | null

ścieżka URL

result
Typ: object | null

tablica wyników
w tym przypadku wartością będzie null

result_count
Typ: integer | null Format: int64

liczba elementów w tablicy result

status_code
Typ: integer | null

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

status_message
Typ: string | null

komunikat informacyjny zadania pełną listę ogólnych komunikatów informacyjnych znajdziesz tutaj

time
Typ: string | null

czas wykonania, sekundy

tasks_count
Typ: integer | null Format: int64

liczba zadań w tablicy tasks

tasks_error
Typ: integer | null Format: int64

liczba zadań w tablicy tasks zwróconych z błędem

time
Typ: string | null

łączny czas wykonania, sekundy

version
Typ: string | null

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

post/v1/beta/dataforseo/serp/google/autocomplete/task_post

curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/autocomplete/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "keyword": "albert einstein",
    "cursor_pointer": 6
  }
]'

Pokaż schemat

{
  "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": null
    }
  ]
}

Operacja zakończona powodzeniem

Konfiguracja zadań Google Autocomplete

UwierzytelnianieRequired

DataForSEO

Konfiguracja zadań Google Autocomplete

Cennik referencyjny