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

Content Analysis: Bewertungsverteilung

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: Bewertungsverteilung

​

Teilt die Zitate eines Keywords in Bewertungsstufen auf und meldet für jede den vollständigen Metriksatz. Gibt einen Eintrag pro Stufe mit min, max und einem metrics-Objekt zurück, das total_count, rank, top_domains (jeweils domain und count), sentiment_connotations (anger, happiness, love, sadness, share, fun), connotation_types (positive, negative, neutral), text_categories, page_categories, page_types, countries und languages enthält. rank_scale bestimmt die Einteilung der Stufen. Für dieselben Metriken ohne Stufen verwenden Sie post_dataforseo_content_summary_live; nur für das Sentiment post_dataforseo_content_sentiment_analysis_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)[]
    • initial_dataset_filters
      Typ: array (object | null)[] | null

      Filterparameter für den Ausgangsdatensatz
      Optionales Feld
      Filterparameter, die auf Felder im Search-Endpunkt angewendet werden
      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, has, has_not, match, not_match
      Mit dem Operator % in like und not_like können Sie beliebige Zeichenfolgen mit null oder mehr Zeichen abgleichen
      Beispiel:
      ["domain","<>", "logitech.com"]

      [["domain","<>","logitech.com"],"and",["content_info.connotation_types.negative",">",1000]]

      [["domain","<&gt","logitech.com"]],
      "and",
      [["content_info.connotation_types.negative",">",1000],
      "or",

      ["content_info.text_category","has",10994]]]
      Weitere Informationen zu Filtern finden Sie unter Content Analysis API - Filters
      Mehr zu den Filtern des Ausgangsdatensatzes erfahren Sie in diesem Help-Center-Artikel.

      Leeres Objekt
    • internal_list_limit
      Typ: integer | null

      maximale Anzahl von Elementen in internen Arrays
      Optionales Feld
      Mit diesem Feld begrenzen Sie die Anzahl der Elemente in den folgenden Arrays:
      top_domains
      text_categories
      page_categories
      countries
      languages
      Standardwert: 1
      Höchstwert: 20

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

    • positive_connotation_threshold
      Typ: number | null

      Schwellenwert für positive Konnotation
      Optionales Feld
      angegeben als Wahrscheinlichkeitsindex-Schwellenwert für positive Stimmung in Bezug auf den Zitatinhalt
      Wenn Sie dieses Feld angeben, enthält das Objekt connotation_types in der Antwort nur Daten zu Zitaten, deren Wahrscheinlichkeit für positive Stimmung größer oder gleich dem angegebenen Wert ist
      mögliche Werte: von 0 bis 1
      Standardwert: 0.4

    • rank_scale
      Typ: string | null

      definiert die Skala zur Berechnung und Anzeige der Werte 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

    • sentiments_connotation_threshold
      Typ: number | null

      Schwellenwert für Stimmungskonnotation
      Optionales Feld
      angegeben als Wahrscheinlichkeitsindex-Schwellenwert für Stimmungskonnotationen in Bezug auf den Zitatinhalt
      Wenn Sie dieses Feld angeben, enthält das Objekt sentiment_connotations in der Antwort nur Daten zu Zitaten, bei denen die Wahrscheinlichkeit für jede Stimmung größer oder gleich dem angegebenen Wert ist
      mögliche Werte: von 0 bis 1
      Standardwert: 0.4

    • 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_ContentAnalysisRatingDistributionLiveResponseInfo
    • 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_ContentAnalysisRatingDistributionLiveTaskInfo
        • 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

          • max
            Typ: number | null

            maximale Bewertung auf einer Verteilungsskala

          • metrics
            Typ: object | null · Response36Afe1097B20_ContentAnalysisSummaryInfo

            enthält Kennzahlen zur Bewertungsverteilung

            • connotation_types
              Typ: object | null

              Konnotationstypen
              enthält Typen von Stimmungen (Sentiment-Polarität) zur Zitierung des Keywords und die Anzahl der Zitierungen pro Stimmungstyp
              mögliche Sentiment-Konnotationstypen: positive, negative, neutral

              • propertyName
                Typ: integer | null Format: int64

                Signed 64-bit integers (long type).

            • countries
              Typ: object | null

              Länder
              enthält Länder und die Anzahl der Zitierungen in jedem Land
              eine vollständige Liste der verfügbaren Länder finden Sie im Endpunkt Locations

              • propertyName
                Typ: integer | null Format: int64

                Signed 64-bit integers (long type).

            • languages
              Typ: object | null

              Sprachen
              enthält Sprachen und die Anzahl der Zitierungen in jeder Sprache
              eine vollständige Liste der verfügbaren Sprachen finden Sie im Endpunkt Languages

              • propertyName
                Typ: integer | null Format: int64

                Signed 64-bit integers (long type).

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

              Seitenkategorien
              enthält Objekte mit Seitenkategorien und der Anzahl der Zitierungen in jeder Seitenkategorie
              eine vollständige Liste der verfügbaren Kategorien finden Sie im Endpunkt Categories

              • category
                Typ: array (integer | null)[] | null
              • count
                Typ: integer | null Format: int64

                Signed 64-bit integers (long type).

            • page_types
              Typ: object | null

              Seitentypen
              enthält Seitentypen und die Anzahl der Zitierungen pro Seitentyp

              • propertyName
                Typ: integer | null Format: int64

                Signed 64-bit integers (long type).

            • rank
              Typ: integer | null

              Rang aller URLs, die das keyword zitieren
              normalisierte Summe der Ränge aller URLs, die das Ziel-keyword zitieren

            • sentiment_connotations
              Typ: object | null

              Sentiment-Konnotationen
              enthält Stimmungen (emotionale Reaktionen) zur Zitierung des Zielkeywords und die Anzahl der Zitierungen pro Stimmung
              mögliche Sentiment-Konnotationen: anger, happiness, love, sadness, share, fun

              • propertyName
                Typ: integer | null Format: int64

                Signed 64-bit integers (long type).

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

              Textkategorien
              enthält Objekte mit Textkategorien und der Anzahl der Zitierungen in jeder Textkategorie
              eine vollständige Liste der verfügbaren Kategorien finden Sie im Endpunkt Categories

              • category
                Typ: array (integer | null)[] | null
              • count
                Typ: integer | null Format: int64

                Signed 64-bit integers (long type).

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

              Top-Domains, die das Zielkeyword zitieren
              enthält Objekte mit den Top-Domains, die das Zielkeyword zitieren, und der Anzahl der Zitierungen pro Domain

              • count
                Typ: integer | null Format: int64

                Signed 64-bit integers (long type).

              • domain
                Typ: string | null
            • total_count
              Typ: integer | null Format: int64

              Gesamtmenge der für Ihre Anfrage relevanten Ergebnisse in unserer Datenbank

            • type
              Typ: string | null

              Elementtyp

          • min
            Typ: number | null

            minimale Bewertung auf einer Verteilungsskala

          • 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/content_analysis/rating_distribution/live
curl https://openapi.felo.ai/v1/beta/dataforseo/content_analysis/rating_distribution/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "keyword": "logitech",
    "search_mode": "as_is",
    "internal_list_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": [
        {
          "type": null,
          "min": null,
          "max": null,
          "metrics": {
            "type": null,
            "total_count": null,
            "rank": null,
            "top_domains": [
              "[Max Depth Exceeded]"
            ],
            "sentiment_connotations": null,
            "connotation_types": null,
            "text_categories": [
              "[Max Depth Exceeded]"
            ],
            "page_categories": [
              "[Max Depth Exceeded]"
            ],
            "page_types": null,
            "countries": null,
            "languages": null
          }
        }
      ]
    }
  ]
}

Erfolgreicher Vorgang

Content Analysis – Rating Distribution API