DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Content Analysis: Phrasentrends
Die Zusammenfassungsmetriken für ein Keyword, wiederholt pro Zeitraum. Jeder Eintrag enthält 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. date_from, date_to und date_group (day, week, month) legen Zeitraum und Granularität fest. Damit sehen Sie, ob Erwähnungen einer Phrase zu- oder abnehmen; für einen einzelnen Zeitpunkt verwenden Sie post_dataforseo_content_summary_live. Um eine ganze Produktkategorie statt einer einzelnen Phrase zu verfolgen, verwenden Sie post_dataforseo_content_category_trends_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.
- Typ: array (object | null)[]
- dateTyp: string
_from Startdatum des Zeitraums
Pflichtfeld
Datumsformat:"yyyy-mm-dd"
Beispiel:"2019-01-15" - dateTyp: string | null
_group Zeitraum, nach dem die Ergebnisse gruppiert werden
Optionales Feld
Standardwert:month
mögliche Werte:day,week,month - dateTyp: string | null
_to 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" - initialTyp: array (object | null)[] | null
_dataset _filters 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 Operatorandoderor;
Die folgenden Operatoren werden unterstützt:regex,not_regex,<,<=,>,>=,=,<>,in,not_in,like,not_like,has,has_not,match,not_match
Mit dem Operator%inlikeundnot_likekö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","<>","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 - internalTyp: integer | null
_list _limit maximale Anzahl von Elementen in internen Arrays
Optionales Feld
Mit diesem Feld begrenzen Sie die Anzahl der Elemente in den folgenden Arrays:top_domainstext_categoriespage_categoriescountrieslanguages
Standardwert:1
Höchstwert:20 - keywordTyp: 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
keywordundkeywordsin DataForSEO-APIs finden Sie in diesem Help-Center-Artikel - keywordTyp: object | null
_fields 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>}- propertyTyp: string | null
Name
- pageTyp: array string[] | null
_type Zielseitentypen
Optionales Feld
Mit diesem Parameter filtern Sie den Datensatz nach Seitentypen
mögliche Werte:"ecommerce","news","blogs","message-boards","organization" - rankTyp: string | null
_scale definiert die Skala zur Berechnung und Anzeige der Werte
rank
Optionales FeldMit 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 angezeigtone_thousand— Rangwerte werden auf einer Skala von 0–1000 angezeigtStandardwert:
one_thousandWeitere Informationen zur Funktionsweise dieses Parameters finden Sie in diesem Help-Center-Artikel
- searchTyp: string | null
_mode Gruppierungstyp der Ergebnisse
Optionales Feld
mögliche Gruppierungstypen:as_is- gibt Daten zu allen Zitaten für das Ziel-keywordzurückone_per_domain- gibt Daten zu einem Zitat deskeywordpro Domain zurück
Standardwert:as_is - tagTyp: string | null
Benutzerdefinierte Aufgaben-ID
Optionales Feld
Zeichenlimit: 255
Mit diesem Parameter können Sie die Aufgabe identifizieren und dem Ergebnis zuordnen
Den angegebenen Werttagfinden Sie imdata-Objekt der Antwort
- Typ: object | null · Response36Afe1097B20_ContentAnalysisPhraseTrendsLiveResponseInfo200
- Typ: number | null Format: doublecost
Gesamtkosten der Aufgaben in USD
- Typ: integer | nullstatus
_code allgemeiner Statuscode die vollständige Liste der Antwortcodes finden Sie hier
- Typ: string | nullstatus
_message allgemeine Informationsmeldung die vollständige Liste der allgemeinen Informationsmeldungen finden Sie hier
- Typ: array (object | null)[] | nulltasks
Array von Aufgaben
- Typ: object | null · Response36Afe1097B20_ContentAnalysisPhraseTrendsLiveTaskInfo
- costTyp: number | null Format: double
Gesamtkosten der Aufgaben in USD
- dataTyp: object | null
Enthält dieselben Parameter, die Sie in der POST-Anfrage angegeben haben
- propertyTyp: object | null
Name
- idTyp: string | null
Aufgaben-ID eindeutige Aufgaben-ID in unserem System im UUID-Format
- pathTyp: array (string | null)[] | null
URL-Pfad
- resultTyp: array (object | null)[] | null
Array von Ergebnissen
- connotationTyp: object | null
_types Konnotationstypen
enthält Typen von Stimmungen (Sentiment-Polarität) zur Zitierung des Keywords und die Anzahl der Zitierungen pro Stimmungstyp
mögliche Konnotationstypen:"positive","negative","neutral"- propertyTyp: integer | null Format: int64
Name Signed 64-bit integers (long type).
- countriesTyp: object | null
- propertyTyp: integer | null Format: int64
Name Signed 64-bit integers (long type).
- dateTyp: string | null
Datum, für das die Daten bereitgestellt werden
- languagesTyp: object | null
- propertyTyp: integer | null Format: int64
Name Signed 64-bit integers (long type).
- pageTyp: array (object | null)[] | null
_categories - categoryTyp: array (integer | null)[] | null
- countTyp: integer | null Format: int64
Signed 64-bit integers (long type).
- pageTyp: object | null
_types Seitentypen
enthält Seitentypen und die Anzahl der Zitierungen pro Seitentyp- propertyTyp: integer | null Format: int64
Name Signed 64-bit integers (long type).
- rankTyp: integer | null
Rang aller URLs, die das
keywordzitieren
normalisierte Summe der Ränge aller URLs, die das Ziel-keywordfür das angegebene Datum zitieren - sentimentTyp: object | null
_connotations Sentiment-Konnotationen
enthält Stimmungen (emotionale Reaktionen) zur Zitierung des Zielkeywords und die Anzahl der Zitierungen pro Stimmung
mögliche Konnotationen:"anger","happiness","love","sadness","share","fun"- propertyTyp: integer | null Format: int64
Name Signed 64-bit integers (long type).
- textTyp: array (object | null)[] | null
_categories - categoryTyp: array (integer | null)[] | null
- countTyp: integer | null Format: int64
Signed 64-bit integers (long type).
- topTyp: array (object | null)[] | null
_domains Top-Domains, die das Zielkeyword zitieren
enthält Objekte mit den Top-Domains, die das Zielkeyword zitieren, und der Anzahl der Zitierungen pro Domain- countTyp: integer | null Format: int64
Signed 64-bit integers (long type).
- domainTyp: string | null
- totalTyp: integer | null Format: int64
_count Gesamtzahl der für Ihre Anfrage relevanten Ergebnisse in unserer Datenbank
- typeTyp: string | null
Elementtyp
- resultTyp: integer | null Format: int64
_count Anzahl der Elemente im Ergebnis-Array
- statusTyp: integer | null
_code Statuscode der Aufgabe von DataForSEO erzeugt, kann im folgenden Bereich liegen: 10000-60000 die vollständige Liste der Antwortcodes finden Sie hier
- statusTyp: string | null
_message Informationsmeldung der Aufgabe die vollständige Liste der allgemeinen Informationsmeldungen finden Sie hier
- timeTyp: string | null
Ausführungszeit in Sekunden
- Typ: integer | null Format: int64tasks
_count Die Anzahl der Aufgaben im tasks-Array
- Typ: integer | null Format: int64tasks
_error Die Anzahl der Aufgaben im tasks-Array, die mit einem Fehler zurückgegeben wurden
- Typ: string | nulltime
Gesamtausführungszeit, Sekunden
- Typ: string | nullversion
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
curl https://openapi.felo.ai/v1/beta/dataforseo/content_analysis/phrase_trends/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"keyword": "logitech",
"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
}
]
}
]
}