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

Live: Google Maps 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

Live: Google Maps SERP

​

Gibt das Map-Pack für eine lokale Abfrage synchron zurück, mit Bewertung, Adresse und Place-ID jedes Unternehmens bei Google. 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.002.
  • Referenz-Kundenmultiplikator: 1.0. Nicht erneut auf einen 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: 100

      Höchstwert: 700


      Ihr Konto wird für jede SERP abgerechnet, die bis zu 100 Ergebnisse enthält;

      Eine Tiefe über 100 kann zu zusätzlichen Kosten führen wenn die Suchmaschine mehr als 100 Ergebnisse zurückgibt;

      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

      Mögliche Werte:desktop, mobile

      Standardwert: desktop

      Hinweis: für Geräte vom Typ mobile werden pro SERP nur 20 Ergebnisse zurückgegeben

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

      Mehr über Regeln und Einschränkungen der Felder keyword und keywords in DataForSEO-APIs erfahren 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/google/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/google/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/google/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 17z als Standardwert verwendet

      die maximale Anzahl der Nachkommastellen für "latitude" und "longitude": 7

      der Mindestwert für "zoom": 3z

      der Höchstwert für "zoom": 21z

      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/google/locations

      Beispiel:

      London,England,United Kingdom

    • max_crawl_pages
      Typ: integer | null

      Crawl-Limit für Seiten

      Optionales Feld

      Anzahl der zu crawlenden Suchergebnisseiten

      Höchstwert: 100

      Hinweis: die Parameter max_crawl_pages und depth ergänzen sich gegenseitig;

      mehr dazu in unserem Help Center

    • 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

    • se_domain
      Typ: string | null

      Suchmaschinen-Domain

      Optionales Feld

      Wir wählen die passende Suchmaschinen-Domain automatisch anhand des von Ihnen angegebenen Standorts und der Sprache aus

      Sie können in diesem Feld jedoch eine benutzerdefinierte Suchmaschinen-Domain festlegen

      Beispiel:

      google.co.uk, google.com.au, google.de usw.

    • search_places
      Typ: boolean | null

      Suchmodus für Orte

      Optionales Feld

      der Suchmodus für Orte ermöglicht es, Google-Maps-Ergebnisse zu einem bestimmten Ort zu erhalten (z. B. Apple Store in New York)

      aufgrund der Besonderheiten unseres Data-Mining-Algorithmus kann dieser Modus jedoch mit einigen Anfragen mit lokalem Bezug interferieren und Ergebnisse für einen Standort anzeigen, der von dem in der Anfrage angegebenen abweicht;

      um diese Interferenz zu vermeiden und korrekte Ergebnisse für Keywords mit lokalem Bezug zu erhalten, können Sie diesen Parameter auf false setzen;


      Standardwert: true

      Hinweis: wenn der Modus search_places deaktiviert ist und im Suchbereich keine Ergebnisse gefunden wurden, ist das Array results leer

    • search_this_area
      Typ: boolean | null

      Ergebnisse aus dem angezeigten Bereich anzeigen

      Optionales Feld

      Mögliche Werte:true, false

      Standardwert: true


      bei false wird der Modus search_this_area deaktiviert


      Hinweis: wenn der Modus search_this_area deaktiviert ist, können Google-Maps-Einträge Ergebnisse außerhalb des angezeigten Bereichs enthalten

    • 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

    • url
      Typ: string | null

      direkte URL der Suchanfrage

      Optionales Feld

      Sie können eine direkte URL angeben, und wir ordnen sie den erforderlichen Feldern zu. Beachten Sie, dass diese Methode für unsere API am schwierigsten zu verarbeiten ist und dass Sie die genaue Sprache und den Standort in der URL angeben müssen. In den meisten Fällen würden wir diese Methode nicht empfehlen.

      Beispiel:

      https://google.com/maps/search/pizza/@37.09024,-95.712891,4z


      Hinweis: Die folgenden Suchmaschinenparameter werden nicht unterstützt und automatisch zurückgesetzt, wenn sie in der URL angegeben werden: allinanchor:, allintext:, allintitle:, allinurl:, cache:, define:, definition:, filetype:, id:, inanchor:, info:, intext:, intitle:, inurl:, link:, site:.
Antworten
  • 200
    Typ: object | null · Response36Afe1097B20_SerpGoogleMapsLiveAdvancedResponseInfo
    • 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_SerpGoogleMapsLiveAdvancedTaskInfo
        • 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
            Hinweis: Um standortspezifische Ergebnisse zu prüfen, folgen Sie der bereitgestellten Prüf-URL, scrollen Sie nach oben und unten und klicken Sie dann auf die Schaltfläche „Search this area“

          • 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:
            maps_search, maps_paid_item

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

            Einträge des Elements

            • domain
              Typ: string | null

              Domain in SERP

            • rank_absolute
              Typ: integer | null

              absoluter Rang in SERP
              absolute Position unter allen Elementen in SERP

            • rank_group
              Typ: integer | null

              Gruppenrang in der SERP
              Position innerhalb einer Gruppe von Elementen mit identischen type-Werten
              Positionen von Elementen mit anderen type-Werten werden aus rank_group ausgelassen

            • 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

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

              Titel des Elements

            • type
              Typ: string | null

              Elementtyp

            • url
              Typ: string | null

              Such-URL mit Verfeinerungsparametern

          • 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
Request Example for post/v1/beta/dataforseo/serp/google/maps/live/advanced
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/maps/live/advanced \
  --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,
          "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": null,
              "rank_group": null,
              "rank_absolute": null,
              "domain": null,
              "title": null,
              "url": null,
              "rating": "[Max Depth Exceeded]",
              "rating_distribution": null
            }
          ]
        }
      ]
    }
  ]
}

Erfolgreicher Vorgang

Live Google Maps SERP