v0.2.0-beta

OpenAPI 3.1.0

Úlohy vyhledávání živých firemních záznamů

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/business_data/business_listings/search/live

Úlohy vyhledávání živých firemních záznamů

Prohledává vlastní index místních firemních záznamů DataForSEO podle categories, description, title a location_coordinate – trojice zeměpisná šířka, délka a poloměr. Vrací total_count, count, offset, offset_token a items, stránkované tokenem. Odpověď je zabalena 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. Tento endpoint čte index a odpovídá okamžitě; vše ostatní v této části zařazuje živé stažení zdroje. Začněte zde a ponořte se dál jen tam, kde to má smysl.

Referenční ceny

Účtování: vykázaná cena odpovědi.
Referenční odhad ceny požadavku: USD 0.2428.
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 ani 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)[]
- categories
  Typ: array string[] | null
  
  kategorie firem
  volitelné pole
  zadané kategorie se používají k vyhledávání firemních záznamů;
  pokud toto pole nepoužijete, vrátíme firemní záznamy nalezené v zadané lokalitě;
  můžete zadat až 10 kategorií
- description
  Typ: string | null
  
  popis prvku v SERP
  volitelné pole
  popis obchodního subjektu, pro který se výsledky shromažďují;
  může obsahovat až 200 znaků
- filters
  Typ: array (object | null)[] | null
  
  pole parametrů filtrování výsledků
  volitelné pole
  můžete přidat několik filtrů najednou (maximálně 8)
  mezi podmínkami je nutné nastavit logický operátor and, or
  podporované operátory:
  regex, not_regex, <, <=, >, >=, =, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
  operátor % můžete použít s like a not_like pro shodu s libovolným řetězcem o nule nebo více znacích
  příklad:
  ["rating.value",">",3]
  seznam dostupných filtrů získáte samostatným požadavkem na https://api.dataforseo.com/v3/business_data/business_listings/available_filters
  Úplný seznam možných filtrů je k dispozici zde.
  
  Prázdný objekt
- is_claimed
  Typ: boolean | null
  
  určuje, zda je firma ověřena svým vlastníkem v Google Maps
  volitelné pole
- limit
  Typ: integer | null
  
  maximální počet vrácených firem
  volitelné pole
  výchozí hodnota: 100
  maximální hodnota: 1000
- location_coordinate
  Typ: string | null
  
  GPS souřadnice lokality
  volitelné pole
  parametr location_coordinate je nutné zadat ve formátu "latitude,longitude,radius"
  maximální počet desetinných míst pro "latitude" a "longitude": 7
  hodnota "radius" se zadává v kilometrech (km)
  minimální hodnota "radius": 1
  maximální hodnota "radius": 100000
  příklad:
  53.476225,-2.243572,200
  více o nastavování parametrů lokality v tomto API najdete v našem centru nápovědy
- offset
  Typ: integer | null
  
  posun v poli výsledků vrácených firem
  volitelné pole
  výchozí hodnota: 0
  pokud zadáte hodnotu 10, prvních deset entit v poli výsledků bude vynecháno a data budou vrácena pro následující entity
  Poznámka: doporučujeme tento parametr používat pouze při načítání až 10 000 výsledků
  pro načtení více než 10 000 výsledků použijte místo toho offset_token
- offset_token
  Typ: string | null
  
  token pro následné požadavky
  volitelné pole
  uvádí se ve stejném poli odpovědi na každý požadavek;
  tento parametr použijte, abyste se vyhnuli časovým limitům při snaze získat více než 100 000 výsledků v jednom požadavku;
  zadáním jedinečné hodnoty offset_token z pole odpovědi získáte následné výsledky původní úlohy;
  hodnoty offset_token jsou jedinečné pro každou následnou úlohu
  Poznámka: pokud je v požadavku zadán offset_token, všechny ostatní parametry musí být shodné s předchozím požadavkem
  další informace o tomto parametru najdete v našem centru nápovědy
- order_by
  Typ: array string[] | null
  
  pravidla řazení výsledků
  volitelné pole
  k řazení výsledků můžete použít stejné hodnoty jako v poli filters
  možné typy řazení:
  asc — výsledky budou seřazeny vzestupně
  desc — výsledky budou seřazeny sestupně
  parametr řazení se nastavuje čárkou
  příklad:
  ["rating.value,desc"]pamatujte, že v jednom požadavku lze nastavit nejvýše tři pravidla řazení
  několik pravidel řazení je nutné oddělit čárkou
  příklad:
  ["rating.value,desc","rating.votes_count,desc"]
