v0.2.0-beta

OpenAPI 3.1.0

Live-Suche in Firmeneinträgen

Felo API Support

MIT

Server

https://openapi.felo.ai

Client-Bibliotheken

Shell Curl

DataForSEO

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

DataForSEO Operationen

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

Live-Suche in Firmeneinträgen

Durchsucht den eigenen Index lokaler Firmeneinträge von DataForSEO nach categories, description, title und location_coordinate – einem Tripel aus Breitengrad, Längengrad und Radius. Gibt total_count, count, offset, offset_token und items zurück, seitenweise über das Token. Eingebettet in das DataForSEO-Envelope: Daten in tasks[0].result, Ergebnis in tasks[0].status_code – eine abgelehnte Anfrage liefert weiterhin HTTP 200. Dies liest einen Index und antwortet sofort; alles andere hier stellt einen Live-Scrape der Quelle in die Warteschlange. Beginnen Sie hiermit und gehen Sie nur dort tiefer, wo es zählt.

Preisreferenz

Abrechnung: Gemeldete Antwortkosten.
Referenzschätzung pro Anfrage: USD 0.2428.
Referenz-Kundenmultiplikator: 1.0. Nicht erneut auf bereits abgerechnete Kundenbeträge anwenden.

Nur Referenzmetadaten, kein Kontenangebot und keine garantierte Preis- oder Ausgabenobergrenze. Ressourcen-Credits sind keine Felo-Credits. Endgültige Abrechnungen richten sich nach den Felo-Abrechnungsbelegen.

Body

application/json

Typ: array (object | null)[]
- categories
  Typ: array string[] | null
  
  Geschäftskategorien
  Optionales Feld
  die von Ihnen angegebenen Kategorien werden zur Suche nach Unternehmenseinträgen verwendet;
  ohne dieses Feld geben wir Unternehmenseinträge am angegebenen Standort zurück;
  Sie können bis zu 10 Kategorien angeben
- description
  Typ: string | null
  
  Beschreibung des Elements in der SERP
  Optionales Feld
  die Beschreibung des Geschäftsobjekts, für das die Ergebnisse erhoben werden;
  maximal 200 Zeichen
- filters
  Typ: array (object | null)[] | null
  
  Array der Filterparameter für Ergebnisse
  Optionales Feld
  Sie können mehrere Filter gleichzeitig hinzufügen (maximal 8 Filter)
  Zwischen den Bedingungen setzen Sie einen logischen Operator and oder or
  Die folgenden Operatoren werden unterstützt:
  regex, not_regex, <, <=, >, >=, =, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
  Mit dem Operator % in like und not_like können Sie beliebige Zeichenfolgen mit null oder mehr Zeichen abgleichen
  Beispiel:
  ["rating.value",">",3]
  Die Liste der verfügbaren Filter erhalten Sie durch eine separate Anfrage an https://api.dataforseo.com/v3/business_data/business_listings/available_filters
  Die vollständige Liste der möglichen Filter finden Sie hier.
  
  Leeres Objekt
- is_claimed
  Typ: boolean | null
  
  Gibt an, ob das Unternehmen von seinem Inhaber auf Google Maps verifiziert wurde
  Optionales Feld
- limit
  Typ: integer | null
  
  maximale Anzahl der zurückgegebenen Unternehmen
  Optionales Feld
  Standardwert: 100
  Höchstwert: 1000
- location_coordinate
  Typ: string | null
  
  GPS-Koordinaten eines Standorts
  Optionales Feld
  der Parameter location_coordinate muss im Format "latitude,longitude,radius" angegeben werden
  maximale Anzahl Dezimalstellen für "latitude" und "longitude": 7
  der Wert von "radius" wird in Kilometern (km) angegeben
  Mindestwert für "radius": 1
  Höchstwert für "radius": 100000
  Beispiel:
  53.476225,-2.243572,200
  Weitere Informationen zum Festlegen von Standortparametern in dieser API finden Sie in unserem Help Center
