v0.2.0-beta

OpenAPI 3.1.0

Živý Bing Organic SERP HTML

Felo API Support

MIT

Server

https://openapi.felo.ai

Klientské knihovny

Shell Curl

DataForSEO

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

DataForSEO Operace

post/v1/beta/dataforseo/serp/bing/organic/live/html

Živý Bing Organic SERP HTML

Synchronně vrací výsledky v pořadí pro klíčové slovo v Bing. Surový zdrojový kód stránky místo parsovaných výsledků. Zabaleno do obálky DataForSEO: data v tasks[0].result, výsledek v tasks[0].status_code — odmítnutý požadavek stále vrací HTTP 200.

Cenová reference

Účtování: nahlášené náklady na odpověď.
Referenční odhad požadavku: USD 0.02.
Referenční multiplikátor zákazníka: 1.0. Znovu jej neaplikujte na již zúčtovanou částku zákazníka.

Pouze referenční metadata, nikoli nabídka pro účet, garantovaná cena či limit utrácení. Kredity prostředků nejsou kredity Felo. Konečné účtování se řídí fakturačními záznamy Felo.

Tělo

application/json

Typ: array (object | null)[]
- depth
  Typ: integer | null
  
  hloubka parsování
  
  volitelné pole
  
  počet výsledků v SERP
  
  výchozí hodnota: 10
  
  maximální hodnota: 200
  
  Váš účet bude účtován za každý SERP obsahující až 10 výsledků;
  Nastavení hloubky nad 10 může vést k dodatečným poplatkům pokud vyhledávač vrátí více než 10 výsledků;
  
  Náklady lze vypočítat na stránce Ceny.
- device
  Typ: string | null
  
  typ zařízení
  
  volitelné pole
  
  vracet výsledky pro určitý typ zařízení
  
  může nabývat hodnot:desktop, mobile
  
  výchozí hodnota: desktop
- keyword
  Typ: string
  
  klíčové slovo
  
  povinné pole
  
  v poli keyword můžete zadat až 700 znaků
  
  všechny %## budou dekódovány (znak '+' bude dekódován jako mezera)
  
  pokud potřebujete v keyword použít znak "%", zadejte jej jako "%25";
  
  pokud potřebujete v keyword použít znak „+“, zadejte jej jako „%2B“;
  
  další informace o pravidlech a omezeních polí keyword a keywords v rozhraních API DataForSEO najdete v článku Centra nápovědy
- language_code
  Typ: string
  
  kód jazyka vyhledávače
  
  povinné pole, pokud nezadáte language_name
  
  pokud toto pole použijete, nemusíte zadávat language_name
  
  seznam dostupných jazyků vyhledávače s jejich language_code získáte samostatným požadavkem na https://api.dataforseo.com/v3/serp/{{low_se_name}}/languages
  
  příklad:
  
  en
- language_name
  Typ: string
  
  úplný název jazyka vyhledávače
  
  povinné pole, pokud nezadáte language_code
  
  pokud toto pole použijete, nemusíte zadávat language_code
  
  seznam dostupných jazyků vyhledávače s jejich language_name získáte samostatným požadavkem na https://api.dataforseo.com/v3/serp/{{low_se_name}}/languages
  
  příklad:
  
  English
- location_code
  Typ: integer
  
  kód lokality vyhledávače
  
  povinné pole, pokud nezadáte location_name nebo location_coordinate
  
  pokud toto pole použijete, nemusíte zadávat location_name nebo location_coordinate
  
  seznam dostupných lokalit vyhledávačů s jejich location_code získáte samostatným požadavkem na https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations
  
  příklad:
  
  2840
- location_coordinate
  Typ: string
  
  GPS souřadnice lokality
  
  povinné pole, pokud nezadáte location_name nebo location_code
  
  pokud toto pole použijete, nemusíte zadávat location_name nebo location_code
  
  parametr location_coordinate je nutné zadat ve formátu "latitude,longitude"
  
  maximální počet desetinných míst pro "latitude" a "longitude": 7
  
  příklad:
  
  53.476225,-2.243572
