Felo API PlatformFelo API Platform
Alle Endpoints von DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Live: Google Local Finder SERP HTML

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

Live: Google Local Finder SERP HTML

​

Gibt die erweiterten lokalen Ergebnisse, die Google anzeigt, wenn eine Suchanfrage eindeutig lokal ist, synchron zurück. Roher Seitenquelltext statt geparster Ergebnisse. 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

      im Feld keyword können Sie bis zu 700 Zeichen angeben

      alle %## werden dekodiert (das Zeichen ‘+’ wird zudem 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” an

    • 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: string | null

      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

    • 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_SerpGoogleLocalFinderLiveHtmlResponseInfo
    • 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_SerpGoogleLocalFinderLiveHtmlTaskInfo
        • 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

          • 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

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

            Elemente der in der SERP gefundenen Suchergebnisse

            • date
              Typ: string | null

              Datum und Uhrzeit, zu denen die HTML-Seite gescannt wurde
              im UTC-Format: “yyyy-mm-dd hh-mm-ss +00:00”
              Beispiel:
              2019-11-15 12:57:46 +00:00

            • html
              Typ: string | null

              HTML-Seite

            • page
              Typ: integer | null

              laufende Nummer der zurückgegebenen HTML-Seite

          • 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

          • se_domain
            Typ: string | null

            Suchmaschinen-Domain in einem POST-Array

          • 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
Request Example for post/v1/beta/dataforseo/serp/google/local_finder/live/html
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/local_finder/live/html \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "keyword": "albert einstein"
  }
]'

{
  "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,
          "datetime": null,
          "items_count": null,
          "items": [
            {
              "page": null,
              "date": null,
              "html": null
            }
          ]
        }
      ]
    }
  ]
}

Erfolgreicher Vorgang

Live Google Local Finder SERP HTML