v0.2.0-beta

OpenAPI 3.1.0

Istotne strony

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/relevant_pages/live

Istotne strony

Które strony witryny target zdobywają jej pozycje, uszeregowane według generowanego ruchu. Stronicowanie przez limit, offset i offset_token; po pierwszych stronach korzystaj z tokena. Opakowane w kopertę DataForSEO: dane w tasks[0].result, wynik w tasks[0].status_code — odrzucone żądanie nadal zwraca HTTP 200. Użyj go, aby znaleźć strony warte obrony lub rozbudowy. Dla słów kluczowych, które za nimi stoją, użyj post_dataforseo_labs_google_kw_for_site_live; dla stron zdobywających linki, a nie pozycje — post_dataforseo_backlinks_domain_pages_summary_live.

Cennik referencyjny

Rozliczanie: zgłoszony koszt odpowiedzi.
Szacunek referencyjny dla żądania: USD 0.015.
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
  
  przykład:
  ["metrics.paid.count",">",0]
  
  [["metrics.organic.count",">",50],"and",["metrics.organic.pos_1","<>",0]]
  
  [[""metrics.organic.count",">",50"], "and", [["metrics.organic.pos_1","<>",0],"or",["metrics.organic.pos_2_3","<>",0]]]
  więcej informacji o filtrach znajdziesz w Dataforseo Labs - Filters lub w tym przewodniku Centrum pomocy
  
  Pusty obiekt
- historical_serp_mode
  Typ: string | null
  
  tryb zbierania danych
  pole opcjonalne
  tego pola możesz użyć do filtrowania wyników;
  możliwe typy filtrowania:
  live — zwraca metryki dla SERP-ów, w których podany target obecnie ma wyniki pozycjonowania;
  lost — zwraca metryki dla SERP-ów, w których podany target miał wcześniej wyniki pozycjonowania, ale nie miał ich podczas ostatniego sprawdzenia;
  all — zwraca metryki dla obu typów SERP-ów.
  wartość domyślna: live
- ignore_synonyms
  Typ: boolean | null
  
  ignoruj bardzo podobne słowa kluczowe
  pole opcjonalne
  jeśli ustawisz true, zwrócone zostaną tylko główne słowa kluczowe, a wszystkie bardzo podobne słowa kluczowe zostaną wykluczone;
  wartość domyślna: false
- include_clickstream_data
  Typ: boolean | null
  
  uwzględnianie lub wykluczanie danych z metryk opartych na clickstreamie w wyniku
  pole opcjonalne
  jeśli parametr ma wartość true, w odpowiedzi otrzymasz pola clickstream_etv, clickstream_gender_distribution i clickstream_age_distribution z danymi clickstream
  wartość domyślna: false
  włączenie tego parametru oznacza dwukrotnie wyższą opłatę za żądanie
  
  więcej o tym, jak obliczane są metryki oparte na clickstreamie, przeczytasz w tym artykule Centrum pomocy
- item_types
  Typ: array string[] | null
  
  wyświetlanie wyników według typu elementu
  pole opcjonalne
  wskazuje typ wyników wyszukiwania uwzględnionych w odpowiedzi
  
  Uwaga: jeśli tablica item_types zawiera typy elementów inne niż organic, wyniki zostaną uporządkowane według pierwszego typu elementu w tablicy; nie będzie można sortować ani filtrować wyników według typów wyników wyszukiwania nieuwzględnionych w odpowiedzi;
  
  możliwe wartości:
  ["organic", "paid", "featured_snippet", "local_pack"]
  wartość domyślna:
  ["organic", "paid"]
- language_code
  Typ: string | null
  
  kod języka
  pole opcjonalne
  jeśli użyjesz tego pola, nie musisz podawać language_name
  listę dostępnych języków wraz z ich language_code możesz otrzymać, wysyłając osobne żądanie do
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  zignoruj to pole, aby otrzymać wyniki dla wszystkich dostępnych języków
  przykład:
  en
