v0.2.0-beta

OpenAPI 3.1.0

Google Local Finder SERP naživo – 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/google/local_finder/live/html

Google Local Finder SERP naživo – HTML

Synchronně vrací rozšířené místní výsledky, které Google zobrazuje, když má dotaz jasně lokální povahu. 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. Neaplikujte jej znovu na 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: 100
  
  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ů;
  
  pokud je zadaná hloubka vyšší než počet výsledků v odpovědi, rozdíl vám bude automaticky vrácen na zůstatek účtu;
  
  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
  
  do pole keyword můžete zadat až 700 znaků
  
  všechny výskyty %## 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”
- 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,zoom"
  
  pokud není "zoom" zadán, použije se jako výchozí hodnota 9z
  
  maximální počet desetinných míst pro "latitude" a "longitude": 7
  
  minimální hodnota pro "zoom": 4z
  
  maximální hodnota pro "zoom": 18z
  
  příklad:
  
  52.6178549,-155.352142,20z
- 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
- min_rating
  Typ: string | null
  
  filtrovat výsledky podle minimálního hodnocení
  
  volitelné pole
  
  možné hodnoty pro desktop: 3.5, 4, 4.5;
  
  možné hodnoty pro mobile: 2, 2.5, 3, 3.5, 4, 4.5
- 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
- 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
- time_filter
  Typ: string | null
  
  filtrovat výsledky podle otevíracích hodin
  
  volitelné pole
  
  pomocí tohoto pole můžete filtrovat místa ve výsledcích podle doby, kdy je místo otevřené pro návštěvníky
  
  mějte na paměti, že Google může poskytnout i výsledky, které tomuto filtru neodpovídají
  
  možné hodnoty: "open_now", "24_hours", "$day_value", "$day_value;$time_value";
  
  místo $day_value použijte jednu z těchto hodnot: "monday", "tuesday", "wednesday", "thursday", "friday", "saturday", "sunday";
  
  místo $time_value použijte jednu z těchto hodnot: "00", "01", "02", "03", "04", "05", "06", "07", "08", "09", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23"
  
  příklad: "tuesday;18"

Odpovědi

200
Typ: object | null · Response36Afe1097B20_SerpGoogleLocalFinderLiveHtmlResponseInfo
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_SerpGoogleLocalFinderLiveHtmlTaskInfo
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/google/local_finder/live/html

curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/local_finder/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

Google Local Finder SERP naživo – HTML

OvěřováníRequired

DataForSEO

Google Local Finder SERP naživo – HTML

Cenová reference