v0.2.0-beta

OpenAPI 3.1.0

Bing Organic SERP HTML na żywo

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/bing/organic/live/html

Bing Organic SERP HTML na żywo

Synchronicznie zwraca wyniki pozycjonowane dla słowa kluczowego w Bing. Surowy kod źródłowy strony zamiast przetworzonych wyników. Opakowane w kopertę DataForSEO: dane w tasks[0].result, wynik w tasks[0].status_code — odrzucone żądanie nadal zwraca HTTP 200.

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)[]
- depth
  Typ: integer | null
  
  głębokość parsowania
  
  pole opcjonalne
  
  liczba wyników w SERP
  
  wartość domyślna: 10
  
  wartość maksymalna: 200
  
  Twoje konto zostanie obciążone za każdy SERP zawierający do 10 wyników;
  Ustawienie głębokości powyżej 10 może wiązać się z dodatkowymi opłatami jeśli wyszukiwarka zwróci więcej niż 10 wyników;
  
  Koszt można obliczyć na stronie Cennik.
- 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/{{low_se_name}}/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/{{low_se_name}}/languages
  
  przykład:
  
  English
- 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/{{low_se_name}}/locations
  
  przykład:
  
  2840
- 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"
  
  maksymalna liczba cyfr po przecinku dla "latitude" i "longitude": 7
  
  przykład:
  
  53.476225,-2.243572
- 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/{{low_se_name}}/locations
  
  przykład:
  
  London,England,United Kingdom
- match_type
  Typ: string
  
  typ dopasowania celu
  
  pole wymagane, jeśli podano stop_crawl_on_match
  
  typ dopasowania dla match_value
  
  możliwe wartości:
  
  domain – konkretna domena lub subdomena
  
  with_subdomains – domena główna i subdomeny
  
  wildcard – wzorzec wieloznaczny
- match_value
  Typ: string
  
  docelowa domena, subdomena lub wartość wieloznaczna
  
  pole wymagane, jeśli podano stop_crawl_on_match
  
  podaj docelową domenę, subdomenę lub wartość wieloznaczną;
  
  Uwaga: domenę lub subdomenę należy podać bez protokołu żądania;
  
  przykład: "match_value": "dataforseo.com",
  
  "match_value": "/blog/post-*"
- max_crawl_pages
  Typ: integer | null
  
  limit indeksowania stron
  
  pole opcjonalne
  
  liczba stron wyników wyszukiwania do indeksowania
  
  wartość domyślna: 1
  
  wartość maksymalna: 100
  
  Uwaga: parametry max_crawl_pages i depth uzupełniają się;
  
  więcej informacji w naszym Centrum pomocy
- 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
- search_param
  Typ: string | null
  
  dodatkowe parametry zapytania wyszukiwania
  
  pole opcjonalne
  
  listę dostępnych parametrów i dodatkowe szczegóły znajdziesz tutaj
- stop_crawl_on_match
  Typ: array (object | null)[] | null
  
  tablica celów do zatrzymania indeksowania pole opcjonalne jeśli zostanie podana, odpowiedź będzie zawierać wyniki SERP do wskazanego match_value włącznie; w tej tablicy możesz podać do 10 wartości docelowych przykład: "stop_crawl_on_match":[{"match_value":"dataforseo.com","match_type":"with_subdomains"}] więcej o tym parametrze przeczytasz w naszym Centrum pomocy — https://dataforseo.com/help-center/using-the-stop_crawl_on_match-parameter-in-serp-api Twoje konto zostanie obciążone za każdy SERP przeszukany przez wskazane cele
  
  match_type
  Typ: string | null
  
  typ dopasowania celu pole wymagane, jeśli podano stop_crawl_on_match; typ dopasowania dla match_value możliwe wartości: domain, with_subdomains, wildcard
  
  match_value
  Typ: string | null
  
  domena docelowa lub wartość wieloznaczna pole wymagane, jeśli podano stop_crawl_on_match; podaj domenę docelową lub wartość wieloznaczną; Uwaga: nazwę domeny należy podać bez protokołu żądania; przykład: dataforseo.com
- 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
- url
  Typ: string | null
  
  bezpośredni URL zapytania wyszukiwania
  
  pole opcjonalne
  
  możesz podać bezpośredni URL, a my rozłożymy go na odpowiednie pola. Pamiętaj, że ta metoda jest najtrudniejsza do przetworzenia przez nasze API i wymaga podania dokładnego języka oraz lokalizacji w URL. W większości przypadków nie zalecamy jej stosowania.
  
  przykład:
  
  https://www.bing.com/search?q=rank%20checker&count=50&first=1&setlang=en&cc=US&safesearch=Moderate&FORM=SEPAGE

Odpowiedzi

200
Typ: object | null · Response36Afe1097B20_SerpBingOrganicLiveHtmlResponseInfo
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_SerpBingOrganicLiveHtmlTaskInfo
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

datetime
Typ: string | null

data i godzina otrzymania wyniku
w formacie UTC: „yyyy-mm-dd hh-mm-ss +00:00”
przykład:
2019-11-15 12:57:46 +00:00

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

elementy wyników wyszukiwania znalezione w SERP

date
Typ: string | null

data i godzina skanowania strony HTML
w formacie UTC: “yyyy-mm-dd hh-mm-ss +00:00”
przykład:
2019-11-15 12:57:46 +00:00

html
Typ: string | null

strona HTML

page
Typ: integer | null

numer seryjny zwróconej strony HTML

items_count
Typ: integer | null Format: int64

liczba wyników zwróconych w tablicy items

keyword
Typ: string | null

słowo kluczowe otrzymane w tablicy POST
słowo kluczowe jest zwracane z zdekodowanym %## (znak plus '+' zostanie zdekodowany jako spacja)

language_code
Typ: string | null

kod języka w tablicy POST

location_code
Typ: integer | null

kod lokalizacji w tablicy POST

se_domain
Typ: string | null

domena wyszukiwarki w tablicy POST

type
Typ: string | null

typ elementu

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/bing/organic/live/html

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

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": [
        {
          "keyword": null,
          "type": null,
          "se_domain": null,
          "location_code": null,
          "language_code": null,
          "datetime": null,
          "items_count": null,
          "items": [
            {
              "page": null,
              "date": null,
              "html": null
            }
          ]
        }
      ]
    }
  ]
}

Operacja zakończona powodzeniem

Bing Organic SERP HTML na żywo

UwierzytelnianieRequired

DataForSEO

Bing Organic SERP HTML na żywo

Cennik referencyjny