v0.2.0-beta

OpenAPI 3.1.0

Live: zoeken in bedrijfsvermeldingen

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

post/v1/beta/dataforseo/business_data/business_listings/search/live

Live: zoeken in bedrijfsvermeldingen

Doorzoekt de eigen index van lokale bedrijfsvermeldingen van DataForSEO op categories, description, title en location_coordinate: een drietal van breedtegraad, lengtegraad en straal. Retourneert total_count, count, offset, offset_token en items, gepagineerd met het token. Verpakt in de DataForSEO-envelop: data in tasks[0].result, uitkomst in tasks[0].status_code; een geweigerd verzoek retourneert nog steeds HTTP 200. Dit leest een index en antwoordt direct; al het andere hier zet een live scrape van de bron in de wachtrij. Begin hiermee en ga alleen dieper waar het ertoe doet.

Prijsreferentie

Afrekening: gerapporteerde responskosten.
Referentieschatting per verzoek: USD 0.2428.
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.

Body

application/json

Type: array (object | null)[]
- categories
  Type: array string[] | null
  
  bedrijfscategorieën
  optioneel veld
  de opgegeven categorieën worden gebruikt om bedrijfsvermeldingen te zoeken;
  als u dit veld niet gebruikt, retourneren we bedrijfsvermeldingen op de opgegeven locatie;
  u kunt maximaal 10 categorieën opgeven
- description
  Type: string | null
  
  beschrijving van het element in de SERP
  optioneel veld
  de beschrijving van de bedrijfsentiteit waarvoor de resultaten worden verzameld;
  maximaal 200 tekens
- filters
  Type: array (object | null)[] | null
  
  array met filterparameters voor resultaten
  optioneel veld
  u kunt meerdere filters tegelijk toevoegen (maximaal 8 filters)
  tussen de voorwaarden zet u een logische operator and of or
  de volgende operators worden ondersteund:
  regex, not_regex, <, <=, >, >=, =, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
  met de operator % in like en not_like kunt u elke tekenreeks van nul of meer tekens matchen
  voorbeeld:
  ["rating.value",">",3]
  de lijst met beschikbare filters ontvangt u via een afzonderlijk verzoek aan https://api.dataforseo.com/v3/business_data/business_listings/available_filters
  de volledige lijst met mogelijke filters vindt u hier.
  
  Leeg object
- is_claimed
  Type: boolean | null
  
  geeft aan of het bedrijf door de eigenaar is geverifieerd op Google Maps
  optioneel veld
- limit
  Type: integer | null
  
  het maximale aantal teruggegeven bedrijven
  optioneel veld
  standaardwaarde: 100
  maximale waarde: 1000
- location_coordinate
  Type: string | null
  
  GPS-coördinaten van een locatie
  optioneel veld
  de parameter location_coordinate moet in het formaat "latitude,longitude,radius" worden opgegeven
  het maximale aantal decimalen voor "latitude" en "longitude": 7
  de waarde van "radius" wordt in kilometers (km) opgegeven
  de minimale waarde voor "radius": 1
  de maximale waarde voor "radius": 100000
  voorbeeld:
  53.476225,-2.243572,200
  lees meer over het instellen van locatieparameters in deze API in ons Help Center
- offset
  Type: integer | null
  
  offset in de resultatenarray van teruggegeven bedrijven
  optioneel veld
  standaardwaarde: 0
  bij de waarde 10 worden de eerste tien entiteiten in de resultatenarray overgeslagen en worden de gegevens voor de volgende entiteiten geleverd
  let op: we raden aan deze parameter alleen te gebruiken bij het ophalen van maximaal 10.000 resultaten
  gebruik voor meer dan 10.000 resultaten in plaats daarvan offset_token
- offset_token
  Type: string | null
  
  token voor vervolgverzoeken
  optioneel veld
  wordt geleverd in het identieke veld van de respons op elk verzoek;
  gebruik deze parameter om time-outs te voorkomen bij het ophalen van meer dan 100.000 resultaten in één verzoek;
  door de unieke waarde van offset_token uit de responsarray op te geven, krijg je de vervolgresultaten van de oorspronkelijke taak;
  offset_token-waarden zijn uniek voor elke vervolgtaak
  Let op: als offset_token in het verzoek is opgegeven, moeten alle andere parameters identiek zijn aan die van het vorige verzoek
  meer informatie over deze parameter vind je in ons Help Center
- order_by
  Type: array string[] | null
  
  sorteerregels voor resultaten
  optioneel veld
  u kunt dezelfde waarden als in de array filters gebruiken om de resultaten te sorteren
  mogelijke sorteertypen:
  asc - resultaten worden oplopend gesorteerd
  desc - resultaten worden aflopend gesorteerd
  sorteertype en -richting scheidt u met een komma
  voorbeeld:
  ["rating.value,desc"]let op: u kunt per verzoek maximaal drie sorteerregels instellen
  meerdere sorteerregels scheidt u met een komma
  voorbeeld:
  ["rating.value,desc","rating.votes_count,desc"]
- tag
  Type: string | null
  
  door gebruiker gedefinieerde taak-ID
  optioneel veld
  de tekenslimiet is 255
  je kunt deze parameter gebruiken om de taak te identificeren en aan het resultaat te koppelen
  de opgegeven waarde tag vind je in het data-object van de respons
- title
  Type: string | null
  
  titel van het element in de SERP
  optioneel veld
  de naam van de bedrijfsentiteit waarvoor de resultaten worden verzameld;
  maximaal 200 tekens

Responsen

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

count
Type: integer | null Formaat: int64

itemtypen
het aantal items in de array items

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

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

additional_categories
Type: array (string | null)[] | 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
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)[] | null

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

check_url
Type: string | null

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

cid
Type: string | null

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

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

beschikbare contactgegevens van het bedrijf
lijst met contacten om contact op te nemen met het bedrijf

source
Type: string | null

gegevensbron

type
Type: string | null

elementtype

value
Type: string | null

de waarde van de beoordeling

description
Type: string | null

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

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

first_seen
Type: string | null

datum en tijd waarop onze crawler de bedrijfsvermelding voor het eerst heeft gevonden
in UTC-indeling: ‘yyyy-mm-dd hh-mm-ss +00:00’
voorbeeld:
2023-03-11 10:04:11 +00:00

hotel_rating
Type: integer | 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

last_updated_time
Type: string | null

datum en tijd waarop de gegevens voor het laatst zijn bijgewerkt
in UTC-indeling: ‘yyyy-mm-dd hh-mm-ss +00:00’
voorbeeld:
2023-01-26 09:03:15 +00:00

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

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

rating
Type: object | null · Response36Afe1097B20_RatingInfo

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

rating_max
Type: number | null Formaat: double

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
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

offset
Type: integer | null Formaat: int64

Signed 64-bit integers (long type).

offset_token
Type: string | null
total_count
Type: integer | null Formaat: int64

totaal aantal resultaten in onze database dat relevant is voor uw verzoek

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

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
  }
]'

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

Geslaagde bewerking

Live: zoeken in bedrijfsvermeldingen

AuthenticatieRequired

DataForSEO

Live: zoeken in bedrijfsvermeldingen

Prijsreferentie