v0.2.0-beta

OpenAPI 3.1.0

Live: Google Local Finder SERP

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/serp/google/local_finder/live/advanced

Live: Google Local Finder SERP

Gibt die erweiterten lokalen Ergebnisse, die Google anzeigt, wenn eine Suchanfrage eindeutig lokal ist, synchron zurück. Gibt keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count und items zurück. advanced ist die Standardwahl; nehmen Sie regular, wenn nur die Rangliste zählt, und html nur, um zu prüfen, was der Parser verworfen hat. Eingebettet in die DataForSEO-Hülle: Daten in tasks[0].result, Ergebnis in tasks[0].status_code – eine abgelehnte Anfrage gibt dennoch HTTP 200 zurück.

Preisreferenz

Abrechnung: Gemeldete Antwortkosten.
Referenzschätzung pro Anfrage: USD 0.02.
Referenz-Kundenmultiplikator: 1.0. Nicht erneut auf einen bereits abgerechneten Kundenbetrag anwenden.

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

Body

application/json

Typ: array (object | null)[]
- depth
  Typ: integer | null
  
  Parsing-Tiefe
  
  Optionales Feld
  
  Anzahl der Ergebnisse in der SERP
  
  Standardwert: 10
  
  Höchstwert: 100
  
  Ihr Konto wird für jede SERP abgerechnet, die bis zu 10 Ergebnisse enthält;
  Eine Tiefe über 10 kann zu zusätzlichen Kosten führen, wenn die Suchmaschine mehr als 10 Ergebnisse zurückgibt;
  
  Wenn die angegebene Tiefe höher als die Anzahl der Ergebnisse in der Antwort ist, wird die Differenz automatisch Ihrem Kontostand gutgeschrieben
  
  Die Kosten lassen sich auf der Seite Pricing berechnen.
- device
  Typ: string | null
  
  Gerätetyp
  
  Optionales Feld
  
  Ergebnisse für einen bestimmten Gerätetyp zurückgeben
  
  Kann die Werte annehmen:desktop, mobile
  
  Standardwert: desktop
- keyword
  Typ: string
  
  Keyword
  
  Pflichtfeld
  
  Sie können im Feld keyword bis zu 700 Zeichen angeben
  
  alle %## werden dekodiert (das Zeichen „+“ wird in ein Leerzeichen dekodiert)
  
  wenn Sie das Zeichen „%“ für Ihr keyword benötigen, geben Sie es als „%25“ an;
  
  wenn Sie das Zeichen „+“ für Ihr keyword benötigen, geben Sie es als „%2B“
  
  weitere Informationen zu den Regeln und Einschränkungen der Felder keyword und keywords in DataForSEO-APIs finden Sie in diesem Help-Center-Artikel
- language_code
  Typ: string
  
  Sprachcode der Suchmaschine
  
  Pflichtfeld, wenn nicht angegeben language_name
  
  bei Verwendung dieses Feldes ist keine Angabe von language_name nötig
  
  die Liste der verfügbaren Sprachen der Suchmaschine mit ihrem language_code erhalten Sie durch eine separate Anfrage an die https://api.dataforseo.com/v3/serp/{{low_se_name}}/languages
  
  Beispiel:en
- language_name
  Typ: string
  
  vollständiger Name der Suchmaschinensprache
  
  Pflichtfeld, wenn nicht angegeben language_code
  
  bei Verwendung dieses Feldes ist keine Angabe von language_code nötig
  
  die Liste der verfügbaren Sprachen der Suchmaschine mit ihrem language_name erhalten Sie durch eine separate Anfrage an die https://api.dataforseo.com/v3/serp/{{low_se_name}}/languages
  
  Beispiel:
  
  English
- location_code
  Typ: integer
  
  Standortcode der Suchmaschine
  
  Pflichtfeld, wenn nicht angegeben location_name oder location_coordinate
  
  bei Verwendung dieses Feldes ist keine Angabe von location_name oder location_coordinate nötig
  
  die Liste der verfügbaren Standorte der Suchmaschinen mit ihrem location_code erhalten Sie durch eine separate Anfrage an die https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations
  
  Beispiel:
  
  2840
- location_coordinate
  Typ: string
  
  GPS-Koordinaten eines Standorts
  
  Pflichtfeld, wenn nicht angegeben location_name oder location_code
  
  bei Verwendung dieses Feldes ist keine Angabe von location_name oder location_code nötig
  
  Der Parameter location_coordinate muss im Format "latitude,longitude,zoom" angegeben werden
  
  wenn "zoom" nicht angegeben ist, wird 9z als Standardwert verwendet
  
  die maximale Anzahl der Nachkommastellen für "latitude" und "longitude": 7
  
  der Mindestwert für "zoom": 4z
  
  der Höchstwert für "zoom": 18z
  
  Beispiel:
  
  52.6178549,-155.352142,20z
