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

Live: reguläres Yahoo-Organic-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: reguläres Yahoo-Organic-SERP

​

Gibt die Rangfolge der Ergebnisse für ein Keyword bei Yahoo 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. 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 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

      Parsingtiefe
      optionales Feld
      Anzahl der Ergebnisse in der SERP
      Standardwert: 6
      Maximalwert: 200
      Ihr Konto wird für jede SERP abgerechnet;
      Jede Yahoo-SERP kann weniger als 10 Ergebnisse enthalten, daher kann eine Tiefe über dem Standardwert zu zusätzlichen Kosten führen ;
      Die Kosten können auf der Seite Preise berechnet werden.

    • device
      Typ: string | null

      Gerätetyp
      optionales Feld
      kann folgende 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 „%“ in Ihrem keyword verwenden möchten, geben Sie es als „%25“ an;
      Wenn Sie das Zeichen „+“ in Ihrem keyword verwenden möchten, geben Sie es als „%2B“ an

      Weitere Informationen zu Regeln und Einschränkungen der Felder keyword und keywords in DataForSEO-APIs finden Sie in diesem Hilfe-Center-Artikel

    • language_code
      Typ: string

      Sprachcode der Suchmaschine
      Pflichtfeld, wenn Sie language_name nicht angeben
      Wenn Sie dieses Feld verwenden, müssen Sie language_name nicht angeben
      Die Liste der verfügbaren Sprachen der Suchmaschine mit ihrem language_code erhalten Sie durch eine separate Anfrage an https://api.dataforseo.com/v3/serp/{{low_se_name}}/languages
      Beispiel:
      enn

    • language_name
      Typ: string

      Vollständiger Name der Sprache der Suchmaschine
      Pflichtfeld, wenn Sie language_code nicht angeben
      Wenn Sie dieses Feld verwenden, müssen Sie language_code nicht angeben
      Die Liste der verfügbaren Sprachen der Suchmaschine mit ihrem language_name erhalten Sie durch eine separate Anfrage an https://api.dataforseo.com/v3/serp/{{low_se_name}}/languages
      Beispiel:
      English

    • location_code
      Typ: integer

      Standortcode der Suchmaschine
      Pflichtfeld, wenn Sie nicht angeben location_name oder location_coordinate
      bei Verwendung dieses Feldes müssen Sie location_name oder location_coordinate nicht angeben
      die Liste der verfügbaren Standorte der Suchmaschinen mit ihrem location_code erhalten Sie durch eine separate Anfrage an 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,radius" angegeben werden
      maximale Anzahl Dezimalstellen für "latitude" und "longitude": 7
      Mindestwert für "radius": 199.9 (mm)
      Höchstwert für "radius": 199999 (mm)
      Beispiel:
      53.476225,-2.243572,200

    • location_name
      Typ: string

      vollständiger Name des Standorts der Suchmaschine
      Pflichtfeld, wenn Sie nicht angeben location_code oder location_coordinate
      bei Verwendung dieses Feldes müssen Sie location_code oder location_coordinate nicht angeben
      die Liste der verfügbaren Standorte der Suchmaschine mit ihrem location_name erhalten Sie durch eine separate Anfrage an https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations
      Beispiel:
      London,England,United Kingdom

    • max_crawl_pages
      Typ: integer | null

      Seiten-Crawl-Limit
      optionales Feld
      Anzahl der zu crawlenden Suchergebnisseiten
      Standardwert: 1
      Maximalwert: 100
      Hinweis: Die Parameter max_crawl_pages und depth ergänzen sich;
      Weitere Informationen in unserem Hilfe-Center

    • os
      Typ: string | null

      Betriebssystem des Geräts
      Optionales Feld
      wenn Sie im Feld device desktop angeben, wählen Sie aus folgenden Werten: windows, macos
      Standardwert: windows
      wenn Sie im Feld device mobile angeben, wählen Sie aus folgenden Werten: android, ios
      Standardwert: android

    • se_domain
      Typ: string | null

      Domain der Suchmaschine
      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:
      au.search.yahoo.com, uk.search.yahoo.com, ca.search.yahoo.com, usw.

    • search_param
      Typ: string | null

      zusätzliche Parameter der Suchabfrage
      optionales Feld
      Die Liste der verfügbaren Parameter und weitere Details finden Sie hier

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

      Array von Zielen, bei denen das Crawling beendet wird optionales Feld wenn angegeben, enthält die Antwort SERP-Ergebnisse bis einschließlich des angegebenen match_value; Sie können bis zu 10 Zielwerte in diesem Array angeben Beispiel: "stop_crawl_on_match":[{"match_value":"dataforseo.com","match_type":"with_subdomains"}] Weitere Informationen zu diesem Parameter finden Sie in unserem Hilfe-Center - https://dataforseo.com/help-center/using-the-stop_crawl_on_match-parameter-in-serp-api Ihr Konto wird für jede über die angegebenen Ziele gecrawlte SERP abgerechnet

      • match_type
        Typ: string | null

        Typ der Zielübereinstimmung Pflichtfeld, wenn stop_crawl_on_match angegeben ist; Art der Übereinstimmung für den match_value mögliche Werte: domain, with_subdomains, wildcard

      • match_value
        Typ: string | null

        Ziel-Domain oder Wildcard-Wert Pflichtfeld, wenn stop_crawl_on_match angegeben ist; Geben Sie eine Ziel-Domain oder einen Wildcard-Wert an; Hinweis: Der Domainname muss ohne Anfrageprotokoll angegeben werden; Beispiel: dataforseo.com

    • 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

    • target
      Typ: string | null

      Ziel-Domain, Subdomain oder Webseite, für die Ergebnisse abgerufen werden sollen
      optionales Feld
      Eine Domain oder Subdomain sollte ohne https:// und www. angegeben werden.
      Beachten Sie, dass die Ergebnisse von target-spezifischen Aufgaben nur SERP-Elemente enthalten, die eine url-Zeichenfolge enthalten;
      Sie können auch das Platzhalterzeichen (‚‘) verwenden, um das Suchmuster in der SERP anzugeben und die Ergebnisse einzugrenzen;
      Beispiele:
      example.com - liefert Ergebnisse für die Startseite der Website mit URLs wie https://example.com, https://www.example.com/ oder https://example.com/;
      example.com       - liefert Ergebnisse für die Domain, einschließlich aller ihrer Seiten;
      example.com - liefert Ergebnisse für die gesamte Domain, einschließlich aller ihrer Seiten und Subdomains;
      example.com - liefert Ergebnisse für die Startseite unabhängig von der Subdomain, wie https://en.example.com;
      example.com/example-page - liefert Ergebnisse für die exakte URL;
      example.com/example-page       - liefert Ergebnisse für alle URLs der Domain, die mit der angegebenen Zeichenfolge beginnen

    • url
      Typ: string | null

      direkte URL der Suchabfrage
      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 Sie außerdem 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://search.yahoo.com/search?p=rank+checker&n=100&vl=lang_en&vc=us&ei=UTF-8

