v0.2.0-beta

OpenAPI 3.1.0

Tworzenie zadań SERP Google AI Mode

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/ai_mode/task_post

Tworzenie zadań SERP Google AI Mode

Kolejkuje odpowiedź Google AI Mode dla zapytania wraz ze źródłami, które cytuje w Google, 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 dla pojedynczego zapytania; kolejkuj, gdy partia przekroczyłaby czas wywołania 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)[]
- browser_screen_height
  Typ: integer | null
  
  wysokość ekranu przeglądarki
  
  pole opcjonalne
  
  możesz ustawić niestandardową wysokość ekranu przeglądarki, aby obliczyć pozycje pikselowe dla konkretnego urządzenia;
  
  można ją podać w następującym zakresie: 240-9999;
  
  domyślnie parametr ma wartość:
  
  1080 dla desktop;
  
  640 dla mobile na android;
  
  812 dla mobile na iOS;
  
  Uwaga: aby użyć tego parametru, ustaw calculate_rectangles na true
- browser_screen_resolution_ratio
  Typ: integer | null
  
  współczynnik rozdzielczości ekranu przeglądarki
  
  pole opcjonalne
  
  możesz ustawić niestandardowy współczynnik rozdzielczości ekranu przeglądarki, aby obliczyć pozycje pikselowe dla konkretnego urządzenia;
  
  można go podać w następującym zakresie: 0.5-3;
  
  domyślnie parametr ma wartość:
  
  1 dla desktop;
  
  3 dla mobile na android;
  
  3 dla mobile na iOS;
  
  Uwaga: aby użyć tego parametru, ustaw calculate_rectangles na true
- browser_screen_width
  Typ: integer | null Format: int64
  
  szerokość ekranu przeglądarki
  
  pole opcjonalne
  
  możesz ustawić niestandardową szerokość ekranu przeglądarki, aby obliczyć pozycje pikselowe dla konkretnego urządzenia;
  
  można ją podać w następującym zakresie: 240-9999;
  
  domyślnie parametr ma wartość:
  
  1920 dla desktop;
  
  360 dla mobile na android;
  
  375 dla mobile na iOS;
  
  Uwaga: aby użyć tego parametru, ustaw calculate_rectangles na true
- calculate_rectangles
  Typ: boolean | null
  
  obliczaj pozycje pikselowe elementów SERP w wynikach zaawansowanych
  
  pole opcjonalne
  
  pozycja pikselowa to odległość między fragmentem wyniku a lewym górnym rogiem ekranu;
  
  Odwiedź Centrum pomocy, aby dowiedzieć się więcej>>
  
  domyślnie parametr ma wartość false
  
  Uwaga: jeśli ustawisz true, opłata za zadanie zostanie pomnożona przez 2
- device
  Typ: string | null
  
  typ urządzenia
  
  pole opcjonalne
  
  zwracaj wyniki dla określonego typu urządzenia
  
  może przyjmować wartości:desktop, mobile
  
  wartość domyślna: desktop
- keyword
  Typ: string
  
  słowo kluczowe
  
  pole wymagane
  
  w polu keyword możesz podać do 700 znaków
  
  wszystkie %## zostaną zdekodowane (znak ‘+’ zostanie zdekodowany jako spacja)
  
  jeśli chcesz użyć znaku „%” w keyword, podaj go jako „%25”;
  
  jeśli chcesz użyć znaku „+” w keyword, podaj go jako „%2B”
  
  więcej o zasadach i ograniczeniach pól keyword i keywords w interfejsach API DataForSEO znajdziesz w 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/ai_mode/languages
- 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/ai_mode/languages;
- location_code
  Typ: integer
  
  kod lokalizacji wyszukiwarki
  
  pole wymagane, jeśli nie podasz location_name lub location_coordinate
  
  jeśli używasz tego pola, nie musisz podawać location_name lub location_coordinate
  
  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
  
  Uwaga: sprawdź Google Search Help, aby poznać listę krajów, w których tryb AI Mode jest obecnie dostępny
- location_coordinate
  Typ: string
  
  współrzędne GPS lokalizacji
  
  pole wymagane, jeśli nie podasz location_name lub location_code
  
  jeśli używasz tego pola, nie musisz podawać location_name lub location_code
  
  parametr location_coordinate należy podać w formacie "latitude,longitude,zoom"
  
  jeśli "zoom" nie zostanie podany, domyślnie zostanie zastosowana wartość 9z
  
  maksymalna liczba cyfr po przecinku dla "latitude" i "longitude": 7
  
  wartość minimalna dla "zoom": 4z
  
  wartość maksymalna dla "zoom": 18z
  
  przykład:
  
  52.6178549,-155.352142,18z
- location_name
  Typ: string
  
  pełna nazwa lokalizacji wyszukiwarki
  
  pole wymagane, jeśli nie podasz location_code lub location_coordinate
  
  jeśli używasz tego pola, nie musisz podawać location_code lub location_coordinate
  
  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/locations
  
  Uwaga: sprawdź Google Search Help, aby poznać listę krajów, w których tryb AI Mode jest obecnie dostępny
- os
  Typ: string | null
  
  system operacyjny urządzenia
  
  pole opcjonalne
  
  jeśli w polu device podasz desktop, wybierz spośród następujących wartości: windows, macos
  
  wartość domyślna: windows
  
  jeśli w polu device podasz mobile, wybierz spośród następujących wartości: android, ios
  
  wartość domyślna: android
- 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 funkcji użytej do ustawienia zadania
  
  możliwe wartości:
  
  advanced, html
- 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_SerpGoogleAiModeTaskPostResponseInfo
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_SerpGoogleAiModeTaskPostTaskInfo
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/ai_mode/task_post

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

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

Tworzenie zadań SERP Google AI Mode

UwierzytelnianieRequired

DataForSEO

Tworzenie zadań SERP Google AI Mode

Cennik referencyjny