v0.2.0-beta

OpenAPI 3.1.0

Konkurenci SERP

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/dataforseo_labs/google/serp_competitors/live

Konkurenci SERP

Domeny pozycjonujące się obok Ciebie na zestaw keywords, wraz z liczbą wspólnych słów. Zwraca se_type, seed_keywords, total_count, 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. ⚠️ To konkurenci wyszukiwania, wyznaczani przez wspólne pozycje. Odpowiednik w grafie linków to post_dataforseo_backlinks_competitors_live, a obie listy często się różnią — co samo w sobie jest informacją.

Cennik referencyjny

Rozliczanie: zgłoszony koszt odpowiedzi.
Szacunek referencyjny dla żądania: USD 0.0192.
Referencyjny mnożnik klienta: 1.0. Nie stosuj go ponownie do rozliczonej już 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)[]
- filters
  Typ: array (object | null)[] | null
  
  tablica parametrów filtrowania wyników
  pole opcjonalne
  możesz dodać kilka filtrów jednocześnie (maksymalnie 8)
  między warunkami należy ustawić operator logiczny and, or
  obsługiwane są następujące operatory:
  regex, not_regex, <, <=, >, >=, =, <>, in, not_in, match, not_match, ilike, not_ilike, like, not_like
  operatora % możesz użyć z like i not_like, a także z ilike i not_ilike, aby dopasować dowolny ciąg złożony z zera lub więcej znaków
  przykład:
  ["median_position","in",[1,10]]
  
  [["median_position","in",[1,10]],"and",["domain","not_like","%wikipedia.org%"]]
  
  [["domain","not_like","%wikipedia.org%"], "and", [["relevant_serp_items",">",0],"or",["median_position","in",[1,10]]]]
  więcej informacji o filtrach znajdziesz w Dataforseo Labs - Filters lub w tym przewodniku Centrum pomocy
  
  Pusty obiekt
- include_subdomains
  Typ: boolean | null
  
  wskazuje, czy subdomeny będą uwzględniane w wyszukiwaniu
  pole opcjonalne
  jeśli ustawisz false, subdomeny zostaną pominięte
  wartość domyślna: true
- item_types
  Typ: array string[] | null
  
  typ wyników wyszukiwania
  wskazuje typ wyników wyszukiwania uwzględnionych w odpowiedzi
  pole opcjonalne
  
  możliwe wartości:
  ["organic", "paid", "featured_snippet", "local_pack"]
  wartość domyślna:
  ["organic", "paid"]
- keywords
  Typ: array string[]
  
  tablica słów kluczowych
  pole wymagane
  wyniki będą oparte na słowach kluczowych podanych w tej tablicy
  kodowanie UTF-8;
  Słowa kluczowe zostaną przekonwertowane na format małych liter;
  możesz podać maksymalnie 200 słów kluczowych
  
  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 | null
  
  unikalny identyfikator języka
  pole wymagane, jeśli nie podasz language_name
  Uwaga: należy podać language_name lub language_code
  listę dostępnych języków wraz z ich parametrami language_code można uzyskać, wysyłając osobne żądanie do
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  przykład:
  en
- language_name
  Typ: string
  
  pełna nazwa języka
  pole wymagane, jeśli nie podasz language_code
  Uwaga: należy podać language_name lub language_code
  listę dostępnych języków wraz z ich parametrami language_name można uzyskać, wysyłając osobne żądanie do
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  przykład:
  English
- limit
  Typ: integer | null
  
  maksymalna liczba zwracanych domen
  pole opcjonalne
  wartość domyślna: 100
  wartość maksymalna: 1000
- location_code
  Typ: integer
  
  unikalny identyfikator lokalizacji
  pole wymagane, jeśli nie podasz location_name
  Uwaga: należy podać location_name lub location_code
  listę dostępnych lokalizacji wraz z ich parametrami location_code można uzyskać, wysyłając osobne żądanie do
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  przykład:
  2840
- location_name
  Typ: string
  
  pełna nazwa lokalizacji
  pole wymagane, jeśli nie podasz location_code
  Uwaga: należy podać location_name lub location_code
  listę dostępnych lokalizacji wraz z ich parametrami location_name można uzyskać, wysyłając osobne żądanie do
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  przykład:
  United Kingdom
- offset
  Typ: integer | null
  
  przesunięcie w tablicy wyników zwracanych domen
  pole opcjonalne
  wartość domyślna: 0
  jeśli podasz wartość 10, pierwszych dziesięć domen w tablicy wyników zostanie pominiętych, a dane zostaną zwrócone dla kolejnych domen
