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

Content Analysis: Kategorietrends

Server:https://openapi.felo.ai
Client-Bibliotheken

DataForSEO

​

SEO, search-engine results, keyword research, backlinks and AI visibility data.

Content Analysis: Kategorietrends

​

Dieselben Metriken pro Zeitraum wie post_dataforseo_content_phrase_trends_live, aber für eine gesamte Produktkategorie statt für ein einzelnes Keyword. Bezieht category_code aus get_dataforseo_content_categories, wobei date_from, date_to und date_group Zeitraum und Granularität festlegen, und gibt pro Zeitraum ein date sowie 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 zurück. Damit sehen Sie, wie sich ein Markt bewegt, statt nur eine einzelne Phrase; wechseln Sie zum Phrase-Endpunkt, wenn Sie die genaue Formulierung bereits kennen.

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)[]
    • category_code
      Typ: integer | null

      Zielkategoriecode
      Pflichtfeld
      Eine vollständige Liste der verfügbaren Kategorien finden Sie beim Endpunkt Categories

    • date_from
      Typ: string

      Startdatum des Zeitraums
      Pflichtfeld
      Mindestwert: 2022-10-31
      Datumsformat: "yyyy-mm-dd"
      Beispiel:
      "2019-01-15"

    • date_group
      Typ: string | null

      Zeitraum, nach dem die Ergebnisse gruppiert werden
      Optionales Feld
      Standardwert: month
      mögliche Werte: day, week, month

    • date_to
      Typ: string | null

      Enddatum des Zeitraums
      Optionales Feld
      Wenn Sie dieses Feld nicht angeben, wird standardmäßig das heutige Datum verwendet
      Datumsformat: "yyyy-mm-dd"
      Beispiel:
      "2019-01-15"

    • 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

    • 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 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 Daten zu allen Zitaten für den Ziel-category_code zurück
      one_per_domain - gibt Daten zu einem Zitat des category_code 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_ContentAnalysisCategoryTrendsLiveResponseInfo
    • 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_ContentAnalysisCategoryTrendsLiveTaskInfo
        • 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

          • connotation_types
            Typ: object | null

            Konnotationstypen
            enthält Typen von Stimmungen (Sentiment-Polarität) zur Zitierung der Kategorie und die Anzahl der Zitierungen pro Stimmungstyp
            mögliche 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).

          • date
            Typ: string | null

            Datum, für das die Daten bereitgestellt werden

          • 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 für das angegebene Datum zitieren

          • sentiment_connotations
            Typ: object | null

            Sentiment-Konnotationen
            enthält Stimmungen (emotionale Reaktionen) zur Zitierung der Zielkategorie und die Anzahl der Zitierungen pro Stimmung
            mögliche Konnotationen: "anger", "fear", "happiness", "love", "sadness", "share", "neutral", "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 die Zielkategorie 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

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

          • 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/category_trends/live
curl https://openapi.felo.ai/v1/beta/dataforseo/content_analysis/category_trends/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "category_code": 10994,
    "search_mode": "as_is",
    "date_from": "2022-09-01",
    "date_group": "month"
  }
]'
{
  "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,
          "date": null,
          "total_count": null,
          "rank": null,
          "top_domains": [
            {
              "domain": null,
              "count": null
            }
          ],
          "sentiment_connotations": null,
          "connotation_types": null,
          "text_categories": [
            {
              "category": [
                "[Max Depth Exceeded]"
              ],
              "count": null
            }
          ],
          "page_categories": [
            {
              "category": [
                "[Max Depth Exceeded]"
              ],
              "count": null
            }
          ],
          "page_types": null,
          "countries": null,
          "languages": null
        }
      ]
    }
  ]
}
Content Analysis – Category Trends API