v0.2.0-beta

OpenAPI 3.1.0

Pobieranie wyników Google My Business Info według id

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

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

Pobieranie wyników Google My Business Info według id

Pobiera z kolejki wyszukanie profilu Google Business Profile według id. Odpowiedź jest opakowana w kopertę DataForSEO: dane w tasks[0].result, wynik w tasks[0].status_code — odrzucone żądanie nadal zwraca HTTP 200. Odpowiedź jest opakowana w kopertę DataForSEO: dane w tasks[0].result, wynik w tasks[0].status_code — odrzucone żądanie nadal zwraca HTTP 200. ⚠️ Rozmiar odpowiedzi został ustalony przez depth lub limit ustawiony przy zgłoszeniu i nie można go tutaj zawęzić; jeśli jest zbyt duży, zgłoś zadanie z mniejszym zakresem zamiast stronicować.

Informacje o cenach

Rozliczanie: zgłoszony koszt odpowiedzi.
Referencyjny szacunek kosztu żądania: USD 0.012.
Referencyjny mnożnik klienta: 1.0. Nie stosuj go ponownie do rozliczonej kwoty klienta.

Wyłącznie metadane referencyjne — nie oferta dla konta, nie gwarantowana cena ani limit wydatków. Kredyty zasobów nie są kredytami Felo. Ostateczne obciążenia są zgodne z zapisami rozliczeniowymi Felo.

Parametry ścieżki

id
Typ: string
wymagane

identyfikator zadania
unikalny identyfikator zadania w naszym systemie w formacie UUID
można go używać przez 30 dni, aby w dowolnym momencie pobrać wyniki zadania

Odpowiedzi

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

check_url
Typ: string | null

bezpośredni adres URL do wyników wyszukiwarki
możesz go użyć, aby upewnić się, że dostarczyliśmy dokładne wyniki

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

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

typy elementów
typy wyników wyszukiwania napotkane w tablicy items;
możliwe typy elementów: google_business_info

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

tablica elementów katalogu

additional_categories
Typ: array string[] | null

dodatkowe kategorie działalności
dodatkowe kategorie Google My Business, które bardziej szczegółowo opisują usługi świadczone przez podmiot gospodarczy

address
Typ: string | null

adres podmiotu gospodarczego

address_info
Typ: object | null · Response36Afe1097B20_AddressInfo

obiekt zawierający składniki adresu podmiotu gospodarczego

address
Typ: string | null

adres ulicy lokalnego obiektu

borough
Typ: string | null

jednostka administracyjna lub dzielnica, do której należy lokalny obiekt

city
Typ: string | null

nazwa miasta, w którym znajduje się lokalny obiekt

country_code
Typ: string | null

kod kraju ISO lokalnego obiektu

region
Typ: string | null

region DMA, do którego należy lokalny obiekt

zip
Typ: string | null

kod pocztowy lokalnego obiektu

attributes
Typ: object | null · Response36Afe1097B20_BusinessDataAttributesInfo

szczegóły usług w formie kontroli ocenianych przez użytkowników;
szczegóły usług podmiotu gospodarczego wyświetlane w formie kontroli i oparte na opiniach użytkowników oraz category firmy

available_attributes
Typ: object | null

dostępne atrybuty
wskazuje atrybuty, które może oferować podmiot gospodarczy

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

niedostępne atrybuty
wskazuje atrybuty, których podmiot gospodarczy nie może oferować

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

adres URL w przycisku „book online” elementu
adres URL kierujący użytkowników do strony rezerwacji online lub zamówień podmiotu gospodarczego

category
Typ: string | null

kategoria działalności
ogólna kategoria Google My Business, która najlepiej opisuje usługi świadczone przez podmiot gospodarczy

category_ids
Typ: array string[] | null

globalne identyfikatory kategorii
uniwersalne identyfikatory kategorii, które nie zmieniają się w zależności od wybranego kraju