- offset
  Typ: integer | null
  
  Offset im Ergebnisarray der zurückgegebenen Unternehmen
  Optionales Feld
  Standardwert: 0
  bei 10 werden die ersten zehn Entitäten im Ergebnisarray übersprungen und die Daten für die nachfolgenden Entitäten ausgegeben
  Hinweis: Wir empfehlen diesen Parameter nur beim Abruf von bis zu 10.000 Ergebnissen
  für mehr als 10.000 Ergebnisse verwenden Sie stattdessen offset_token
- offset_token
  Typ: string | null
  
  Token für Folgeanfragen
  Optionales Feld
  wird im identischen Feld der Antwort auf jede Anfrage bereitgestellt;
  Verwenden Sie diesen Parameter, um Timeouts beim Abrufen von mehr als 100.000 Ergebnissen in einer einzigen Anfrage zu vermeiden;
  durch Angabe des eindeutigen offset_token-Werts aus dem Antwort-Array erhalten Sie die Folgeergebnisse der ursprünglichen Aufgabe;
  offset_token-Werte sind für jede Folgeaufgabe eindeutig
  Hinweis: wenn offset_token in der Anfrage angegeben ist, müssen alle anderen Parameter mit der vorherigen Anfrage identisch sein
  Weitere Informationen zu diesem Parameter finden Sie in unserem Help Center
- order_by
  Typ: array string[] | null
  
  Sortierregeln für die Ergebnisse
  Optionales Feld
  Zum Sortieren der Ergebnisse können Sie dieselben Werte wie im Array filters verwenden
  mögliche Sortierarten:
  asc – Ergebnisse werden aufsteigend sortiert
  desc – Ergebnisse werden absteigend sortiert
  Sortierart und -richtung werden durch ein Komma getrennt
  Beispiel:
  ["rating.value,desc"]Hinweis: Pro Anfrage sind höchstens drei Sortierregeln möglich
  Mehrere Sortierregeln werden durch ein Komma getrennt
  Beispiel:
  ["rating.value,desc","rating.votes_count,desc"]
- tag
  Typ: string | null
  
  Benutzerdefinierte Aufgaben-ID
  Optionales Feld
  Zeichenlimit: 255
  Mit diesem Parameter können Sie die Aufgabe identifizieren und dem Ergebnis zuordnen
  Den angegebenen Wert tag finden Sie im data-Objekt der Antwort
- title
  Typ: string | null
  
  Titel des Elements in der SERP
  Optionales Feld
  der Name des Geschäftsobjekts, für das die Ergebnisse erhoben werden;
  maximal 200 Zeichen

Antworten

200
Typ: object | null · Response36Afe1097B20_BusinessDataBusinessListingsSearchLiveResponseInfo
cost
Typ: number | null Format: double

Gesamtkosten der Aufgaben in USD

status_code
Typ: integer | null

allgemeiner Statuscode die vollständige Liste der Antwortcodes finden Sie hier

status_message
Typ: string | null

allgemeine Informationsmeldung die vollständige Liste der allgemeinen Informationsmeldungen finden Sie hier

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

Array von Aufgaben

Typ: object | null · Response36Afe1097B20_BusinessDataBusinessListingsSearchLiveTaskInfo
cost
Typ: number | null Format: double

Gesamtkosten der Aufgaben in USD

data
Typ: object | null

Enthält dieselben Parameter, die Sie in der POST-Anfrage angegeben haben

propertyName
Typ: object | null
id
Typ: string | null

Aufgaben-ID eindeutige Aufgaben-ID in unserem System im UUID-Format

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

URL-Pfad

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

Array von Ergebnissen

count
Typ: integer | null Format: int64

Elementtypen
die Anzahl der Elemente im Array items

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

aufgetretene Elementtypen
Arten von Suchergebnissen, die im Array items vorkommen;
mögliche Elementtypen: business_listing

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

zusätzliche Geschäftskategorien
zusätzliche Google My Business-Kategorien, die die vom Unternehmen angebotenen Leistungen genauer beschreiben

address
Typ: string | null

Adresse des Geschäfts

address_info
Typ: object | null · Response36Afe1097B20_AddressInfo

Objekt mit den Adressbestandteilen des Geschäfts