- location_name
  Typ: string
  
  vollständiger Name des Suchmaschinen-Standorts
  
  Pflichtfeld, wenn nicht angegeben location_code oder location_coordinate
  
  bei Verwendung dieses Feldes ist keine Angabe von location_code oder location_coordinate nötig
  
  die Liste der verfügbaren Standorte der Suchmaschine mit ihrem location_name erhalten Sie durch eine separate Anfrage an die https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations
  
  Beispiel:
  
  London,England,United Kingdom
- min_rating
  Typ: number | null Format: double
  
  Ergebnisse nach Mindestbewertung filtern
  
  Optionales Feld
  
  Mögliche Werte für desktop: 3.5, 4, 4.5;
  
  Mögliche Werte für mobile: 2, 2.5, 3, 3.5, 4, 4.5
- os
  Typ: string | null
  
  Betriebssystem des Geräts
  
  Optionales Feld
  
  wenn Sie desktop im Feld device angeben, wählen Sie aus folgenden Werten: windows, macos
  
  Standardwert: windows
  
  wenn Sie mobile im Feld device angeben, wählen Sie aus folgenden Werten: android, ios
  
  Standardwert: android
- priority
  Typ: integer | null
  
  Aufgabenpriorität
  
  Optionales Feld
  
  Kann folgende Werte annehmen:
  
  1 – normale Ausführungspriorität (standardmäßig gesetzt)
  
  2 – hohe Ausführungspriorität
  
  Für Aufgaben mit hoher Ausführungspriorität wird zusätzlich berechnet.
  Die Kosten lassen sich auf der Seite Pricing berechnen.
- tag
  Typ: string | null
  
  benutzerdefinierter Aufgabenbezeichner
  
  optionales Feld
  
  Das Zeichenlimit beträgt 255
  
  Sie können diesen Parameter verwenden, um die Aufgabe zu identifizieren und dem Ergebnis zuzuordnen
  
  Den angegebenen tag-Wert finden Sie im data-Objekt der Antwort
- time_filter
  Typ: string | null
  
  Ergebnisse nach Öffnungszeiten filtern
  
  Optionales Feld
  
  mit diesem Feld können Sie Orte in den Ergebnissen nach der Zeit filtern, zu der ein Ort für Besucher geöffnet ist
  
  beachten Sie, dass Google auch Ergebnisse liefern kann, die nicht zu diesem Filter passen
  
  Mögliche Werte: "open_now", "24_hours", "$day_value", "$day_value;$time_value";
  
  verwenden Sie statt $day_value einen dieser Werte: "monday", "tuesday", "wednesday", "thursday", "friday", "saturday", "sunday";
  
  verwenden Sie statt $time_value einen dieser Werte: "00", "01", "02", "03", "04", "05", "06", "07", "08", "09", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23"
  
  Beispiel: "tuesday;18"

Antworten

200
Typ: object | null · Response36Afe1097B20_SerpGoogleLocalFinderLiveAdvancedResponseInfo
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_SerpGoogleLocalFinderLiveAdvancedTaskInfo
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

check_url
Typ: string | null

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

datetime
Typ: string | null

Datum und Uhrzeit des Eingangs des Ergebnisses
im UTC-Format: „yyyy-mm-dd hh-mm-ss +00:00“
Beispiel:
2019-11-15 12:57:46 +00:00

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

Arten von Suchergebnissen in der SERP
enthält die in der SERP gefundenen Arten von Suchergebnissen (items).
mögliche Elementtypen:
local_pack

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

Einträge des Elements

Typ: object | null · Response36Afe1097B20_LocalPackSerpElementItem
Typ: object · Response36Afe1097B20_LocalPackSerpElementItem
type
Diskriminator
Typ: string | null

Elementtyp

booking_url
Typ: string | null

URL der Buchungsseite

cid
Typ: string | null

von Google definierte Client-ID

description
Typ: string | null

Linkbeschreibung

domain
Typ: string | null

Domain der Website, die das Video hostet

is_paid
Typ: boolean | null

gibt an, ob das Element eine Anzeige ist

page
Typ: integer | null

Seitennummer der Suchergebnisse
gibt die Nummer der SERP-Seite an, auf der sich das Element befindet

phone
Typ: string | null

Telefonnummer

position
Typ: string | null

die Ausrichtung des Elements in der SERP
mögliche Werte:
left, right

rank_absolute
Typ: integer | null

absoluter Rang in SERP
absolute Position unter allen Elementen in SERP
immer gleich 0 für desktop

rank_group
Typ: integer | null

Gruppenrang in SERP
Position innerhalb einer Gruppe von Elementen mit identischen type-Werten;
Positionen von Elementen mit unterschiedlichen type-Werten werden aus rank_group ausgelassen;
immer gleich 0 für desktop

rating
Typ: object | null · Response36Afe1097B20_RatingInfo

Bewertung des Elements
die auf Rezensionen basierende und in SERP angezeigte Beliebtheitsbewertung;
wenn keine vorhanden ist, gleich null

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