cid
Typ: string | null

identyfikator klienta zdefiniowany przez Google
unikalny identyfikator lokalu;
można go używać z Google Reviews API, aby uzyskać pełną listę opinii
więcej o identyfikatorze w tym artykule Centrum pomocy

contact_url
Typ: string | null

adres URL preferowanej strony kontaktowej

contributor_url
Typ: string | null

adres URL profilu Local Guides użytkownika lub podmiotu, jeśli jest dostępny

description
Typ: string | null

opis elementu w SERP
opis podmiotu gospodarczego, dla którego zbierane są wyniki

directory
Typ: object | null · Response36Afe1097B20_BusinessDirectoryInfo

elementy katalogu
zawiera informacje o firmach znajdujących się w docelowym podmiocie gospodarczym i mających ten sam adres

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

napotkane typy elementów
typy wyników wyszukiwania napotkane w tablicy items;
możliwe typy elementów: google_business_info

additional_categories
Typ: array string[] | null

dodatkowe kategorie działalności
dodatkowe kategorie Google My Business, które bardziej szczegółowo opisują usługi świadczone przez podmiot gospodarczy

address
Typ: string | null

adres podmiotu gospodarczego

address_info
Typ: object | null · Response36Afe1097B20_AddressInfo

obiekt zawierający składniki adresu podmiotu gospodarczego

address
Typ: string | null

adres ulicy lokalnego obiektu

borough
Typ: string | null

jednostka administracyjna lub dzielnica, do której należy lokalny obiekt

city
Typ: string | null

nazwa miasta, w którym znajduje się lokalny obiekt

country_code
Typ: string | null

kod kraju ISO lokalnego obiektu

region
Typ: string | null

region DMA, do którego należy lokalny obiekt

zip
Typ: string | null

kod pocztowy lokalnego obiektu

category
Typ: string | null

kategoria działalności
ogólna kategoria Google My Business, która najlepiej opisuje usługi świadczone przez podmiot gospodarczy

category_ids
Typ: array string[] | null

globalne identyfikatory kategorii
uniwersalne identyfikatory kategorii, które nie zmieniają się w zależności od wybranego kraju

cid
Typ: string | null

identyfikator klienta zdefiniowany przez Google
unikalny identyfikator lokalu;
można go używać z Google Reviews API, aby uzyskać pełną listę opinii
więcej o identyfikatorze w tym artykule Centrum pomocy

domain
Typ: string | null

domena podmiotu gospodarczego

feature_id
Typ: string | null

unikalny identyfikator elementu w SERP
więcej o identyfikatorze w tym artykule Centrum pomocy

hotel_rating
Typ: string | null

klasa hotelu
klasy mieszczą się w zakresie od 1 do 5 gwiazdek, dowiedz się więcej
jeśli brak informacji o klasie hotelu, wartością będzie null

is_claimed
Typ: boolean | null

wskazuje, czy podmiot został zweryfikowany przez właściciela w Google Maps

is_directory_item
Typ: boolean | null

podmiot gospodarczy jest częścią katalogu
wskazuje, czy podmiot gospodarczy jest częścią katalogu;
jeśli true, element jest częścią większego katalogu firm o tym samym adresie (np. centrum handlowego lub biurowca);
uwaga: jeśli podmiot gospodarczy jest elementem nadrzędnym w katalogu, wartością będzie null

latitude
Typ: number | null

współrzędna szerokości geograficznej lokali w Mapach Google
przykład:
"latitude": 51.584091

local_justifications
Typ: array string[] | null

lokalne uzasadnienia Google
fragmenty tekstu, które „uzasadniają”, dlaczego firma pojawia się w wynikach wyszukiwania dla zapytania

longitude
Typ: number | null

współrzędna długości geograficznej lokalu w Mapach Google
przykład:
"longitude": -0.31365919999999997

main_image
Typ: string | null