address
Typ: string | null

Straßenadresse des lokalen Geschäfts

borough
Typ: string | null

Verwaltungseinheit oder Bezirk, zu dem das lokale Geschäft gehört

city
Typ: string | null

Name der Stadt, in der sich das lokale Geschäft befindet

country_code
Typ: string | null

ISO-Ländercode des lokalen Geschäfts

region
Typ: string | null

DMA-Region, zu der das lokale Geschäft gehört

zip
Typ: string | null

Postleitzahl des lokalen Geschäfts

attributes
Typ: object | null · Response36Afe1097B20_BusinessDataAttributesInfo

Dienstleistungsdetails in Form von nutzerbewerteten Prüfpunkten;
Dienstleistungsdetails eines Geschäfts, die in Form von Prüfpunkten und auf Basis von Nutzerfeedback und der category des Geschäfts angezeigt werden

available_attributes
Typ: object | null

verfügbare Attribute
gibt die Attribute an, die ein Unternehmen anbieten kann

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

nicht verfügbare Attribute
gibt die Attribute an, die ein Unternehmen nicht anbieten kann

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

Geschäftskategorie
allgemeine Google My Business-Kategorie, die die vom Unternehmen angebotenen Leistungen am besten beschreibt

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

globale Kategorie-IDs
universelle Kategorie-IDs, die sich je nach ausgewähltem Land nicht ändern

check_url
Typ: string | null

direkte URL zu den Suchmaschinenergebnissen
Sie können sie verwenden, um sicherzustellen, dass wir genaue Ergebnisse geliefert haben

cid
Typ: string | null

von Google definierte Client-ID
eindeutige ID eines lokalen Geschäfts
mehr zur Kennung in diesem Hilfeartikel

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

verfügbare Kontakte des Unternehmens
Liste der Kontakte zur Kontaktaufnahme mit dem Unternehmen

source
Typ: string | null

Datenquelle

type
Typ: string | null

Elementtyp

value
Typ: string | null

der Wert der Bewertung

description
Typ: string | null

Beschreibung des Elements in SERP
die Beschreibung des Geschäfts, für das die Ergebnisse gesammelt werden

domain
Typ: string | null

Domain des Unternehmens

feature_id
Typ: string | null

der eindeutige Identifikator des Elements in SERP
mehr über den Identifikator erfahren Sie in diesem Help-Center-Artikel

first_seen
Typ: string | null

Datum und Uhrzeit, an denen unser Crawler den Geschäftseintrag zum ersten Mal gefunden hat
im UTC-Format: „yyyy-mm-dd hh-mm-ss +00:00“
Beispiel:
2023-03-11 10:04:11 +00:00

hotel_rating
Typ: integer | null

Sterneklassifizierung des Hotels
die Klassifizierung reicht von 1 bis 5 Sternen, Weitere Informationen
sind keine Informationen zur Sterneklassifizierung des Hotels vorhanden, ist der Wert null

is_claimed
Typ: boolean | null

gibt an, ob das Geschäft von seinem Inhaber in Google Maps verifiziert wurde

last_updated_time
Typ: string | null

Datum und Uhrzeit der letzten Datenaktualisierung
im UTC-Format: „yyyy-mm-dd hh-mm-ss +00:00“
Beispiel:
2023-01-26 09:03:15 +00:00

latitude
Typ: number | null

Breitengrad der lokalen Niederlassungen in Google Maps
Beispiel:
"latitude": 51.584091

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

verfügbare Interaktionen mit dem Unternehmen
Liste der Optionen zur direkten Interaktion mit dem Unternehmen aus den Suchergebnissen

type
Typ: string | null

Elementtyp

logo
Typ: string | null

URL des im Google My Business-Profil enthaltenen Logos

longitude
Typ: number | null

Längengrad der lokalen Niederlassung in Google Maps
Beispiel:
"longitude": -0.31365919999999997

main_image
Typ: string | null

URL des im Google My Business-Profil hervorgehobenen Hauptbildes

original_title
Typ: string | null

ursprünglicher Titel des Elements
ursprünglicher Titel, nicht von Google übersetzt

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

