v0.2.0-beta

OpenAPI 3.1.0

Google My Business-info: resultaten op id ophalen

Felo API Support

MIT

Server

https://openapi.felo.ai

Clientbibliotheken

Shell Curl

DataForSEO

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

DataForSEO Operaties

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

Google My Business-info: resultaten op id ophalen

Haalt een Google-bedrijfsprofiel-lookup uit de wachtrij op basis van id op. Verpakt in de DataForSEO-envelop: data in tasks[0].result, uitkomst in tasks[0].status_code; een geweigerd verzoek retourneert nog steeds HTTP 200. Verpakt in de DataForSEO-envelop: data in tasks[0].result, uitkomst in tasks[0].status_code; een geweigerd verzoek retourneert nog steeds HTTP 200. ⚠️ De responsgrootte is vastgelegd door de depth of limiet die bij het indienen is ingesteld en kan hier niet worden beperkt; is die te groot, dien dan kleiner opnieuw in in plaats van te pagineren.

Prijsreferentie

Afrekening: gerapporteerde responskosten.
Referentieschatting per verzoek: USD 0.012.
Referentiemultiplier voor klanten: 1.0. Niet opnieuw toepassen op een al afgerekend klantbedrag.

Alleen referentiemetadata, geen accountofferte en geen gegarandeerde prijs of bestedingslimiet. Resourcecredits zijn geen Felo-tegoed. De uiteindelijke kosten volgen de factureringsgegevens van Felo.

Padparameters

id
Type: string
verplicht

taak-ID
unieke taak-ID in ons systeem in UUID-formaat
je kunt deze 30 dagen lang gebruiken om op elk moment de resultaten van de taak op te vragen

Responsen

200
Type: object | null · Response36Afe1097B20_BusinessDataGoogleMyBusinessInfoTaskGetResponseInfo
cost
Type: number | null Formaat: double

Totale kosten van taken, USD

status_code
Type: integer | null

algemene statuscode de volledige lijst met responscodes vindt u hier

status_message
Type: string | null

algemeen informatief bericht de volledige lijst met algemene informatieve berichten vindt u hier

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

array van taken

Type: object | null · Response36Afe1097B20_BusinessDataGoogleMyBusinessInfoTaskGetTaskInfo
cost
Type: number | null Formaat: double

Totale kosten van taken, USD

data
Type: object | null

Bevat dezelfde parameters die je in het POST-verzoek hebt opgegeven

propertyName
Type: object | null
id
Type: string | null

taak-id eenduidige taak-id in ons systeem in UUID-indeling

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

URL-pad

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

array van resultaten

check_url
Type: string | null

directe URL naar zoekmachineresultaten
u kunt deze gebruiken om te controleren of we nauwkeurige resultaten hebben geleverd

datetime
Type: string | null

datum en tijd waarop het resultaat is ontvangen
in UTC-indeling: “yyyy-mm-dd hh-mm-ss +00:00”
voorbeeld:
2019-11-15 12:57:46 +00:00

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

itemtypen
typen zoekresultaten die in de array items voorkomen;
mogelijke itemtypen: google_business_info

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

array met directory-items

additional_categories
Type: array string[] | null

aanvullende bedrijfscategorieën
aanvullende Google My Business-categorieën die de door de bedrijfsentiteit geleverde diensten gedetailleerder beschrijven

address
Type: string | null

adres van het bedrijf

address_info
Type: object | null · Response36Afe1097B20_AddressInfo

object met de adrescomponenten van het bedrijf

address
Type: string | null

straatadres van de lokale vestiging

borough
Type: string | null

administratieve eenheid of district waartoe de lokale vestiging behoort

city
Type: string | null

naam van de stad waar de lokale vestiging is gelegen

country_code
Type: string | null

ISO-landcode van de lokale vestiging

region
Type: string | null

DMA-regio waartoe de lokale vestiging behoort

zip
Type: string | null

postcode van de lokale vestiging

attributes
Type: object | null · Response36Afe1097B20_BusinessDataAttributesInfo

dienstgegevens in de vorm van door gebruikers beoordeelde controles;
dienstgegevens van een bedrijf, weergegeven in de vorm van controles en gebaseerd op gebruikersfeedback en de category van het bedrijf

available_attributes
Type: object | null