adres URL głównego obrazu w profilu Google My Business

phone
Typ: string | null

numer telefonu podmiotu gospodarczego

place_id
Typ: string | null

unikalny identyfikator miejsca
place id lokalu przedstawionego w elemencie
więcej o identyfikatorze przeczytasz w tym artykule centrum pomocy

price_level
Typ: string | null

poziom cen lokalu
może przyjmować wartości: inexpensive, moderate, expensive, very_expensive
jeśli brak informacji o poziomie cen, wartością będzie null

rank_absolute
Typ: integer | null

bezwzględna pozycja wśród wszystkich elementów

rank_group
Typ: integer | null

pozycja w grupie elementów o identycznych wartościach type
pozycje elementów o innych wartościach type są pomijane w rank_group

rating
Typ: object | null · Response36Afe1097B20_RatingInfo

ocena elementu
wskaźnik popularności oparty na opiniach, wyświetlany w SERP

rating_max
Typ: integer | null

maksymalna wartość dla rating_type

rating_type
Typ: string | null

typ oceny tutaj znajdziesz następujące elementy: Max5, Percents, CustomMax

value
Typ: number | null Format: double

wartość oceny

votes_count
Typ: integer | null Format: int64

liczba opinii

rating_distribution
Typ: object | null

rozkład ocen podmiotu gospodarczego obiekt pokazuje liczbę ocen od 1 do 5 gwiazdek przyznanych przez użytkowników

propertyName
Typ: integer | null Format: Int64
snippet
Typ: string | null

dodatkowe informacje o podmiocie gospodarczym

title
Typ: string | null

tytuł katalogu
może przyjmować następujące wartości: At this place, Directory

total_photos
Typ: string | null Format: int64

łączna liczba obrazów w profilu Google My Business

type
Typ: string | null

typ elementu

url
Typ: string | null

URL do wyświetlenia menu

work_hours
Typ: object | null · Response36Afe1097B20_BusinessWorkHoursInfo

godziny otwarcia
informacje o godzinach pracy lokalu

work_hours
Typ: object | null · Response36Afe1097B20_WorkHours

godziny otwarcia
informacje o godzinach pracy lokalu

current_status
Typ: string | null

bieżący status obiektu
wskazuje, czy obiekt jest otwarty, czy zamknięty

timetable
Typ: object | null

harmonogram godzin pracy

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

godziny pracy w niedziele

close
Typ: object | null · Response36Afe1097B20_TimeInfo

godzina zamknięcia

hour
Typ: integer | null

godziny w formacie 24-godzinnym

minute
Typ: integer | null

minuty

open
Typ: object | null · Response36Afe1097B20_TimeInfo

godzina otwarcia

hour
Typ: integer | null

godziny w formacie 24-godzinnym

minute
Typ: integer | null

minuty

title
Typ: string | null

tytuł elementu
domena internetowego systemu menu

domain
Typ: string | null

domena podmiotu gospodarczego

feature_id
Typ: string | null

unikalny identyfikator elementu w SERP
więcej o identyfikatorze w tym artykule Centrum pomocy

hotel_rating
Typ: number | null

klasa hotelu
klasy mieszczą się w zakresie od 1 do 5 gwiazdek, dowiedz się więcej
jeśli brak informacji o klasie hotelu, wartością będzie null

is_claimed
Typ: boolean | null

wskazuje, czy podmiot został zweryfikowany przez właściciela w Google Maps

is_directory_item
Typ: boolean | null

podmiot gospodarczy jest częścią katalogu
wskazuje, czy podmiot gospodarczy jest częścią katalogu;
jeśli true, element jest częścią większego katalogu firm o tym samym adresie (np. centrum handlowego lub biurowca);
uwaga: jeśli podmiot gospodarczy jest elementem nadrzędnym w katalogu, wartością będzie null

latitude
Typ: number | null

