DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Kategorien für eine Domain
Die Themen, in denen eine target-Website rankt, als Googles eigene Kategoriecodes mit dem Footprint der Website in jedem davon. Eingebettet in das DataForSEO-Envelope: Daten in tasks[0].result, Ergebnis in tasks[0].status_code – eine abgelehnte Anfrage liefert weiterhin HTTP 200. Die Gegenrichtung – Keywords für eine von Ihnen benannte Kategorie – ist post_dataforseo_labs_google_keywords_for_categories_live.
Preisreferenz
- Abrechnung: Gemeldete Antwortkosten.
- Referenzschätzung pro Anfrage: USD 0.1356.
- 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)[]
- filtersTyp: array (object | null)[] | null
Array der Filterparameter für Ergebnisse
Optionales Feld
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
Beispiel:["metrics.organic.pos_1,">",0][[["metrics.organic.count",">=",100],"and",["metrics.organic.pos_1",">",0]],
"or",
["metrics.organic.etv","in",[10,100]]]
Weitere Informationen zu Filtern finden Sie unter Dataforseo Labs - Filters oder in dieser Anleitung im Help CenterLeeres Objekt - historicalTyp: string | null
_serp _mode Datenerfassungsmodus
Optionales Feld
Mit diesem Feld können Sie die Ergebnisse filtern;
mögliche Filtertypen:live— Metriken für SERPs zurückgeben, in denen das angegebenetargetaktuell Ranking-Ergebnisse hat;lost— Metriken für SERPs zurückgeben, in denen das angegebenetargetzuvor Ranking-Ergebnisse hatte, sie bei der letzten Prüfung aber nicht mehr hatte;all— Metriken für beide SERP-Typen zurückgeben.
Standardwert:live - includeTyp: boolean | null
_clickstream _data Daten aus clickstream-basierten Metriken in das Ergebnis aufnehmen oder ausschließen
Optionales Feld
wenn der Parameter auftruegesetzt ist, erhalten Sie die Felderclickstream_etv,clickstream_gender_distributionundclickstream_age_distributionmit Clickstream-Daten in der Antwort
Standardwert:false
bei aktiviertem Parameter wird der doppelte Preis für die Anfrage berechnetWeitere Informationen zur Berechnung clickstream-basierter Metriken finden Sie in diesem Help-Center-Artikel
- includeTyp: boolean | null
_subcategories - itemTyp: array string[] | null
_types Ergebnisse nach Elementtyp anzeigen
Optionales Feld
gibt den Typ der in der Antwort enthaltenen Suchergebnisse anHinweis: Enthält das Array
item_typesandere Elementtypen als das Objektorganic, werden die Ergebnisse nach dem ersten Elementtyp im Array geordnet; Ergebnisse, deren Suchresultattyp nicht in der Antwort enthalten ist, können nicht nach Typ sortiert oder gefiltert werden;mögliche Werte:
["organic", "paid", "featured_snippet", "local_pack"]
Standardwert:["organic", "paid"] - languageTyp: string | null
_code Sprachcode
Pflichtfeld, wenn Sielanguage_namenicht angeben
Hinweis: Sie müssen entwederlanguage_nameoderlanguage_codeangeben
Die Liste der verfügbaren Sprachen mitlanguage_codeerhalten Sie durch eine separate Anfrage anhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
Beispiel:en - languageTyp: string
_name vollständiger Name der Sprache
Pflichtfeld, wenn Sielanguage_codenicht angeben
Hinweis: Sie müssen entwederlanguage_nameoderlanguage_codeangeben
Die Liste der verfügbaren Sprachen mitlanguage_nameerhalten Sie durch eine separate Anfrage anhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
Beispiel:English - limitTyp: integer | null
maximale Anzahl der zurückgegebenen Kategorien
Optionales Feld
Standardwert:100
Höchstwert:1000 - locationTyp: integer
_code Standortcode
Pflichtfeld, wenn Sielocation_namenicht angeben
Hinweis: Sie müssen entwederlocation_nameoderlocation_codeangeben
Die Liste der verfügbaren Standorte mitlocation_codeerhalten Sie durch eine separate Anfrage anhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
Beispiel:2840 - locationTyp: string
_name vollständiger Name des Standorts
Pflichtfeld, wenn Sielocation_codenicht angeben
Hinweis: Sie müssen entwederlocation_nameoderlocation_codeangeben
Die Liste der verfügbaren Standorte mitlocation_nameerhalten Sie durch eine separate Anfrage anhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
Beispiel:United Kingdom - offsetTyp: integer | null
Offset im Ergebnisarray der zurückgegebenen Kategorien
Optionales Feld
Standardwert:0
Wenn Sie den Wert10angeben, werden die ersten zehn Kategorien im Ergebnisarray ausgelassen und die Daten für die nachfolgenden Kategorien bereitgestellt - orderTyp: array string[] | null
_by Sortierregeln für Ergebnisse
Optionales Feld
Sie können dieselben Werte wie im Arrayfiltersverwenden, um die Ergebnisse zu sortieren
mögliche Sortierarten:asc– Ergebnisse werden in aufsteigender Reihenfolge sortiertdesc– Ergebnisse werden in absteigender Reihenfolge sortiert
Sie legen eine Sortierart mit einem Komma fest
Beispiel:["metrics.paid.etv,asc"]
Hinweis: Sie können pro Anfrage höchstens drei Sortierregeln festlegen
Mehrere Sortierregeln trennen Sie mit einem Komma
Beispiel:["metrics.organic.etv,desc","metrics.paid.count,asc"]Standardregel:
["metrics.organic.count,desc"]
Hinweis: Enthält das Arrayitem_typesandere Elementtypen als das Objektorganic, werden die Ergebnisse nach dem ersten Elementtyp im Array geordnet - 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 - targetTyp: string
Domain oder Subdomain
Pflichtfeld
der Domain- oder Subdomainname der Zielwebsite
die Domain oder Subdomain geben Sie ohnehttps://undwww.an
- Typ: object | null · Response36Afe1097B20_DataforseoLabsGoogleCategoriesForDomainLiveResponseInfo200
- 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_DataforseoLabsGoogleCategoriesForDomainLiveTaskInfo
- 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
- itemsTyp: array (object | null)[] | null
enthält relevante Kategorien und zugehörige Rankingdaten
- categoriesTyp: array integer[] | null
- metricsTyp: object | null
Rankingdaten zur angegebenen Domain oder Subdomain
- propertyTyp: object · Response36Afe1097B20_DataforseoLabsMetricsInfo
Name - clickstreamTyp: object | null
_age _distribution - propertyTyp: integer | null Format: int64
Name Signed 64-bit integers (long type).
- clickstreamTyp: number | null Format: double
_etv geschätztes Traffic-Volumen auf Basis von Clickstream-Daten
berechnet als Produkt aus Click-Through-Rate und Clickstream-Suchvolumenwerten aller Keywords, für die die Domain rankt
um Ergebnisse für dieses Feld zu erhalten, muss der Parameterinclude_clickstream_dataauftruegesetzt sein
mehr über die Berechnung der Metrik erfahren Sie in diesem Help-Center-Artikel - clickstreamTyp: object | null
_gender _distribution - propertyTyp: integer | null Format: int64
Name Signed 64-bit integers (long type).
- countTyp: integer | null Format: int64
Gesamtzahl der organischen SERPs, die die Domain oder Subdomain enthalten
- estimatedTyp: number | null
_paid _traffic _cost geschätzte Kosten der Umwandlung von organischem Suchtraffic in bezahlten
stellt die geschätzten monatlichen Kosten (USD) für Anzeigen für alle Keywords in der Kategorie dar, für die die Domain oder Subdomain rankt
die Metrik wird als Produkt der organischenetv- und der bezahltencpc-Werte berechnet und gibt die Kosten an, das geschätzte monatliche organische Traffic-Volumen über PPC-Werbung in der Google-Suche zu erzielen
mehr über die Berechnung der Metrik erfahren Sie in diesem Help-Center-Artikel - etvTyp: number | null
geschätztes Traffic-Volumen
geschätzter organischer monatlicher Traffic zur Domain oder Subdomain
berechnet als Produkt aus CTR (Click-Through-Rate) und Suchvolumenwerten aller Keywords in der Kategorie, für die die Domain oder Subdomain rankt
mehr über die Berechnung der Metrik erfahren Sie in diesem Help-Center-Artikel - isTyp: integer | null
_down Rang gesunken
gibt an, wie viele gerankte Elemente des angegebenen Ziels gesunken sind - isTyp: integer | null
_lost verlorene gerankte Elemente
gibt an, wie viele gerankte Elemente des angegebenen Ziels zuvor in SERPs erschienen sind, aber bei der letzten Prüfung nicht gefunden wurden - isTyp: integer | null
_new Anzahl neuer gerankter Elemente
gibt an, wie viele neue gerankte Elemente für das angegebene Ziel gefunden wurden - isTyp: integer | null
_up Rang gestiegen
gibt an, wie viele gerankte Elemente des angegebenen Ziels gestiegen sind - posTyp: integer | null
_1 Anzahl organischer SERPs, in denen die Domain oder Subdomain auf Platz 1 rangt
- posTyp: integer | null
_11 _20 Anzahl organischer SERPs, in denen die Domain oder Subdomain auf Platz 11–20 rangt
- posTyp: integer | null
_2 _3 Anzahl organischer SERPs, in denen die Domain oder Subdomain auf Platz 2–3 rangt
- posTyp: integer | null
_21 _30 Anzahl organischer SERPs, in denen die Domain oder Subdomain auf Platz 21–30 rangt
- posTyp: integer | null
_31 _40 Anzahl organischer SERPs, in denen die Domain oder Subdomain auf Platz 31–40 rangt
- posTyp: integer | null
_4 _10 Anzahl organischer SERPs, in denen die Domain oder Subdomain auf Platz 4–10 rangt
- posTyp: integer | null
_41 _50 Anzahl organischer SERPs, in denen die Domain oder Subdomain auf Platz 41–50 rangt
- posTyp: integer | null
_51 _60 Anzahl organischer SERPs, in denen die Domain oder Subdomain auf Platz 51–60 rangt
- posTyp: integer | null
_61 _70 Anzahl organischer SERPs, in denen die Domain oder Subdomain auf Platz 61–70 rangt
- posTyp: integer | null
_71 _80 Anzahl organischer SERPs, in denen die Domain oder Subdomain auf Platz 71–80 rangt
- posTyp: integer | null
_81 _90 Anzahl organischer SERPs, in denen die Domain oder Subdomain auf Platz 81–90 rangt
- posTyp: integer | null
_91 _100 Anzahl organischer SERPs, in denen die Domain oder Subdomain auf Platz 91–100 rangt
- seTyp: string | null
_type Typ der Suchmaschine
- itemsTyp: integer | null Format: int64
_count die Anzahl der im Array
itemszurückgegebenen Ergebnisse - languageTyp: string | null
_code Sprachcode in einem POST-Array
- locationTyp: integer | null
_code Standortcode in einem POST-Array
- seTyp: string | null
_type Typ der Suchmaschine
- targetTyp: string | null
Ziel-Domain oder Subdomain in einem POST-Array
- totalTyp: integer | null Format: int64
_count Gesamtmenge der für Ihre Anfrage relevanten Ergebnisse in unserer Datenbank
- 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/dataforseo_labs/google/categories_for_domain/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"target": "dataforseo.com",
"language_code": "en",
"location_name": "United States",
"item_types": [
"paid",
"organic",
"featured_snippet",
"local_pack"
],
"limit": 3
}
]'
{
"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": [
{
"se_type": null,
"target": null,
"location_code": null,
"language_code": null,
"total_count": null,
"items_count": null,
"items": [
{
"se_type": null,
"categories": [
"[Max Depth Exceeded]"
],
"metrics": null
}
]
}
]
}
]
}