zugehörige Unternehmen

cid
Typ: string | null

von Google definierte Client-ID
eindeutige ID eines lokalen Geschäfts
mehr zur Kennung in diesem Hilfeartikel

feature_id
Typ: string | null

der eindeutige Identifikator des Elements in SERP
mehr über den Identifikator erfahren Sie in diesem Help-Center-Artikel

rating
Typ: object | null · Response36Afe1097B20_RatingInfo

die Bewertung des Elements
der Beliebtheitswert auf Basis von Bewertungen, in der SERP angezeigt

rating_max
Typ: integer | null

der Höchstwert für einen rating_type

rating_type
Typ: string | null

der Typ der Bewertung hier finden Sie die folgenden Elemente: Max5, Percents, CustomMax

value
Typ: number | null Format: double

der Wert der Bewertung

votes_count
Typ: integer | null Format: int64

die Anzahl der Rückmeldungen

title
Typ: string | null

Titel des Elements in SERP
der Name des Unternehmens, für das die Ergebnisse gesammelt werden

phone
Typ: string | null

Telefonnummer des Unternehmens

place_id
Typ: string | null

eindeutige Ortskennung
Place-ID des lokalen Geschäfts, das im Element erscheint
mehr über die Kennung erfahren Sie in diesem Help-Center-Artikel

place_topics
Typ: object | null

in Kundenbewertungen genannte Keywords
enthält die beliebtesten Keywords zu Produkten/Dienstleistungen, die in Kundenbewertungen eines Unternehmens genannt werden, sowie die Anzahl der Bewertungen, die das jeweilige Keyword erwähnen
Beispiel:"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

Auslastungszeiten
Informationen zu den Stoßzeiten des Unternehmens

popular_times_by_days
Typ: object | null

beliebte Zeiten
Informationen zu den Auslastungszeiten des lokalen Geschäfts an jedem Wochentag

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

Arbeitszeiten am Sonntag

popular_index
Typ: integer | null

Beliebtheitsindex relativer, zeitgebundener Beliebtheitsindex von 0 bis 100; ein höherer Wert entspricht einer geschäftigeren Tageszeit

time
Typ: object | null · Response36Afe1097B20_TimeInfo

Stunden im 24-Stunden-Format

hour
Typ: integer | null

Stunden im 24-Stunden-Format

minute
Typ: integer | null

Minuten

price_level
Typ: string | null

Preisniveau des Objekts
mögliche Werte: inexpensive, moderate, expensive, very_expensive
sind keine Informationen zum Preisniveau vorhanden, ist der Wert null

rating
Typ: object | null · Response36Afe1097B20_RatingInfo

die Bewertung des Elements
der Beliebtheitswert auf Basis von Bewertungen, in der SERP angezeigt

rating_max
Typ: number | null Format: double

der Höchstwert für einen rating_type

rating_type
Typ: string | null

der Typ der Bewertung hier finden Sie die folgenden Elemente: Max5, Percents, CustomMax

value
Typ: number | null Format: double

der Wert der Bewertung

votes_count
Typ: integer | null Format: int64

die Anzahl der Rückmeldungen

rating_distribution
Typ: object | null

die Verteilung der Bewertungen des Unternehmens
das Objekt zeigt die Anzahl der 1-Sterne- bis 5-Sterne-Bewertungen aus Nutzerbewertungen

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

Geschäftskategorie
allgemeine Google My Business-Kategorie, die die vom Unternehmen angebotenen Leistungen am besten beschreibt

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

Währung des angegebenen Preises ISO-Code der auf den Preis angewendeten Währung

current
Typ: number | null Format: double

aktueller Preis gibt den aktuellen Preis des im Ergebnis dargestellten Produkts oder der Dienstleistung an

displayed_price
Typ: string | null

Preiszeichenfolge im Ergebnis unbearbeitete Preiszeichenfolge, wie sie im Ergebnis angegeben ist

is_price_range
Typ: boolean | null

Preis wird als Spanne angegeben gibt an, ob ein Preis als Spanne angegeben wird

max_value
Typ: number | null Format: double