współrzędna szerokości geograficznej lokali w Mapach Google
przykład:
"latitude": 51.584091

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

dostępne interakcje z firmą
lista opcji interakcji z firmą bezpośrednio z wyników wyszukiwania

type
Typ: string | null

typ elementu

logo
Typ: string | null

adres URL logo wyświetlanego w profilu Google My Business

longitude
Typ: number | null

współrzędna długości geograficznej lokalu w Mapach Google
przykład:
"longitude": -0.31365919999999997

main_image
Typ: string | null

adres URL głównego obrazu w profilu Google My Business

original_title
Typ: string | null

oryginalny tytuł elementu
oryginalny tytuł nieprzetłumaczony przez Google

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

powiązane podmioty gospodarcze

cid
Typ: string | null

identyfikator klienta definiowany przez Google
unikalny identyfikator lokalu
więcej o tym identyfikatorze znajdziesz w tym artykule Centrum pomocy

feature_id
Typ: string | null

unikalny identyfikator elementu w SERP
więcej o identyfikatorze w tym artykule Centrum pomocy

rating
Typ: object | null · Response36Afe1097B20_RatingInfo

ocena elementu
wskaźnik popularności oparty na opiniach, wyświetlany w SERP

rating_max
Typ: integer | null

maksymalna wartość dla rating_type

rating_type
Typ: string | null

typ oceny tutaj znajdziesz następujące elementy: Max5, Percents, CustomMax

value
Typ: number | null Format: double

wartość oceny

votes_count
Typ: integer | null Format: int64

liczba opinii

title
Typ: string | null

tytuł elementu w SERP
nazwa podmiotu gospodarczego, dla którego zbierane są wyniki

phone
Typ: string | null

numer telefonu podmiotu gospodarczego

place_id
Typ: string | null

unikalny identyfikator miejsca
place id lokalu przedstawionego w elemencie
więcej o identyfikatorze przeczytasz w tym artykule centrum pomocy

place_topics
Typ: object | null

słowa kluczowe wymieniane w opiniach klientów
zawiera najpopularniejsze słowa kluczowe związane z produktami/usługami wymienianymi w opiniach klientów podmiotu gospodarczego oraz liczbę opinii, w których występuje każde słowo kluczowe
przykład:"place_topics": { "egg roll": 48, "birthday": 33 }

propertyName
Typ: integer | null Format: int64

Signed 64-bit integers (long type).

popular_times
Typ: object | null · Response36Afe1097B20_PopularTimes

godziny największego ruchu
informacje o godzinach wzmożonego ruchu w podmiocie gospodarczym

popular_times_by_days
Typ: object | null

popularne godziny
informacje o godzinach wzmożonego ruchu w lokalu w każdym dniu tygodnia

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

godziny pracy w niedziele

popular_index
Typ: integer | null

wskaźnik popularności względny wskaźnik popularności w czasie, mierzony od 0 do 100; wyższa wartość odpowiada większemu ruchowi o danej porze dnia

time
Typ: object | null · Response36Afe1097B20_TimeInfo

godziny w formacie 24-godzinnym

hour
Typ: integer | null

godziny w formacie 24-godzinnym

minute
Typ: integer | null

minuty

position
Typ: string | null

wyrównanie w SERP

price_level
Typ: string | null

poziom cen lokalu
może przyjmować wartości: inexpensive, moderate, expensive, very_expensive
jeśli brak informacji o poziomie cen, wartością będzie null

questions_and_answers_count
Typ: integer | null

Integer numbers.

rank_absolute
Typ: integer | null

bezwzględna pozycja wśród wszystkich elementów

rank_group
Typ: integer | null

pozycja w grupie elementów o identycznych wartościach type
pozycje elementów o różnych wartościach type są pomijane w rank_group

rating
Typ: object | null · Response36Afe1097B20_RatingInfo

ocena elementu
wskaźnik popularności oparty na opiniach, wyświetlany w SERP