- location_name
  Typ: string
  
  úplný název lokality vyhledávače
  
  povinné pole, pokud nezadáte location_code nebo location_coordinate
  
  pokud toto pole použijete, nemusíte zadávat location_code nebo location_coordinate
  
  seznam dostupných lokalit vyhledávače s jejich location_name získáte samostatným požadavkem na https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations
  
  příklad:
  
  London,England,United Kingdom
- match_type
  Typ: string
  
  typ shody cíle
  
  povinné pole, pokud je zadáno stop_crawl_on_match
  
  typ shody pro match_value
  
  možné hodnoty:
  
  domain – konkrétní doména nebo subdoména
  
  with_subdomains – hlavní doména a subdomény
  
  wildcard – vzor se zástupnými znaky
- match_value
  Typ: string
  
  cílová doména, subdoména nebo hodnota se zástupnými znaky
  
  povinné pole, pokud je zadáno stop_crawl_on_match
  
  zadejte cílovou doménu, subdoménu nebo hodnotu se zástupnými znaky;
  
  Poznámka: doménu nebo subdoménu je nutné zadat bez protokolu požadavku;
  
  příklad: "match_value": "dataforseo.com",
  
  "match_value": "/blog/post-*"
- max_crawl_pages
  Typ: integer | null
  
  limit procházení stránek
  
  volitelné pole
  
  počet stránek výsledků vyhledávání k procházení
  
  výchozí hodnota: 1
  
  maximální hodnota: 100
  
  Poznámka: parametry max_crawl_pages a depth se vzájemně doplňují;
  
  další informace najdete v našem Centru nápovědy
- os
  Typ: string | null
  
  operační systém zařízení
  
  volitelné pole
  
  pokud v poli device zadáte desktop, vyberte z následujících hodnot: windows, macos
  
  výchozí hodnota: windows
  
  pokud v poli device zadáte mobile, vyberte z následujících hodnot: android, ios
  
  výchozí hodnota: android
- search_param
  Typ: string | null
  
  další parametry vyhledávacího dotazu
  
  volitelné pole
  
  seznam dostupných parametrů a další podrobnosti najdete zde
- stop_crawl_on_match
  Typ: array (object | null)[] | null
  
  pole cílových hodnot pro zastavení procházení volitelné pole pokud je zadáno, odpověď bude obsahovat výsledky SERP až do zadané hodnoty match_value včetně; v tomto poli můžete zadat až 10 cílových hodnot příklad: "stop_crawl_on_match":[{"match_value":"dataforseo.com","match_type":"with_subdomains"}] další informace o tomto parametru najdete v našem Centru nápovědy — https://dataforseo.com/help-center/using-the-stop_crawl_on_match-parameter-in-serp-api Váš účet bude účtován za každý SERP procházený přes zadané cíle
  
  match_type
  Typ: string | null
  
  typ shody cíle povinné pole, pokud je zadáno stop_crawl_on_match; typ shody pro match_value možné hodnoty: domain, with_subdomains, wildcard
  
  match_value
  Typ: string | null
  
  cílová doména nebo hodnota se zástupným znakem povinné pole, pokud je zadáno stop_crawl_on_match; zadejte cílovou doménu nebo hodnotu se zástupným znakem; Poznámka: název domény je nutné zadat bez protokolu požadavku; příklad: dataforseo.com
- tag
  Typ: string | null
  
  identifikátor úlohy definovaný uživatelem
  
  volitelné pole
  
  limit znaků je 255
  
  tento parametr můžete použít k identifikaci úlohy a jejímu spárování s výsledkem
  
  zadanou hodnotu tag najdete v objektu data odpovědi