beschikbare attributen
geeft de attributen aan die een bedrijfsentiteit kan aanbieden

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

niet-beschikbare attributen
geeft de attributen aan die een bedrijfsentiteit niet kan aanbieden

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

URL in de knop 'book online' van het element
URL die gebruikers naar de online boekings- of bestelpagina van de bedrijfsentiteit leidt

category
Type: string | null

bedrijfscategorie
algemene Google My Business-categorie die de door de bedrijfsentiteit geleverde diensten het beste beschrijft

category_ids
Type: array string[] | null

wereldwijde categorie-id's
universele categorie-id's die niet veranderen op basis van het geselecteerde land

cid
Type: string | null

door Google gedefinieerde client-id
unieke id van een lokale vestiging;
kan met de Google Reviews API worden gebruikt om een volledige lijst met reviews op te halen
lees meer over de identificatie in dit Help Center-artikel

contact_url
Type: string | null

URL van de voorkeurscontactpagina

contributor_url
Type: string | null

URL van het Local Guides-profiel van de gebruiker of entiteit, indien beschikbaar

description
Type: string | null

beschrijving van het element in SERP
de beschrijving van het bedrijf waarvoor de resultaten worden verzameld

directory
Type: object | null · Response36Afe1097B20_BusinessDirectoryInfo

items van de directory
bevat informatie over bedrijven die zich binnen de doelvestiging bevinden en hetzelfde adres hebben

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

aangetroffen itemtypen
typen zoekresultaten die in de array items voorkomen;
mogelijke itemtypen: google_business_info

additional_categories
Type: array string[] | null

aanvullende bedrijfscategorieën
aanvullende Google My Business-categorieën die de door de bedrijfsentiteit geleverde diensten gedetailleerder beschrijven

address
Type: string | null

adres van het bedrijf

address_info
Type: object | null · Response36Afe1097B20_AddressInfo

object met de adrescomponenten van het bedrijf

address
Type: string | null

straatadres van de lokale vestiging

borough
Type: string | null

administratieve eenheid of district waartoe de lokale vestiging behoort

city
Type: string | null

naam van de stad waar de lokale vestiging is gelegen

country_code
Type: string | null

ISO-landcode van de lokale vestiging

region
Type: string | null

DMA-regio waartoe de lokale vestiging behoort

zip
Type: string | null

postcode van de lokale vestiging

category
Type: string | null

bedrijfscategorie
algemene Google My Business-categorie die de door de bedrijfsentiteit geleverde diensten het beste beschrijft

category_ids
Type: array string[] | null

wereldwijde categorie-id's
universele categorie-id's die niet veranderen op basis van het geselecteerde land

cid
Type: string | null

door Google gedefinieerde client-id
unieke id van een lokale vestiging;
kan met de Google Reviews API worden gebruikt om een volledige lijst met reviews op te halen
lees meer over de identificatie in dit Help Center-artikel

domain
Type: string | null

domein van de bedrijfsentiteit

feature_id
Type: string | null

de unieke identificatie van het element in SERP
lees meer over de identificatie in dit Help Center-artikel

hotel_rating
Type: string | null

sterrenclassificatie van het hotel
de classificatie loopt van 1 tot 5 sterren, meer informatie
als er geen informatie over de sterrenclassificatie van het hotel is, is de waarde null

is_claimed
Type: boolean | null

geeft aan of het bedrijf door de eigenaar is geverifieerd in Google Maps

is_directory_item
Type: boolean | null

de vestiging maakt deel uit van de directory
geeft aan of de vestiging deel uitmaakt van de directory;
als true, maakt het item deel uit van de grotere directory van bedrijven met hetzelfde adres (bijv. een winkelcentrum of een bedrijfscentrum);
opmerking: als de vestiging een bovenliggend item in de directory is, is de waarde null

latitude
Type: number | null

breedtegraadcoördinaat van de lokale vestigingen in Google Maps
voorbeeld:
"latitude": 51.584091

local_justifications
Type: array string[] | null

lokale onderbouwingen van Google
tekstfragmenten die “onderbouwen” waarom het bedrijf voor de zoekopdracht wordt getoond

longitude
Type: number | null

lengtegraadcoördinaat van de lokale vestiging in Google Maps
voorbeeld:
"longitude": -0.31365919999999997

main_image
Type: string | null