rating_max
Typ: integer | null

maksymalna wartość dla rating_type

rating_type
Typ: string | null

typ oceny tutaj znajdziesz następujące elementy: Max5, Percents, CustomMax

value
Typ: number | null Format: double

wartość oceny

votes_count
Typ: integer | null Format: int64

liczba opinii

rating_distribution
Typ: object | null

rozkład ocen podmiotu gospodarczego
obiekt pokazuje liczbę ocen od 1 do 5 gwiazdek wystawionych przez użytkowników

propertyName
Typ: integer | null Format: Int64
services
Typ: array (object | null)[] | null

lista usług oferowanych przez firmę

category
Typ: string | null

kategoria działalności
ogólna kategoria Google My Business, która najlepiej opisuje usługi świadczone przez podmiot gospodarczy

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

waluta podanej ceny kod ISO waluty zastosowanej do ceny

current
Typ: number | null Format: double

bieżąca cena wskazuje bieżącą cenę produktu lub usługi prezentowanej w wyniku

displayed_price
Typ: string | null

ciąg ceny w wyniku surowy ciąg ceny w postaci dostarczonej w wyniku

is_price_range
Typ: boolean | null

cena podana jako zakres wskazuje, czy cena jest podana w formie zakresu

max_value
Typ: number | null Format: double

maksymalna cena maksymalna cena produktu lub usługi wskazana w wyniku

regular
Typ: number | null Format: double

cena regularna wskazuje cenę regularną produktu lub usługi bez zastosowanych rabatów

snippet
Typ: string | null

dodatkowe informacje o podmiocie gospodarczym

title
Typ: string | null

tytuł elementu w SERP
nazwa podmiotu gospodarczego, dla którego zbierane są wyniki

snippet
Typ: string | null

dodatkowe informacje o podmiocie gospodarczym

title
Typ: string | null

tytuł elementu w SERP
nazwa podmiotu gospodarczego, dla którego zbierane są wyniki

total_photos
Typ: integer | null Format: int64

łączna liczba obrazów w profilu Google My Business

type
Typ: string | null

typ elementu

url
Typ: string | null

bezwzględny URL podmiotu gospodarczego

work_time
Typ: object | null · Response36Afe1097B20_BusinessWorkHoursInfo

szczegóły godzin pracy
informacje o godzinach działania podmiotu gospodarczego

work_hours
Typ: object | null · Response36Afe1097B20_WorkHours

godziny otwarcia
informacje o godzinach pracy lokalu

current_status
Typ: string | null

bieżący status obiektu
wskazuje, czy obiekt jest otwarty, czy zamknięty

timetable
Typ: object | null

harmonogram godzin pracy

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

godziny pracy w niedziele

close
Typ: object | null · Response36Afe1097B20_TimeInfo

godzina zamknięcia

hour
Typ: integer | null

godziny w formacie 24-godzinnym

minute
Typ: integer | null

minuty

open
Typ: object | null · Response36Afe1097B20_TimeInfo

godzina otwarcia

hour
Typ: integer | null

godziny w formacie 24-godzinnym

minute
Typ: integer | null

minuty

items_count
Typ: integer | null Format: int64

typy elementów
liczba elementów w tablicy items

keyword
Typ: string | null

słowo kluczowe otrzymane w tablicy POST
słowo kluczowe jest zwracane z odkodowanym %## (znak plus '+' zostanie odkodowany jako spacja)
to pole będzie zawierać parametr cid, jeśli podasz go w polu keyword podczas ustawiania zadania;
przykład:
cid:2946633002421908862
więcej o parametrze znajdziesz w tym artykule Centrum Pomocy

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 podana w tablicy POST

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

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'

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

Operacja zakończona powodzeniem

Pobieranie wyników Google My Business Info według id

UwierzytelnianieRequired

DataForSEO

Pobieranie wyników Google My Business Info według id

Informacje o cenach