- url
  Typ: string | null
  
  přímá URL vyhledávacího dotazu
  
  volitelné pole
  
  můžete zadat přímou URL a my ji rozebereme do potřebných polí. Upozorňujeme, že tato metoda je pro naše API nejnáročnější na zpracování a vyžaduje zadání přesného jazyka a lokality v URL. Ve většině případů tuto metodu nedoporučujeme.
  
  příklad:
  
  https://www.bing.com/search?q=rank%20checker&count=50&first=1&setlang=en&cc=US&safesearch=Moderate&FORM=SEPAGE

Odpovědi

200
Typ: object | null · Response36Afe1097B20_SerpBingOrganicLiveHtmlResponseInfo
cost
Typ: number | null Formát: double

celkové náklady na úlohy, USD

status_code
Typ: integer | null

obecný kód stavu úplný seznam kódů odpovědí najdete zde

status_message
Typ: string | null

obecná informační zpráva úplný seznam obecných informačních zpráv najdete zde

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

pole úloh

Typ: object | null · Response36Afe1097B20_SerpBingOrganicLiveHtmlTaskInfo
cost
Typ: number | null Formát: double

celkové náklady na úlohy, USD

data
Typ: object | null

obsahuje stejné parametry, které jste zadali v požadavku POST

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

identifikátor úlohy jedinečný identifikátor úlohy v našem systému ve formátu UUID

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

cesta URL

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

pole výsledků

datetime
Typ: string | null

datum a čas přijetí výsledku
ve formátu UTC: „yyyy-mm-dd hh-mm-ss +00:00”
příklad:
2019-11-15 12:57:46 +00:00

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

prvky výsledků vyhledávání nalezené v SERP

date
Typ: string | null

datum a čas skenování stránky HTML
ve formátu UTC: “yyyy-mm-dd hh-mm-ss +00:00”
příklad:
2019-11-15 12:57:46 +00:00

html
Typ: string | null

stránka HTML

page
Typ: integer | null

pořadové číslo vrácené stránky HTML

items_count
Typ: integer | null Formát: int64

počet výsledků vrácených v poli items

keyword
Typ: string | null

klíčové slovo přijaté v poli POST
klíčové slovo se vrací s dekódovaným %## (znak plus '+' bude dekódován jako mezera)

language_code
Typ: string | null

kód jazyka v poli POST

location_code
Typ: integer | null

kód lokality v poli POST

se_domain
Typ: string | null

doména vyhledávače v poli POST

type
Typ: string | null

typ prvku

result_count
Typ: integer | null Formát: int64

počet prvků v poli result

status_code
Typ: integer | null

stavový kód úlohy vygenerovaný DataForSEO; může být v následujícím rozsahu: 10000-60000 úplný seznam kódů odpovědí najdete zde

status_message
Typ: string | null

informační zpráva úlohy úplný seznam obecných informačních zpráv najdete zde

time
Typ: string | null

doba provedení, sekundy

tasks_count
Typ: integer | null Formát: int64

počet úloh v poli tasks

tasks_error
Typ: integer | null Formát: int64

počet úloh v poli tasks vrácených s chybou

time
Typ: string | null

celková doba provádění, sekundy

version
Typ: string | null

aktuální verze API
application/json
400

Požadavek se nepodařilo zpracovat. Zkontrolujte parametry požadavku.
401

Je vyžadován platný API klíč Felo.
402

V požadavku nelze pokračovat, protože není splněn požadavek na fakturaci.
403

Účet nemá oprávnění tuto operaci provést.
429

Byl dosažen limit požadavků nebo útraty.
502

Služba nemohla požadavek dokončit.
503

API nebo fakturační služba je dočasně nedostupná.
504

Při zpracování požadavku vypršel časový limit služby.
default

Chybová odpověď; odpovědi předávané přímo od upstream poskytovatele mohou používat formáty poskytovatele

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"
  }
]'

Zobrazit schéma

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

Úspěšná operace

Živý Bing Organic SERP HTML

OvěřováníRequired

DataForSEO

Živý Bing Organic SERP HTML

Cenová reference