- tag
  Typ: string | null
  
  uživatelem definovaný identifikátor úlohy
  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
- title
  Typ: string | null
  
  název prvku v SERP
  volitelné pole
  název obchodního subjektu, pro který se výsledky shromažďují;
  může obsahovat až 200 znaků

Odpovědi

200
Typ: object | null · Response36Afe1097B20_BusinessDataBusinessListingsSearchLiveResponseInfo
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_BusinessDataBusinessListingsSearchLiveTaskInfo
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ů

count
Typ: integer | null Formát: int64

typy prvků
počet prvků v poli items

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

nalezené typy prvků
typy výsledků vyhledávání nalezené v poli items;
možné typy prvků: business_listing

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

doplňkové kategorie podnikání
doplňkové kategorie Google My Business, které podrobněji popisují služby poskytované podnikatelským subjektem

address
Typ: string | null

adresa obchodního subjektu

address_info
Typ: object | null · Response36Afe1097B20_AddressInfo

objekt obsahující složky adresy obchodního subjektu

address
Typ: string | null

uliční adresa místní provozovny

borough
Typ: string | null

správní jednotka nebo obvod, do kterého místní provozovna patří

city
Typ: string | null

název města, kde se místní provozovna nachází

country_code
Typ: string | null

kód země ISO místní provozovny

region
Typ: string | null

oblast DMA, do které místní provozovna patří

zip
Typ: string | null

PSČ místní provozovny

attributes
Typ: object | null · Response36Afe1097B20_BusinessDataAttributesInfo

podrobnosti služeb ve formě kontrol hodnocených uživateli;
podrobnosti služeb obchodního subjektu zobrazené ve formě kontrol a založené na zpětné vazbě uživatelů a category podniku

available_attributes
Typ: object | null

dostupné atributy
udává atributy, které firma může nabízet

propertyName
Typ: array (string | null)[] | null
unavailable_attributes
Typ: object | null

nedostupné atributy
udává atributy, které firma nemůže nabízet

propertyName
Typ: array (string | null)[] | null
category
Typ: string | null

kategorie podnikání
obecná kategorie Google My Business, která nejlépe popisuje služby poskytované podnikatelským subjektem

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

globální ID kategorií
univerzální ID kategorií, která se nemění podle vybrané země

check_url
Typ: string | null

přímá adresa URL na výsledky vyhledávače
můžete ji použít k ověření, že jsme poskytli přesné výsledky

cid
Typ: string | null

klientské ID definované Googlem
jedinečné ID místní provozovny
více o identifikátoru najdete v tomto článku centra nápovědy

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

dostupné kontakty firmy
seznam kontaktů pro komunikaci s firmou

source
Typ: string | null

zdroj dat

type
Typ: string | null

typ prvku

value
Typ: string | null

hodnota hodnocení

description
Typ: string | null

popis prvku v SERP
popis obchodního subjektu, pro který se výsledky shromažďují

domain
Typ: string | null

doména firmy

feature_id
Typ: string | null

jedinečný identifikátor prvku v SERP
více o identifikátoru v tomto článku nápovědy

first_seen
Typ: string | null

datum a čas, kdy náš crawler poprvé našel prvek firemního záznamu
ve formátu UTC: „yyyy-mm-dd hh-mm-ss +00:00“
příklad:
2023-03-11 10:04:11 +00:00

hotel_rating
Typ: integer | null

klasifikace hotelu
třídy se pohybují v rozmezí 1–5 hvězdiček, další informace
pokud nejsou k dispozici informace o klasifikaci hotelu, bude hodnota null

is_claimed
Typ: boolean | null

udává, zda je subjekt ověřen vlastníkem v Google Maps

last_updated_time
Typ: string | null

datum a čas poslední aktualizace dat
ve formátu UTC: „yyyy-mm-dd hh-mm-ss +00:00“
příklad:
2023-01-26 09:03:15 +00:00

latitude
Typ: number | null

souřadnice zeměpisné šířky místních provozoven v Mapách Google
příklad:
"latitude": 51.584091

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

dostupné interakce s podnikem
seznam možností interakce s podnikem přímo z výsledků vyhledávání

type
Typ: string | null

typ prvku

logo
Typ: string | null

URL loga zobrazeného v profilu Google My Business

longitude
Typ: number | null