URL van de hoofdafbeelding in het Google My Business-profiel

phone
Type: string | null

telefoonnummer van de bedrijfsentiteit

place_id
Type: string | null

unieke locatie-identificatie
place-ID van de lokale vestiging in het element
meer informatie over de identificatie vind je in dit artikel in het helpcentrum

price_level
Type: string | null

prijsniveau van het object
mogelijke waarden: inexpensive, moderate, expensive, very_expensive
als er geen informatie over het prijsniveau is, is de waarde null

rank_absolute
Type: integer | null

absolute rang onder alle elementen

rank_group
Type: integer | null

positie binnen een groep elementen met identieke type-waarden
posities van elementen met andere type-waarden worden uit rank_group weggelaten

rating
Type: object | null · Response36Afe1097B20_RatingInfo

de beoordeling van het element
de populariteitsscore op basis van beoordelingen, weergegeven in de SERP

rating_max
Type: integer | null

de maximale waarde voor een rating_type

rating_type
Type: string | null

het type beoordeling hier vindt u de volgende elementen: Max5, Percents, CustomMax

value
Type: number | null Formaat: double

de waarde van de beoordeling

votes_count
Type: integer | null Formaat: int64

het aantal feedbacks

rating_distribution
Type: object | null

de verdeling van de beoordelingen van het bedrijf het object toont het aantal beoordelingen van 1 tot 5 sterren, zoals beoordeeld door gebruikers

propertyName
Type: integer | null Formaat: Int64
snippet
Type: string | null

aanvullende informatie over het bedrijf

title
Type: string | null

titel van de directory
kan de volgende waarden aannemen: At this place, Directory

total_photos
Type: string | null Formaat: int64

totaal aantal afbeeldingen in het Google My Business-profiel

type
Type: string | null

elementtype

url
Type: string | null

URL om het menu te bekijken

work_hours
Type: object | null · Response36Afe1097B20_BusinessWorkHoursInfo

openingstijden
informatie over de werktijden van de lokale vestiging

work_hours
Type: object | null · Response36Afe1097B20_WorkHours

openingstijden
informatie over de werktijden van de lokale vestiging

current_status
Type: string | null

huidige status van de vestiging
geeft aan of de vestiging geopend of gesloten is

timetable
Type: object | null

werktijdschema

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

werktijden op zondag

close
Type: object | null · Response36Afe1097B20_TimeInfo

sluitingstijd

hour
Type: integer | null

uren in 24-uursformaat

minute
Type: integer | null

minuten

open
Type: object | null · Response36Afe1097B20_TimeInfo

openingstijd

hour
Type: integer | null

uren in 24-uursformaat

minute
Type: integer | null

minuten

title
Type: string | null

titel van het element
domein van het online menusysteem

domain
Type: string | null

domein van de bedrijfsentiteit

feature_id
Type: string | null

de unieke identificatie van het element in SERP
lees meer over de identificatie in dit Help Center-artikel

hotel_rating
Type: number | null

sterrenclassificatie van het hotel
de classificatie loopt van 1 tot 5 sterren, meer informatie
als er geen informatie over de sterrenclassificatie van het hotel is, is de waarde null

is_claimed
Type: boolean | null

geeft aan of het bedrijf door de eigenaar is geverifieerd in Google Maps

is_directory_item
Type: boolean | null

de vestiging maakt deel uit van de directory
geeft aan of de vestiging deel uitmaakt van de directory;
als true, maakt het item deel uit van de grotere directory van bedrijven met hetzelfde adres (bijv. een winkelcentrum of een bedrijfscentrum);
opmerking: als de vestiging een bovenliggend item in de directory is, is de waarde null

latitude
Type: number | null

breedtegraadcoördinaat van de lokale vestigingen in Google Maps
voorbeeld:
"latitude": 51.584091

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

beschikbare interacties met het bedrijf
lijst met opties om rechtstreeks vanuit zoekresultaten met het bedrijf te communiceren

type
Type: string | null

elementtype

logo
Type: string | null

URL van het logo in het Google My Business-profiel

longitude
Type: number | null

lengtegraadcoördinaat van de lokale vestiging in Google Maps
voorbeeld:
"longitude": -0.31365919999999997

main_image
Type: string | null

URL van de hoofdafbeelding in het Google My Business-profiel