der Höchstpreis der im Ergebnis angegebene Höchstpreis des Produkts oder der Dienstleistung

regular
Typ: number | null Format: double

regulärer Preis gibt den regulären Preis des Produkts oder der Dienstleistung ohne Rabatte an

snippet
Typ: string | null

zusätzliche Informationen zum Unternehmen

title
Typ: string | null

Titel des Elements in SERP
der Name des Unternehmens, für das die Ergebnisse gesammelt werden

snippet
Typ: string | null

zusätzliche Informationen zum Unternehmen

title
Typ: string | null

Titel des Elements in SERP
der Name des Unternehmens, für das die Ergebnisse gesammelt werden

total_photos
Typ: integer | null Format: int64

Gesamtzahl der im Google My Business-Profil hervorgehobenen Bilder

type
Typ: string | null

Elementtyp

url
Typ: string | null

absolute URL des Unternehmens

work_time
Typ: object | null · Response36Afe1097B20_BusinessWorkHoursInfo

Angaben zu den Arbeitszeiten
Informationen zu den Öffnungszeiten des Unternehmens

work_hours
Typ: object | null · Response36Afe1097B20_WorkHours

Öffnungszeiten
Informationen zu den Arbeitszeiten der lokalen Niederlassung

current_status
Typ: string | null

aktueller Status der Niederlassung
gibt an, ob die Niederlassung geöffnet oder geschlossen ist

timetable
Typ: object | null

Arbeitszeitplan

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

Arbeitszeiten am Sonntag

close
Typ: object | null · Response36Afe1097B20_TimeInfo

Schließzeit

hour
Typ: integer | null

Stunden im 24-Stunden-Format

minute
Typ: integer | null

Minuten

open
Typ: object | null · Response36Afe1097B20_TimeInfo

Öffnungszeit

hour
Typ: integer | null

Stunden im 24-Stunden-Format

minute
Typ: integer | null

Minuten

offset
Typ: integer | null Format: int64

Signed 64-bit integers (long type).

offset_token
Typ: string | null
total_count
Typ: integer | null Format: int64

Gesamtzahl der für Ihre Anfrage relevanten Ergebnisse in unserer Datenbank

result_count
Typ: integer | null Format: int64

Anzahl der Elemente im Ergebnis-Array

status_code
Typ: integer | null

Statuscode der Aufgabe von DataForSEO erzeugt, kann im folgenden Bereich liegen: 10000-60000 die vollständige Liste der Antwortcodes finden Sie hier

status_message
Typ: string | null

Informationsmeldung der Aufgabe die vollständige Liste der allgemeinen Informationsmeldungen finden Sie hier

time
Typ: string | null

Ausführungszeit in Sekunden

tasks_count
Typ: integer | null Format: int64

Die Anzahl der Aufgaben im tasks-Array

tasks_error
Typ: integer | null Format: int64

Die Anzahl der Aufgaben im tasks-Array, die mit einem Fehler zurückgegeben wurden

time
Typ: string | null

Gesamtausführungszeit, Sekunden

version
Typ: string | null

Die aktuelle Version der API
application/json
400

Die Anfrage konnte nicht verarbeitet werden. Prüfen Sie die Anfrageparameter.
401

Ein gültiger Felo-API-Schlüssel ist erforderlich.
402

Die Anfrage kann nicht fortgesetzt werden, da eine Abrechnungsvoraussetzung nicht erfüllt ist.
403

Das Konto ist für diesen Vorgang nicht berechtigt.
429

Ein Anfrage- oder Ausgabenlimit wurde erreicht.
502

Der Dienst konnte die Anfrage nicht abschließen.
503

Die API oder der Abrechnungsdienst ist vorübergehend nicht verfügbar.
504

Beim Verarbeiten der Anfrage ist eine Zeitüberschreitung aufgetreten.
default

Fehlerantwort; Upstream-Passthrough-Antworten können Anbieterformate verwenden

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 anzeigen

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

Erfolgreicher Vorgang

Live-Suche in Firmeneinträgen

AuthentifizierungRequired

DataForSEO

Live-Suche in Firmeneinträgen

Preisreferenz