- language_name
  Typ: string | null
  
  pełna nazwa języka
  pole opcjonalne
  jeśli użyjesz tego pola, nie musisz podawać language_code
  listę dostępnych języków wraz z ich language_name możesz otrzymać, wysyłając osobne żądanie do
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  zignoruj to pole, aby otrzymać wyniki dla wszystkich dostępnych języków
  przykład:
  English
- limit
  Typ: integer | null
  
  maksymalna liczba zwracanych stron
  pole opcjonalne
  wartość domyślna: 100
  wartość maksymalna: 1000
- location_code
  Typ: integer | null
  
  kod lokalizacji
  pole opcjonalne
  jeśli użyjesz tego pola, nie musisz podawać location_name
  listę dostępnych lokalizacji wraz z ich location_code możesz otrzymać, wysyłając osobne żądanie do
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  zignoruj to pole, aby otrzymać wyniki dla wszystkich dostępnych lokalizacji
  przykład:
  2840
- location_name
  Typ: string | null
  
  pełna nazwa lokalizacji
  pole opcjonalne
  jeśli użyjesz tego pola, nie musisz podawać location_code
  listę dostępnych lokalizacji wraz z ich location_name możesz otrzymać, wysyłając osobne żądanie do
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  zignoruj to pole, aby otrzymać wyniki dla wszystkich dostępnych lokalizacji
  przykład:
  United Kingdom
- offset
  Typ: integer | null
  
  przesunięcie w tablicy wyników zwracanych stron
  pole opcjonalne
  wartość domyślna: 0
  jeśli podasz wartość 10, pierwszych dziesięć stron w tablicy wyników zostanie pominiętych, a dane zostaną zwrócone dla kolejnych stron
- 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
  typ sortowania ustawia się przecinkiem
  przykład:
  ["metrics.paid.etv,asc"]
  Uwaga: w jednym żądaniu można ustawić nie więcej niż trzy zasady sortowania
  kilka zasad sortowania należy oddzielić przecinkiem
  przykład:
  ["metrics.organic.etv,desc","metrics.paid.count,asc"]
  
  domyślna reguła:
  ["metrics.organic.count,desc"]
  Uwaga: jeśli tablica item_types zawiera typy elementów inne niż organic, wyniki zostaną uporządkowane według pierwszego typu elementu w tablicy
- 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
- target
  Typ: string
  
  domena
  pole wymagane
  nazwa domeny docelowej witryny
  domenę należy podać bez https:// i www.

Odpowiedzi

200
Typ: object | null · Response36Afe1097B20_DataforseoLabsGoogleRelevantPagesLiveResponseInfo
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_DataforseoLabsGoogleRelevantPagesLiveTaskInfo
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

odpowiednie strony i powiązane dane

metrics
Typ: object | null

rankingi i mierniki ruchu dla odpowiedniej strony

propertyName
Typ: object · Response36Afe1097B20_DataforseoLabsMetricsInfo
clickstream_age_distribution
Typ: object | null

rozkład mierników opartych na clickstreamie według wieku
aby uzyskać wyniki dla tego pola, parametr include_clickstream_data musi mieć wartość true
więcej o sposobie obliczania tego miernika znajdziesz w tym artykule Centrum pomocy

propertyName
Typ: integer | null Format: int64

Signed 64-bit integers (long type).

clickstream_etv
Typ: number | null Format: double

szacowany wolumen ruchu na podstawie danych clickstreamu
obliczany jako iloczyn współczynnika klikalności i wartości wolumenu wyszukiwań z clickstreamu wszystkich słów kluczowych, na które pozycjonuje się domena
aby uzyskać wyniki dla tego pola, parametr include_clickstream_data musi mieć wartość true
więcej o sposobie obliczania tego miernika znajdziesz w tym artykule Centrum pomocy

clickstream_gender_distribution
Typ: object | null

rozkład szacowanych mierników opartych na clickstreamie według płci
aby uzyskać wyniki dla tego pola, parametr include_clickstream_data musi mieć wartość true
więcej o sposobie obliczania tego miernika znajdziesz w tym artykule Centrum pomocy

propertyName
Typ: integer | null Format: int64

Signed 64-bit integers (long type).

count
Typ: integer | null Format: int64

łączna liczba organicznych SERP zawierających domenę lub subdomenę