original_title
Type: string | null

oorspronkelijke titel van het element
oorspronkelijke titel, niet door Google vertaald

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

gerelateerde bedrijfsentiteiten

cid
Type: string | null

door Google gedefinieerde client-id
unieke id van een lokale vestiging
meer over de identificatie in dit helpcentrumartikel

feature_id
Type: string | null

de unieke identificatie van het element in SERP
lees meer over de identificatie in dit Help Center-artikel

rating
Type: object | null · Response36Afe1097B20_RatingInfo

de beoordeling van het element
de populariteitsscore op basis van beoordelingen, weergegeven in de SERP

rating_max
Type: integer | null

de maximale waarde voor een rating_type

rating_type
Type: string | null

het type beoordeling hier vindt u de volgende elementen: Max5, Percents, CustomMax

value
Type: number | null Formaat: double

de waarde van de beoordeling

votes_count
Type: integer | null Formaat: int64

het aantal feedbacks

title
Type: string | null

titel van het element in SERP
de naam van de bedrijfsentiteit waarvoor de resultaten worden verzameld

phone
Type: string | null

telefoonnummer van de bedrijfsentiteit

place_id
Type: string | null

unieke locatie-identificatie
place-ID van de lokale vestiging in het element
meer informatie over de identificatie vind je in dit artikel in het helpcentrum

place_topics
Type: object | null

keywords die in klantreviews worden genoemd
bevat de populairste keywords met betrekking tot producten/diensten die in klantreviews van een bedrijfsentiteit worden genoemd, en het aantal reviews dat elk keyword noemt
voorbeeld:"place_topics": { "egg roll": 48, "birthday": 33 }

propertyName
Type: integer | null Formaat: int64

Signed 64-bit integers (long type).

popular_times
Type: object | null · Response36Afe1097B20_PopularTimes

populaire tijden
informatie over de drukke uren van de bedrijfsentiteit

popular_times_by_days
Type: object | null

populaire uren
informatie over de drukke uren van de lokale vestiging op elke dag van de week

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

werktijden op zondag

popular_index
Type: integer | null

populariteitsindex relatieve, tijdsgebonden populariteitsindex van 0 tot 100; een hogere waarde komt overeen met een drukkere periode van de dag

time
Type: object | null · Response36Afe1097B20_TimeInfo

uren in 24-uursformaat

hour
Type: integer | null

uren in 24-uursformaat

minute
Type: integer | null

minuten

position
Type: string | null

de uitlijning in SERP

price_level
Type: string | null

prijsniveau van het object
mogelijke waarden: inexpensive, moderate, expensive, very_expensive
als er geen informatie over het prijsniveau is, is de waarde null

questions_and_answers_count
Type: integer | null

Integer numbers.

rank_absolute
Type: integer | null

absolute rang onder alle elementen

rank_group
Type: integer | null

positie binnen een groep elementen met identieke type-waarden
posities van elementen met verschillende type-waarden worden weggelaten uit rank_group

rating
Type: object | null · Response36Afe1097B20_RatingInfo

de beoordeling van het element
de populariteitsscore op basis van beoordelingen, weergegeven in de SERP

rating_max
Type: integer | null

de maximale waarde voor een rating_type

rating_type
Type: string | null

het type beoordeling hier vindt u de volgende elementen: Max5, Percents, CustomMax

value
Type: number | null Formaat: double

de waarde van de beoordeling

votes_count
Type: integer | null Formaat: int64

het aantal feedbacks

rating_distribution
Type: object | null

de verdeling van beoordelingen van de bedrijfsentiteit
het object toont het aantal beoordelingen van 1 tot 5 sterren, zoals beoordeeld door gebruikers

propertyName
Type: integer | null Formaat: Int64
services
Type: array (object | null)[] | null

lijst met diensten die het bedrijf aanbiedt

category
Type: string | null

bedrijfscategorie
algemene Google My Business-categorie die de door de bedrijfsentiteit geleverde diensten het beste beschrijft

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

valuta van de vermelde prijs ISO-code van de valuta die op de prijs wordt toegepast

current
Type: number | null Formaat: double

huidige prijs geeft de huidige prijs aan van het product of de dienst in het resultaat

displayed_price
Type: string | null

prijstekst in het resultaat onbewerkte prijstekst zoals die in het resultaat is opgegeven

