v0.2.0-beta

OpenAPI 3.1.0

Získání výsledků Google My Business Info podle id

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

get/v1/beta/dataforseo/business_data/google/my_business_info/task_get/{id}

Získání výsledků Google My Business Info podle id

Načte z fronty vyhledání profilu Google Business Profile podle id. 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. 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. ⚠️ Velikost odpovědi byla určena parametrem depth nebo limitem nastaveným při odeslání a zde ji nelze zúžit; pokud je příliš velká, odešlete menší úlohu místo stránkování.

Referenční ceny

Účtování: vykázaná cena odpovědi.
Referenční odhad ceny požadavku: USD 0.012.
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.

Parametry cesty

id
Typ: string
povinné

identifikátor úlohy
jedinečný identifikátor úlohy v našem systému ve formátu UUID
můžete jej po dobu 30 dní kdykoli použít k vyžádání výsledků úlohy

Odpovědi

200
Typ: object | null · Response36Afe1097B20_BusinessDataGoogleMyBusinessInfoTaskGetResponseInfo
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_BusinessDataGoogleMyBusinessInfoTaskGetTaskInfo
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ů

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

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

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

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

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

pole položek katalogu

additional_categories
Typ: array string[] | 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
book_online_url
Typ: string | null

adresa URL v tlačítku „book online” prvku
adresa URL vedoucí uživatele na stránku online rezervace nebo objednávky podnikatelského subjektu

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

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

cid
Typ: string | null

klientské ID definované Googlem
jedinečné ID místní provozovny;
lze jej použít s Google Reviews API k získání úplného seznamu recenzí
více o identifikátoru v tomto článku nápovědy

contact_url
Typ: string | null

adresa URL preferované kontaktní stránky

contributor_url
Typ: string | null

adresa URL profilu Local Guides uživatele nebo subjektu, pokud je k dispozici

description
Typ: string | null

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

directory
Typ: object | null · Response36Afe1097B20_BusinessDirectoryInfo

položky adresáře
obsahuje informace o podnicích, které se nacházejí v cílové provozovně a mají stejnou adresu

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

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

additional_categories
Typ: array string[] | 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

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

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

cid
Typ: string | null

klientské ID definované Googlem
jedinečné ID místní provozovny;
lze jej použít s Google Reviews API k získání úplného seznamu recenzí
více o identifikátoru v tomto článku nápovědy

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

hotel_rating
Typ: string | 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

is_directory_item
Typ: boolean | null

provozovna je součástí adresáře
udává, zda je provozovna součástí adresáře;
pokud je true, položka je součástí většího adresáře podniků se stejnou adresou (např. nákupního centra nebo kancelářské budovy);
poznámka: pokud je provozovna v adresáři nadřazenou položkou, hodnota bude null

latitude
Typ: number | null

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

local_justifications
Typ: array string[] | null

místní zdůvodnění Google
úryvky textu, které „zdůvodňují”, proč se firma zobrazuje pro vyhledávací dotaz

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

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

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

rank_absolute
Typ: integer | null

absolutní pořadí mezi všemi prvky

rank_group
Typ: integer | null

pozice ve skupině prvků se shodnými hodnotami type
pozice prvků s jinými hodnotami type se v rank_group vynechávají

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

rating_distribution
Typ: object | null

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

propertyName
Typ: integer | null Formát: Int64
snippet
Typ: string | null

dodatečné informace o obchodním subjektu

title
Typ: string | null

název adresáře
může nabývat následujících hodnot: At this place, Directory

total_photos
Typ: string | null Formát: int64

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

type
Typ: string | null

typ prvku

url
Typ: string | null

URL pro zobrazení menu

work_hours
Typ: object | null · Response36Afe1097B20_BusinessWorkHoursInfo

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

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

title
Typ: string | null

název prvku
doména online systému menu

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

hotel_rating
Typ: number | 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

is_directory_item
Typ: boolean | null

provozovna je součástí adresáře
udává, zda je provozovna součástí adresáře;
pokud je true, položka je součástí většího adresáře podniků se stejnou adresou (např. nákupního centra nebo kancelářské budovy);
poznámka: pokud je provozovna v adresáři nadřazenou položkou, hodnota bude null

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

position
Typ: string | null

zarovnání v SERP

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

questions_and_answers_count
Typ: integer | null

Integer numbers.

rank_absolute
Typ: integer | null

absolutní pořadí mezi všemi prvky

rank_group
Typ: integer | null

pozice ve skupině prvků se shodnými hodnotami type
pozice prvků s odlišnými hodnotami type se v rank_group vynechávají

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

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

seznam služeb nabízených podnikem

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

items_count
Typ: integer | null Formát: int64

typy prvků
počet prvků v poli items

keyword
Typ: string | null

klíčové slovo obdržené v poli POST
klíčové slovo se vrací s dekódovaným %## (znak plus '+' bude dekódován jako mezera)
toto pole bude obsahovat parametr cid, pokud jej zadáte v poli keyword při nastavování úlohy;
příklad:
cid:2946633002421908862
více o parametru najdete v tomto článku nápovědy

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 zadaná v poli POST

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

get/v1/beta/dataforseo/business_data/google/my_business_info/task_get/{id}

curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/my_business_info/task_get/00000000-0000-0000-0000-000000000000 \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

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,
          "se_domain": null,
          "location_code": null,
          "language_code": null,
          "check_url": null,
          "datetime": null,
          "item_types": [
            null
          ],
          "items_count": null,
          "items": [
            {
              "type": null,
              "rank_group": null,
              "rank_absolute": null,
              "position": 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,
              "contact_url": null,
              "contributor_url": null,
              "book_online_url": null,
              "domain": null,
              "logo": null,
              "main_image": null,
              "total_photos": null,
              "snippet": null,
              "latitude": null,
              "longitude": null,
              "is_claimed": null,
              "questions_and_answers_count": null,
              "attributes": "[Max Depth Exceeded]",
              "place_topics": null,
              "rating": "[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]"
              ],
              "is_directory_item": null,
              "directory": "[Max Depth Exceeded]",
              "services": [
                "[Max Depth Exceeded]"
              ]
            }
          ]
        }
      ]
    }
  ]
}

Úspěšná operace

Získání výsledků Google My Business Info podle id

OvěřováníRequired

DataForSEO

Získání výsledků Google My Business Info podle id

Referenční ceny