- order_by
  Typ: array string[] | null
  
  zasady sortowania wyników
  pole opcjonalne
  do sortowania wyników możesz użyć tych samych wartości co w tablicy filters
  możliwe typy sortowania:
  asc — wyniki zostaną posortowane rosnąco
  desc — wyniki zostaną posortowane malejąco
  separatorem jest przecinek
  przykład:
  ["avg_position,asc"]
  domyślna reguła:
  ["rating,desc"]
  pamiętaj, że w jednym żądaniu można ustawić nie więcej niż trzy zasady sortowania
  kilka zasad sortowania należy oddzielić przecinkiem
  przykład:
  ["avg_position,asc","etv,desc"]
- tag
  Typ: string | null
  
  identyfikator zadania zdefiniowany przez użytkownika
  pole opcjonalne
  limit znaków: 255
  ten parametr służy do identyfikacji zadania i dopasowania go do wyniku
  podaną wartość tag znajdziesz w obiekcie data odpowiedzi

Odpowiedzi

200
Typ: object | null · Response36Afe1097B20_DataforseoLabsGoogleSerpCompetitorsLiveResponseInfo
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_DataforseoLabsGoogleSerpCompetitorsLiveTaskInfo
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: array (object | null)[] | null

tablica wyników

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

zawiera wykrytych konkurentów w SERP i powiązane dane

avg_position
Typ: number | null Format: float

średnia pozycja domeny dla określonych słów kluczowych
średnia arytmetyczna wartości w tablicy keywords_positions

domain
Typ: string | null

nazwa domeny wykrytego konkurenta w SERP

etv
Typ: number | null

szacowany wolumen ruchu
przedstawia szacowany miesięczny ruch, jaki określone słowa kluczowe generują do witryny
obliczany jako suma iloczynów wartości wolumenu wyszukiwań określonych słów kluczowych i współczynników CTR (współczynnika klikalności) na określonych pozycjach w SERP
więcej o sposobie obliczania tego miernika znajdziesz w tym artykule Centrum pomocy

keywords_count
Typ: integer | null Format: int64

liczba określonych słów kluczowych, na które domena ma pozycje w SERP

keywords_positions
Typ: object | null

pozycje słów kluczowych
pozycje w SERP, jakie powiązana domena zajmuje dla określonych słów kluczowych

propertyName
Typ: array (integer | null)[] | null
median_position
Typ: number | null

mediana pozycji domeny dla określonych słów kluczowych
mediana wartości w tablicy keywords_positions

rating
Typ: number | null

różnica między najwyższą możliwą a rzeczywistą pozycją słów kluczowych
przedstawia względny wskaźnik widoczności domeny w SERP dla określonych słów kluczowych
obliczany jako sum(100-keywords_positions)

relevant_serp_items
Typ: integer | null

liczba elementów SERP dotyczących domeny
przedstawia liczbę wyników wyszukiwania w SERP dotyczących domeny dla określonych słów kluczowych

se_type
Typ: string | null

typ wyszukiwarki

visibility
Typ: number | null

wskaźnik widoczności w SERP
przedstawia wskaźnik widoczności witryny na podstawie pozycji w SERP określonych słów kluczowych
Słowom kluczowym na pozycjach od 1 do 10 przypisuje się odpowiednio wskaźnik widoczności od 1 do 0,1
Słowa kluczowe na pozycjach od 11 do 20 mają stały wskaźnik widoczności 0,05
słowa kluczowe na pozycjach od 20 do 100 mają wskaźnik widoczności równy 0

items_count
Typ: integer | null Format: int64

liczba wyników zwróconych w tablicy items

language_code
Typ: string | null

kod języka w tablicy POST
jeśli brak danych, wartością jest null

location_code
Typ: integer | null

kod lokalizacji w tablicy POST
jeśli brak danych, wartością jest null

se_type
Typ: string | null

typ wyszukiwarki

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

słowa kluczowe określone w żądaniu
słowo kluczowe jest zwracane ze zdekodowanymi sekwencjami %## (znak „+” zostanie zdekodowany jako spacja)

total_count
Typ: integer | null Format: int64

łączna liczba wyników w naszej bazie danych odpowiadających Twojemu żądaniu

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/dataforseo_labs/google/serp_competitors/live

curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/serp_competitors/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "keywords": [
      "phone"
    ],
    "language_name": "English",
    "location_code": 2840,
    "item_types": [
      "organic"
    ],
    "limit": 5
  }
]'

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": [
        {
          "se_type": null,
          "seed_keywords": [
            null
          ],
          "location_code": null,
          "language_code": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "se_type": null,
              "domain": null,
              "avg_position": null,
              "median_position": null,
              "rating": null,
              "etv": null,
              "keywords_count": null,
              "visibility": null,
              "relevant_serp_items": null,
              "keywords_positions": null
            }
          ]
        }
      ]
    }
  ]
}

Operacja zakończona powodzeniem

Konkurenci SERP

UwierzytelnianieRequired

DataForSEO

Konkurenci SERP

Cennik referencyjny