is_price_range
Type: boolean | null

prijs wordt als bereik opgegeven geeft aan of een prijs als bereik wordt opgegeven

max_value
Type: number | null Formaat: double

de maximale prijs de maximale prijs van het product of de dienst zoals aangegeven in het resultaat

regular
Type: number | null Formaat: double

reguliere prijs geeft de reguliere prijs van het product of de dienst zonder kortingen aan

snippet
Type: string | null

aanvullende informatie over de bedrijfsentiteit

title
Type: string | null

titel van het element in SERP
de naam van de bedrijfsentiteit waarvoor de resultaten worden verzameld

snippet
Type: string | null

aanvullende informatie over de bedrijfsentiteit

title
Type: string | null

titel van het element in SERP
de naam van de bedrijfsentiteit waarvoor de resultaten worden verzameld

total_photos
Type: integer | null Formaat: int64

totaal aantal afbeeldingen in het Google My Business-profiel

type
Type: string | null

elementtype

url
Type: string | null

absolute URL van de bedrijfsentiteit

work_time
Type: object | null · Response36Afe1097B20_BusinessWorkHoursInfo

details over werktijden
informatie over de openingstijden van de bedrijfsentiteit

work_hours
Type: object | null · Response36Afe1097B20_WorkHours

openingstijden
informatie over de werktijden van de lokale vestiging

current_status
Type: string | null

huidige status van de vestiging
geeft aan of de vestiging geopend of gesloten is

timetable
Type: object | null

werktijdschema

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

werktijden op zondag

close
Type: object | null · Response36Afe1097B20_TimeInfo

sluitingstijd

hour
Type: integer | null

uren in 24-uursformaat

minute
Type: integer | null

minuten

open
Type: object | null · Response36Afe1097B20_TimeInfo

openingstijd

hour
Type: integer | null

uren in 24-uursformaat

minute
Type: integer | null

minuten

items_count
Type: integer | null Formaat: int64

itemtypen
het aantal items in de array items

keyword
Type: string | null

keyword ontvangen in een POST-array
het keyword wordt gedecodeerd geretourneerd (%##; het plusteken '+' wordt gedecodeerd naar een spatie)
dit veld bevat de parameter cid als u deze bij het instellen van een taak in het veld keyword hebt opgegeven;
voorbeeld:
cid:2946633002421908862
lees meer over de parameter in dit Help Center-artikel

language_code
Type: string | null

taalcode in een POST-array

location_code
Type: integer | null

locatiecode in een POST-array

se_domain
Type: string | null

zoekmachinedomein zoals opgegeven in een POST-array

result_count
Type: integer | null Formaat: int64

Aantal elementen in de result-array

status_code
Type: integer | null

statuscode van de taak gegenereerd door DataForSEO, kan binnen het volgende bereik liggen: 10000-60000 de volledige lijst met responscodes vindt u hier

status_message
Type: string | null

informatief bericht van de taak de volledige lijst met algemene informatieve berichten vindt u hier

time
Type: string | null

Uitvoeringstijd in seconden

tasks_count
Type: integer | null Formaat: int64

Het aantal taken in de tasks-array

tasks_error
Type: integer | null Formaat: int64

Het aantal taken in de tasks-array dat met een fout is geretourneerd

time
Type: string | null

totale uitvoeringstijd, seconden

version
Type: string | null

De huidige versie van de API
application/json
400

Het verzoek kon niet worden verwerkt. Controleer de verzoekparameters.
401

Een geldige Felo-API-sleutel is vereist.
402

Het verzoek kan niet doorgaan omdat niet aan een factureringsvoorwaarde is voldaan.
403

Het account mag deze bewerking niet uitvoeren.
429

Een verzoek- of bestedingslimiet is bereikt.
502

De dienst kon het verzoek niet voltooien.
503

De API of factureringsdienst is tijdelijk niet beschikbaar.
504

Er is een time-out opgetreden bij het verwerken van het verzoek.
default

Foutrespons; upstream-passthrough-responsen kunnen indelingen van de provider gebruiken

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'

Schema tonen

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

Geslaagde bewerking

Google My Business-info: resultaten op id ophalen

AuthenticatieRequired

DataForSEO

Google My Business-info: resultaten op id ophalen

Prijsreferentie