estimated_paid_traffic_cost
Typ: number | null

szacowany koszt zamiany organicznego ruchu wyszukiwania na płatny
przedstawia szacowany miesięczny koszt (USD) prowadzenia reklam dla wszystkich słów kluczowych w kategorii, na które pozycjonuje się domena lub subdomena
miernik oblicza się jako iloczyn wartości organicznego etv i płatnego cpc i wskazuje koszt pozyskania szacowanego miesięcznego ruchu organicznego przez reklamę PPC w Google Search
więcej o sposobie obliczania tego miernika znajdziesz w tym artykule Centrum pomocy

etv
Typ: number | null

szacowany wolumen ruchu
szacowany organiczny miesięczny ruch do domeny lub subdomeny
obliczany jako iloczyn CTR (współczynnika klikalności) i wartości wolumenu wyszukiwań wszystkich słów kluczowych w kategorii, na które pozycjonuje się domena lub subdomena
więcej o sposobie obliczania tego miernika znajdziesz w tym artykule Centrum pomocy

is_down
Typ: integer | null

rank spadł
wskazuje, ile elementów rankingowych wskazanego celu spadło

is_lost
Typ: integer | null

utracone elementy rankingowe
wskazuje, ile elementów rankingowych wskazanego celu było wcześniej prezentowanych w SERP, ale nie zostało znalezionych podczas ostatniego sprawdzenia

is_new
Typ: integer | null

liczba nowych elementów rankingowych
wskazuje, ile nowych elementów rankingowych znaleziono dla wskazanego celu

is_up
Typ: integer | null

rank wzrósł
wskazuje, ile elementów rankingowych wskazanego celu wzrosło

pos_1
Typ: integer | null

liczba organicznych SERP, w których domena lub subdomena zajmuje #1

pos_11_20
Typ: integer | null

liczba organicznych SERP, w których domena lub subdomena zajmuje pozycje #11-20

pos_2_3
Typ: integer | null

liczba organicznych SERP, w których domena lub subdomena zajmuje pozycje #2-3

pos_21_30
Typ: integer | null

liczba organicznych SERP, w których domena lub subdomena zajmuje pozycje #21-30

pos_31_40
Typ: integer | null

liczba organicznych SERP, w których domena lub subdomena zajmuje pozycje #31-40

pos_4_10
Typ: integer | null

liczba organicznych SERP, w których domena lub subdomena zajmuje pozycje #4-10

pos_41_50
Typ: integer | null

liczba organicznych SERP, w których domena lub subdomena zajmuje pozycje #41-50

pos_51_60
Typ: integer | null

liczba organicznych SERP, w których domena lub subdomena zajmuje pozycje #51-60

pos_61_70
Typ: integer | null

liczba organicznych SERP, w których domena lub subdomena zajmuje pozycje #61-70

pos_71_80
Typ: integer | null

liczba organicznych SERP, w których domena lub subdomena zajmuje pozycje #71-80

pos_81_90
Typ: integer | null

liczba organicznych SERP, w których domena lub subdomena zajmuje pozycje #81-90

pos_91_100
Typ: integer | null

liczba organicznych SERP, w których domena lub subdomena zajmuje pozycje #91-100

page_address
Typ: string | null

bezwzględny adres URL odpowiedniej strony

se_type
Typ: string | null

typ wyszukiwarki

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

target
Typ: string | null

domena docelowa w tablicy POST

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/relevant_pages/live

curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/relevant_pages/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "amazon.com",
    "language_name": "English",
    "location_code": 2840,
    "filters": [
      [
        "metrics.organic.pos_1",
        "<>",
        0
      ],
      "or",
      [
        "metrics.organic.pos_2_3",
        "<>",
        0
      ]
    ],
    "limit": 3
  }
]'

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,
          "target": null,
          "location_code": null,
          "language_code": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "se_type": null,
              "page_address": null,
              "metrics": null
            }
          ]
        }
      ]
    }
  ]
}

Operacja zakończona powodzeniem

Istotne strony

UwierzytelnianieRequired

DataForSEO

Istotne strony

Cennik referencyjny