rectangle
Typ: object | null · Response36Afe1097B20_AiModeRectangleInfo

Rechteckparameter
enthält kartesische Koordinaten und Pixeldimensionen des Snippets des Ergebnisses in der SERP
entspricht null, wenn calculate_rectangles in der POST-Anfrage nicht auf true gesetzt ist

height
Typ: number | null Format: double

Höhe des Elements in Pixeln

width
Typ: number | null Format: double

Breite des Elements in Pixeln

x
Typ: number | null Format: double

x-Achsen-Koordinate die x-Achsen-Koordinate der oberen linken Ecke des Snippets des Ergebnisses, wobei die obere linke Ecke des Bildschirms der Ursprung ist

y
Typ: number | null Format: double

y-Achsen-Koordinate die y-Achsen-Koordinate der oberen linken Ecke des Snippets des Ergebnisses, wobei die obere linke Ecke des Bildschirms der Ursprung ist

title
Typ: string | null

Titel der Zeile

url
Typ: string | null

URL der Rezensionsquelle eines Drittanbieters

xpath
Typ: string | null

der XPath des Elements

items_count
Typ: integer | null Format: int64

die Anzahl der im items-Array zurückgegebenen Ergebnisse

keyword
Typ: string | null

in einem POST-Array empfangenes Keyword
das Keyword wird dekodiert zurückgegeben (%##; das Zeichen „+“ wird in ein Leerzeichen dekodiert)

language_code
Typ: string | null

Sprachcode in einem POST-Array

location_code
Typ: integer | null

Standortcode in einem POST-Array

refinement_chips
Typ: object | null · Response36Afe1097B20_RefinementChipsInfo

Suchverfeinerungs-Chips

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

Einträge des Elements

domain
Typ: string | null

Domain in der SERP

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

weitere Optionen zur Suchverfeinerung

domain
Typ: string | null

Domain in der SERP

title
Typ: string | null

Titel des Elements

type
Typ: string | null

Elementtyp

url
Typ: string | null

Such-URL mit Verfeinerungsparametern

title
Typ: string | null

Titel des Elements

type
Typ: string | null

Elementtyp

url
Typ: string | null

Such-URL mit Verfeinerungsparametern

type
Typ: string | null

Elementtyp

xpath
Typ: string | null

der XPath des Elements

se_domain
Typ: string | null

Suchmaschinen-Domain in einem POST-Array

se_results_count
Typ: integer | null Format: int64

Gesamtzahl der Ergebnisse in der SERP

spell
Typ: object | null · Response36Afe1097B20_SpellInfo

Autokorrektur der Suchmaschine
wenn die Suchmaschine Ergebnisse für ein korrigiertes Keyword geliefert hat, geben wir das von der Suchmaschine korrigierte Keyword und die Art der Autokorrektur an

keyword
Typ: string | null

Keyword, das durch die Autokorrektur der Suchmaschine ermittelt wurde die Ergebnisse werden für das korrigierte Keyword bereitgestellt

type
Typ: string | null

Art der Autokorrektur mögliche Werte: did_you_mean, showing_results_for, no_results_found_for, including_results_for Hinweis: Yahoo und Yandex unterstützen nur die folgende Autokorrekturart: including_results_for

type
Typ: string | null

Elementtyp

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/serp/google/local_finder/live/advanced

curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/local_finder/live/advanced \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "keyword": "local nail services",
    "min_rating": 4.5,
    "time_filter": "monday"
  }
]'

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": [
        {
          "keyword": null,
          "type": null,
          "se_domain": null,
          "location_code": null,
          "language_code": null,
          "check_url": null,
          "datetime": null,
          "spell": {
            "keyword": null,
            "type": null
          },
          "refinement_chips": {
            "type": null,
            "xpath": null,
            "items": [
              "[Max Depth Exceeded]"
            ]
          },
          "item_types": [
            null
          ],
          "se_results_count": null,
          "items_count": null,
          "items": [
            {
              "type": "[Max Depth Exceeded]",
              "page": "[Max Depth Exceeded]",
              "position": "[Max Depth Exceeded]",
              "xpath": "[Max Depth Exceeded]",
              "rectangle": "[Max Depth Exceeded]",
              "rank_group": "[Max Depth Exceeded]",
              "rank_absolute": "[Max Depth Exceeded]",
              "title": "[Max Depth Exceeded]",
              "description": "[Max Depth Exceeded]",
              "domain": "[Max Depth Exceeded]",
              "phone": "[Max Depth Exceeded]",
              "booking_url": "[Max Depth Exceeded]",
              "url": "[Max Depth Exceeded]",
              "is_paid": "[Max Depth Exceeded]",
              "rating": "[Max Depth Exceeded]",
              "cid": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Erfolgreicher Vorgang

Live: Google Local Finder SERP

AuthentifizierungRequired

DataForSEO

Live: Google Local Finder SERP

Preisreferenz