souřadnice zeměpisné délky místní provozovny v Mapách Google
příklad:
"longitude": -0.31365919999999997

main_image
Typ: string | null

adresa URL hlavního obrázku v profilu Google My Business

original_title
Typ: string | null

původní název prvku
původní název nepřeložený Googlem

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

související obchodní subjekty

cid
Typ: string | null

klientské ID definované Googlem
jedinečné ID místní provozovny
více o identifikátoru najdete v tomto článku centra nápovědy

feature_id
Typ: string | null

jedinečný identifikátor prvku v SERP
více o identifikátoru v tomto článku nápovědy

rating
Typ: object | null · Response36Afe1097B20_RatingInfo

hodnocení prvku
míra popularity založená na recenzích, zobrazená v SERP

rating_max
Typ: integer | null

maximální hodnota pro rating_type

rating_type
Typ: string | null

typ hodnocení zde najdete následující prvky: Max5, Percents, CustomMax

value
Typ: number | null Formát: double

hodnota hodnocení

votes_count
Typ: integer | null Formát: int64

množství zpětné vazby

title
Typ: string | null

název prvku v SERP
název obchodního subjektu, pro který se výsledky shromažďují

phone
Typ: string | null

telefonní číslo obchodního subjektu

place_id
Typ: string | null

jedinečný identifikátor místa
place id místní provozovny uvedené v prvku
více o identifikátoru najdete v tomto článku nápovědy

place_topics
Typ: object | null

klíčová slova zmíněná v recenzích zákazníků
obsahuje nejpopulárnější klíčová slova související s produkty/službami zmíněnými v recenzích zákazníků obchodního subjektu a počet recenzí, které každé klíčové slovo zmiňují
příklad:"place_topics": { "egg roll": 48, "birthday": 33 }

propertyName
Typ: integer | null Formát: int64

Signed 64-bit integers (long type).

popular_times
Typ: object | null · Response36Afe1097B20_PopularTimes

oblíbené časy
informace o rušných hodinách obchodního subjektu

popular_times_by_days
Typ: object | null

oblíbené hodiny
informace o vytížených hodinách místní provozovny v jednotlivých dnech týdne

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

pracovní doba v neděli

popular_index
Typ: integer | null

index popularity relativní časově vázaný index popularity měřený od 0 do 100; vyšší hodnota odpovídá vytíženější části dne

time
Typ: object | null · Response36Afe1097B20_TimeInfo

hodiny ve 24hodinovém formátu

hour
Typ: integer | null

hodiny ve 24hodinovém formátu

minute
Typ: integer | null

minuty

price_level
Typ: string | null

cenová hladina podniku
může nabývat hodnot: inexpensive, moderate, expensive, very_expensive
pokud nejsou k dispozici informace o cenové hladině, bude hodnota null

rating
Typ: object | null · Response36Afe1097B20_RatingInfo

hodnocení prvku
míra popularity založená na recenzích, zobrazená v SERP

rating_max
Typ: number | null Formát: double

maximální hodnota pro rating_type

rating_type
Typ: string | null

typ hodnocení zde najdete následující prvky: Max5, Percents, CustomMax

value
Typ: number | null Formát: double

hodnota hodnocení

votes_count
Typ: integer | null Formát: int64

množství zpětné vazby

rating_distribution
Typ: object | null

rozložení hodnocení firmy
objekt zobrazuje počet hodnocení od 1 do 5 hvězdiček podle recenzí uživatelů

propertyName
Typ: integer | null Formát: Int64
services
Typ: array (object | null)[] | null
category
Typ: string | null

kategorie podnikání
obecná kategorie Google My Business, která nejlépe popisuje služby poskytované podnikatelským subjektem

price
Typ: object | null · Response36Afe1097B20_PriceInfo
currency
Typ: string | null

měna uvedené ceny kód ISO měny použité na cenu

current
Typ: number | null Formát: double

aktuální cena udává aktuální cenu produktu nebo služby uvedené ve výsledku

displayed_price
Typ: string | null

řetězec ceny ve výsledku surový řetězec ceny tak, jak je uveden ve výsledku

is_price_range
Typ: boolean | null

cena je uvedena jako rozsah udává, zda je cena uvedena jako rozsah

max_value
Typ: number | null Formát: double

maximální cena maximální cena produktu nebo služby uvedená ve výsledku

regular
Typ: number | null Formát: double

běžná cena udává běžnou cenu produktu nebo služby bez uplatněných slev