Antworten
  • 200
    Typ: object | null · Response36Afe1097B20_SerpYahooOrganicLiveRegularResponseInfo
    • 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_SerpYahooOrganicLiveRegularTaskInfo
        • 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

            in SERP gefundene Arten von Suchergebnissen
            enthält die Typen aller in der zurückgegebenen SERP gefundenen Suchergebnisse (items)
            mögliche Elementtypen:
            featured_snippet, images, local_pack, hotels_pack, organic, paid, people_also_ask, related_searches, shopping, recipes, top_stories, video, ai_overview;
            Hinweis: Dieses Array enthält alle in der zurückgegebenen SERP gefundenen Arten von Suchergebnissen;
            dieser Endpunkt liefert jedoch nur Daten für die Typen organic, paid und featured_snippet;
            um alle im zurückgegebenen SERP gefundenen Elemente (einschließlich SERP-Features und Rich Snippets) zu erhalten, lesen Sie den Yahoo Organiс Advanced SERP-Endpunkt

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

            Einträge in der SERP

            • page
              Typ: integer | null

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

            • position
              Typ: string | null

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

            • 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

            • type
              Typ: string | null

              Elementtyp

            • 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

          • pages_count
            Typ: integer | null Format: int64

            abgerufene Seiten insgesamt
            Gesamtzahl der im Ergebnis abgerufenen SERPs

          • refinement_chips
            Typ: object | null · Response36Afe1097B20_RefinementChipsInfo

            Suchverfeinerungs-Chips
            entspricht null

            • 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/yahoo/organic/live/regular
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/yahoo/organic/live/regular \
  --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,
          "pages_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "page": null,
              "position": null,
              "xpath": null,
              "rectangle": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Erfolgreicher Vorgang

Live Yahoo Organic SERP Regular