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

Content Analysis: Suche

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

Content Analysis: Suche

​

Listet die einzelnen Seiten auf, die ein Keyword zitieren, statt der Summen. Jeder Eintrag enthält url, domain, main_domain, url_rank, domain_rank, spam_score, fetch_time, country, language, score und page_category, daneben total_count und items_count. filters akzeptiert die von get_dataforseo_content_available_filters aufgeführten Felder. Für Anzahlen und Verteilungen statt Seiten verwenden Sie post_dataforseo_content_summary_live.

Preisreferenz

  • Abrechnung: Gemeldete Antwortkosten.
  • Referenzschätzung pro Anfrage: USD 0.0276.
  • 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)[]
    • filters
      Typ: array (object | null)[] | null

      Array von Filterparametern 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, match, not_match
      Mit dem Operator % in like und not_like können Sie beliebige Zeichenfolgen mit null oder mehr Zeichen abgleichen
      Beispiel:
      ["country","=", "US"]

      [["domain_rank",">",800],"and",["content_info.connotation_types.negative",">",0.9]]

      [["domain_rank",">",800],
      "and",
      [["page_types","has","ecommerce"],
      "or",

      ["content_info.text_category","has",10994]]]
      Weitere Informationen zu Filtern finden Sie unter Content Analysis API - Filters

      Leeres Objekt
    • keyword
      Typ: string

      Ziel-Keyword
      Pflichtfeld
      UTF-8-Kodierung
      Die Keywords werden in Kleinbuchstaben umgewandelt;
      Hinweis: Um eine exakte Phrase statt eines einzelnen Keywords zu finden, verwenden Sie doppelte Anführungszeichen und Backslashes;
      Beispiel:
      "keyword": "\"tesla palo alto\""

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

    • keyword_fields
      Typ: object | null

      Zielfelder und Ziel-Keywords
      Optionales Feld
      Mit diesem Parameter filtern Sie den Datensatz nach Keywords, die in bestimmten Feldern enthalten sein sollen;
      mögliche Felder: title, main_title, previous_title, snippet
      Sie können mehrere Felder angeben;
      Hinweis: Um eine exakte Phrase statt eines einzelnen Keywords zu finden, verwenden Sie doppelte Anführungszeichen und Backslashes;
      Beispiel:
      "keyword_fields": {<br>"snippet": "\"logitech mouse\"",<br>"main_title": "sale"<br>}"

      • propertyName
        Typ: string | null
    • limit
      Typ: integer | null

      die maximale Anzahl der zurückgegebenen Zitate
      Optionales Feld
      Standardwert: 100
      Höchstwert: 1000

    • offset
      Typ: integer | null

      Offset im Ergebnisarray der zurückgegebenen Zitate
      Optionales Feld
      Standardwert: 0
      Wenn Sie den Wert 10 angeben, werden die ersten zehn Zitate im Ergebnisarray ausgelassen und die Daten für die nachfolgenden Zitate ausgegeben
      Hinweis: wir empfehlen, diesen Parameter nur beim Abruf von bis zu 10.000 Ergebnissen zu verwenden
      für den Abruf von mehr als 10.000 Ergebnissen verwenden Sie stattdessen offset_token.

    • offset_token
      Typ: string | null

      Offset-Token für nachfolgende Anfragen
      Optionales Feld
      wird im identischen Feld der Antwort auf jede Anfrage bereitgestellt;
      Verwenden Sie diesen Parameter, um Zeitüberschreitungen zu vermeiden, wenn Sie mehr als 10.000 Ergebnisse in einer einzigen Anfrage abrufen möchten;
      Wenn Sie den eindeutigen Wert offset_token aus dem Antwortarray angeben, erhalten Sie die nachfolgenden Ergebnisse der ursprünglichen Aufgabe;
      offset_token-Werte sind für jede nachfolgende Aufgabe eindeutig
      Hinweis: Wenn offset_token in der Anfrage angegeben wird, werden bei der Verarbeitung der Aufgabe alle anderen Parameter außer limit nicht berücksichtigt
      Weitere Informationen zu diesem Parameter finden Sie in unserem Help-Center

    • order_by
      Typ: array string[] | null

      Sortierregeln für 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:
      ["content_info.sentiment_connotations.anger,desc"]
      Standardregel:
      ["content_info.sentiment_connotations.anger,desc"]
      Hinweis: Pro Anfrage sind höchstens drei Sortierregeln möglich
      Mehrere Sortierregeln werden durch ein Komma getrennt
      Beispiel:
      ["content_info.sentiment_connotations.anger,desc","keyword_data.keyword_info.cpc,desc"]

    • page_type
      Typ: array string[] | null

      Zielseitentypen
      Optionales Feld
      Mit diesem Parameter filtern Sie den Datensatz nach Seitentypen
      mögliche Werte:
      "ecommerce", "news", "blogs", "message-boards", "organization"

    • rank_scale
      Typ: string | null

      definiert die Skala zur Berechnung und Anzeige der Werte domain_rank und url_rank
      Optionales Feld

      Mit diesem Parameter wählen Sie, ob Rangwerte auf einer Skala von 0–100 oder 0–1000 dargestellt werden

      mögliche Werte:
      one_hundred — Rangwerte werden auf einer Skala von 0–100 angezeigt
      one_thousand — Rangwerte werden auf einer Skala von 0–1000 angezeigt

      Standardwert: one_thousand

      Weitere Informationen zur Funktionsweise dieses Parameters finden Sie in diesem Help-Center-Artikel

    • search_mode
      Typ: string | null

      Gruppierungstyp der Ergebnisse
      Optionales Feld
      mögliche Gruppierungstypen:
      as_is - gibt alle Zitate für das Ziel-keyword zurück
      one_per_domain - gibt ein Zitat des keyword pro Domain zurück
      Standardwert: as_is

    • 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

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

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

            enthält Zitierungen und zugehörige Daten

            • content_info
              Typ: object | null · Response36Afe1097B20_AnalysisContentInfo

              enthält Daten zu Zitierungen aus der angegebenen url

              • author
                Typ: string | null

                Autor des Inhalts

              • connotation_types
                Typ: object | null

                Konnotationstypen
                enthält Typen von Stimmungen (Sentiment-Polarität) in Bezug auf das jeweilige Zitat sowie den Wahrscheinlichkeitsindex für jeden Stimmungstyp
                mögliche Konnotationstypen: positive, negative, neutral

                • propertyName
                  Typ: integer | null Format: int64

                  Signed 64-bit integers (long type).

              • content_quality_score
                Typ: integer | null

                Score für Inhaltsqualität
                dieser Wert wird anhand der Anzahl der Wörter, Sätze und Zeichen im Inhalt berechnet

              • content_type
                Typ: string | null

                Inhaltstyp
                Beispiel:
                page_content, comment

              • date_published
                Typ: string | null

                Datum und Uhrzeit der Veröffentlichung des Inhalts
                im UTC-Format: "yyyy-mm-dd hh-mm-ss +00:00"
                Beispiel:
                2017-01-24 13:20:59 +00:00

              • group_date
                Typ: string | null

                Datum und Uhrzeit der Zitatgruppe
                gibt das Veröffentlichungsdatum des Inhalts oder Datum und Uhrzeit des ersten Besuchs unserer Crawler auf der Seite an;
                dieses Feld kann verwendet werden, um Zitate nach Datum zu gruppieren und Zitat-Trends anzuzeigen;
                Datum und Uhrzeit werden im UTC-Format angegeben: "yyyy-mm-dd hh-mm-ss +00:00"
                Beispiel:
                2017-01-24 13:20:59 +00:00

              • highlighted_text
                Typ: string | null

                hervorgehobener Text aus dem snippet

              • language
                Typ: string | null

                Hauptsprache der Domain
                eine vollständige Liste der verfügbaren Sprachen finden Sie im Endpunkt Languages

              • level
                Typ: integer | null

                Überschriftsebene von title
                gibt die h-Tag-Ebene von 1 (oben) bis 6 (unten) an

              • main_title
                Typ: string | null

                Seitentitel

              • previous_title
                Typ: string | null

                Titel des vorherigen Inhaltsblocks

              • rating
                Typ: object | null · Response36Afe1097B20_ContententRatingInfo

                Inhaltsbewertung
                Bewertung in Bezug auf content_info

                • max_rating_value
                  Typ: number | null Format: double

                  Höchstwert für den Bewertungsnamen

                • name
                  Typ: string | null

                  Bewertungsname hier finden Sie die folgenden Elemente: Max5, Percents, CustomMax

                • rating_count
                  Typ: integer | null Format: int64

                  Anzahl der Stimmen

                • rating_value
                  Typ: number | null Format: double

                  der Wert der Bewertung

                • relative_rating
                  Typ: number | null Format: double

                  relative Bewertung

              • semantic_location
                Typ: string | null

                semantische Position
                gibt das semantische HTML-Element an, in dem sich das Zitat des Ziel-Keywords befindet
                Beispiel:
                article, header

              • sentiment_connotations
                Typ: object | null

                Sentiment-Konnotationen
                enthält Stimmungen (emotionale Reaktionen) in Bezug auf das jeweilige Zitat sowie den Wahrscheinlichkeitsindex für jede Stimmung
                mögliche Sentiment-Konnotationen: anger, happiness, love, sadness, share, fun

                • propertyName
                  Typ: integer | null Format: int64

                  Signed 64-bit integers (long type).

              • snippet
                Typ: string | null

                Inhalts-Snippet

              • snippet_length
                Typ: integer | null

                Zeichenlänge des Snippets

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

                Social-Media-Engagement-Kennzahlen
                Daten zu Social-Media-Interaktionen im Zusammenhang mit dem Inhalt auf Basis von Website-Einbettungen, die von Social-Media-Plattformen entwickelt und unterstützt werden

                • like_count
                  Typ: integer | null Format: int64

                  Anzahl der Likes

                • type
                  Typ: string | null

                  Elementtyp

              • text_category
                Typ: array integer[] | null

                Textkategorie
                eine vollständige Liste der verfügbaren Kategorien finden Sie im Endpoint Categories

              • title
                Typ: string | null

                Titel des Ergebnisses

            • country
              Typ: string | null

              Ländercode der Domainregistrierung
              eine vollständige Liste der verfügbaren Länder finden Sie im Endpunkt Locations

            • domain
              Typ: string | null

              Domainname

            • domain_rank
              Typ: integer | null

              Rang der domain
              dieser Wert basiert auf Backlink-Daten für die angegebene Domain aus dem DataForSEO Backlink Index;
              domain_rank wird anhand der Methode für das Node-Ranking in einer verknüpften Datenbank berechnet – ein Prinzip aus dem ursprünglichen Google-PageRank-Algorithmus
              Weitere Informationen zu dieser Kennzahl und ihrer Berechnung finden Sie in diesem Help-Center-Artikel

            • fetch_time
              Typ: string | null

              Datum und Uhrzeit, an dem unser Crawler die Seite besucht hat
              im UTC-Format: „yyyy-mm-dd hh-mm-ss +00:00“
              Beispiel:
              2017-01-24 13:20:59 +00:00

            • language
              Typ: string | null

              Hauptsprache der Domain
              eine vollständige Liste der verfügbaren Sprachen finden Sie im Endpunkt Languages

            • main_domain
              Typ: string | null

              Hauptdomain

            • page_category
              Typ: array integer[] | null

              enthält alle relevanten Seitenkategorien
              produkt- und dienstleistungsbezogene Kategorien, die für die Seite relevant sind
              eine vollständige Liste der verfügbaren Kategorien finden Sie im Endpunkt Categories

            • page_types
              Typ: array string[] | null

              Seitentypen

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

              auf der Seite gefundene Bewertungen
              alle auf der Seite anhand von Mikrodaten gefundenen Bewertungen

              • max_rating_value
                Typ: number | null Format: double

                Höchstwert für den Bewertungsnamen

              • name
                Typ: string | null

                Bewertungsname hier finden Sie die folgenden Elemente: Max5, Percents, CustomMax

              • rating_count
                Typ: integer | null Format: int64

                Anzahl der Stimmen

              • rating_value
                Typ: number | null Format: double

                der Wert der Bewertung

              • relative_rating
                Typ: number | null Format: double

                relative Bewertung

            • score
              Typ: number | null

              Zitierungs-Prominenz-Score
              dieser Wert basiert auf url_rank, domain_rank, dem Vorkommen von keyword in title, main_title, url, snippet
              je höher der score, desto wertvoller die zugehörige Zitierung

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

              Social-Media-Engagement-Kennzahlen
              Daten zu Social-Media-Interaktionen im Zusammenhang mit dem Inhalt auf Basis von Website-Einbettungen, die von Social-Media-Plattformen entwickelt und unterstützt werden

              • like_count
                Typ: integer | null Format: int64

                Anzahl der Likes

              • type
                Typ: string | null

                Elementtyp

            • spam_score
              Typ: integer | null

              Backlink-Spam-Score der url
              dieser Wert basiert auf Backlink-Daten für die angegebene URL aus dem DataForSEO Backlink Index;
              Weitere Informationen zur Berechnung dieser Kennzahl finden Sie auf dieser Help-Center-Seite

            • type
              Typ: string | null

              Elementtyp

            • url
              Typ: string | null

              URL, unter der die Zitierung gefunden wurde

            • url_rank
              Typ: integer | null

              Rang der url
              dieser Wert basiert auf Backlink-Daten für die angegebene URL aus dem DataForSEO Backlink Index;
              url_rank wird anhand der Methode für das Node-Ranking in einer verknüpften Datenbank berechnet – ein Prinzip aus dem ursprünglichen Google-PageRank-Algorithmus
              Weitere Informationen zu dieser Kennzahl und ihrer Berechnung finden Sie in diesem Help-Center-Artikel

          • items_count
            Typ: integer | null Format: int64

            die Anzahl der im Array items zurückgegebenen Ergebnisse

          • offset_token
            Typ: string | null

            Offset-Token für nachfolgende Anfragen
            Sie können die in diesem Feld bereitgestellte Zeichenfolge verwenden, um die nachfolgenden Ergebnisse der ursprünglichen Aufgabe abzurufen;
            Hinweis: offset_token-Werte sind für jede nachfolgende Aufgabe eindeutig

          • total_count
            Typ: integer | null Format: int64

            Gesamtmenge 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
Request Example for post/v1/beta/dataforseo/content_analysis/search/live
curl https://openapi.felo.ai/v1/beta/dataforseo/content_analysis/search/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "keyword_fields": {
      "snippet": "logitech"
    },
    "keyword": "logitech",
    "page_type": [
      "ecommerce",
      "news",
      "blogs",
      "message-boards",
      "organization"
    ],
    "search_mode": "as_is",
    "filters": [
      "main_domain",
      "=",
      "reviewfinder.ca"
    ],
    "order_by": [
      "content_info.sentiment_connotations.anger,desc"
    ],
    "limit": 10
  }
]'

{
  "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": [
        {
          "offset_token": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "url": null,
              "domain": null,
              "main_domain": null,
              "url_rank": null,
              "spam_score": null,
              "domain_rank": null,
              "fetch_time": null,
              "country": null,
              "language": null,
              "score": null,
              "page_category": [
                "[Max Depth Exceeded]"
              ],
              "page_types": [
                "[Max Depth Exceeded]"
              ],
              "ratings": [
                "[Max Depth Exceeded]"
              ],
              "social_metrics": [
                "[Max Depth Exceeded]"
              ],
              "content_info": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Erfolgreicher Vorgang

Content Analysis – Search API