snippet
Typ: string | null

doplňující informace o obchodním subjektu

title
Typ: string | null

název prvku v SERP
název obchodního subjektu, pro který se výsledky shromažďují

snippet
Typ: string | null

doplňující informace o obchodním subjektu

title
Typ: string | null

název prvku v SERP
název obchodního subjektu, pro který se výsledky shromažďují

total_photos
Typ: integer | null Formát: int64

celkový počet obrázků v profilu Google My Business

type
Typ: string | null

typ prvku

url
Typ: string | null

absolutní URL obchodního subjektu

work_time
Typ: object | null · Response36Afe1097B20_BusinessWorkHoursInfo

podrobnosti pracovní doby
informace o provozních hodinách obchodního subjektu

work_hours
Typ: object | null · Response36Afe1097B20_WorkHours

otevírací doba
informace o pracovní době místní provozovny

current_status
Typ: string | null

aktuální stav podniku
označuje, zda je podnik otevřený, nebo zavřený

timetable
Typ: object | null

rozvrh pracovní doby

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

pracovní doba v neděli

close
Typ: object | null · Response36Afe1097B20_TimeInfo

zavírací doba

hour
Typ: integer | null

hodiny ve 24hodinovém formátu

minute
Typ: integer | null

minuty

open
Typ: object | null · Response36Afe1097B20_TimeInfo

otevírací doba

hour
Typ: integer | null

hodiny ve 24hodinovém formátu

minute
Typ: integer | null

minuty

offset
Typ: integer | null Formát: int64

Signed 64-bit integers (long type).

offset_token
Typ: string | null
total_count
Typ: integer | null Formát: int64

celkový počet výsledků v naší databázi relevantních pro váš požadavek

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/business_data/business_listings/search/live

curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/business_listings/search/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "categories": [
      "pizza_restaurant"
    ],
    "description": "pizza",
    "title": "pizza",
    "is_claimed": true,
    "location_coordinate": "53.476225,-2.243572,10",
    "order_by": [
      "rating.value,desc"
    ],
    "filters": [
      [
        "rating.value",
        ">",
        3
      ]
    ],
    "limit": 3
  }
]'

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": [
        {
          "total_count": null,
          "count": null,
          "offset": null,
          "offset_token": null,
          "items": [
            {
              "type": null,
              "title": null,
              "original_title": null,
              "description": null,
              "category": null,
              "category_ids": [
                "[Max Depth Exceeded]"
              ],
              "additional_categories": [
                "[Max Depth Exceeded]"
              ],
              "cid": null,
              "feature_id": null,
              "address": null,
              "address_info": "[Max Depth Exceeded]",
              "place_id": null,
              "phone": null,
              "url": null,
              "domain": null,
              "logo": null,
              "main_image": null,
              "total_photos": null,
              "snippet": null,
              "latitude": null,
              "longitude": null,
              "is_claimed": null,
              "attributes": "[Max Depth Exceeded]",
              "place_topics": null,
              "rating": {
                "0": "[",
                "1": "M",
                "2": "a",
                "3": "x",
                "4": " ",
                "5": "D",
                "6": "e",
                "7": "p",
                "8": "t",
                "9": "h",
                "10": " ",
                "11": "E",
                "12": "x",
                "13": "c",
                "14": "e",
                "15": "e",
                "16": "d",
                "17": "e",
                "18": "d",
                "19": "]",
                "rating_type": "[Max Depth Exceeded]",
                "value": "[Max Depth Exceeded]",
                "votes_count": "[Max Depth Exceeded]",
                "rating_max": "[Max Depth Exceeded]"
              },
              "hotel_rating": null,
              "price_level": null,
              "rating_distribution": null,
              "people_also_search": [
                "[Max Depth Exceeded]"
              ],
              "work_time": "[Max Depth Exceeded]",
              "popular_times": "[Max Depth Exceeded]",
              "local_business_links": [
                "[Max Depth Exceeded]"
              ],
              "contact_info": [
                "[Max Depth Exceeded]"
              ],
              "check_url": null,
              "last_updated_time": null,
              "first_seen": null,
              "services": [
                "[Max Depth Exceeded]"
              ]
            }
          ]
        }
      ]
    }
  ]
}

Úspěšná operace

Úlohy vyhledávání živých firemních záznamů

OvěřováníRequired

DataForSEO

Úlohy vyhledávání živých firemních záznamů

Referenční ceny