Erweiterte Google-Ads-Search-Ergebnisse nach ID abrufen
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Erweiterte Google-Ads-Search-Ergebnisse nach ID abrufen
Ruft ein eingereihtes Google-Ads-Search-Ergebnis anhand von id ab. Gibt keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count und items zurück. Eingebettet in die DataForSEO-Hülle: Daten in tasks[0].result, Ergebnis in tasks[0].status_code – eine abgelehnte Anfrage gibt dennoch HTTP 200 zurück.
Preisreferenz
- Abrechnung: Gemeldete Antwortkosten.
- Referenzschätzung pro Anfrage: USD 0.02.
- Referenz-Kundenmultiplikator: 1.0. Nicht erneut auf einen abgerechneten Kundenbetrag anwenden.
Nur Referenzmetadaten, kein Kontenangebot, kein garantierter Preis und keine Ausgabenobergrenze. Ressourcen-Credits sind keine Felo-Credits. Endgültige Abrechnungen richten sich nach den Felo-Abrechnungsbelegen.
- Typ: object | null · Response36Afe1097B20_SerpGoogleAdsSearchTaskGetAdvancedResponseInfo200
- 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_SerpGoogleAdsSearchTaskGetAdvancedTaskInfo
- 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
- checkTyp: string | null
_url direkte URL zu den Suchmaschinenergebnissen
in diesem Fall entspricht sienull - datetimeTyp: string | null
Datum und Uhrzeit des Eingangs des Ergebnisses
im UTC-Format: „yyyy-mm-dd hh-mm-ss +00:00“
Beispiel:2019-11-15 12:57:46 +00:00 - itemTyp: array (string | null)[] | null
_types Arten von Suchergebnissen in der SERP
enthält die in der SERP gefundenen Arten von Suchergebnissen (items).
mögliche Elementtypen:ads_search - itemsTyp: array (object | null)[] | null
Einträge des Elements
- advertiserTyp: string | null
_id eindeutiger Bezeichner des Werbetreibendenkontos
- creativeTyp: string | null
_id eindeutiger Bezeichner der Anzeige
- firstTyp: string | null
_shown Datum und Uhrzeit, zu denen die Anzeige erstmals eingeblendet wurde
im UTC-Format: “yyyy-mm-dd hh-mm-ss +00:00” - formatTyp: string | null
Format der Anzeige
mögliche Werte:text,image,video - lastTyp: string | null
_shown Datum und Uhrzeit, zu denen die Anzeige zuletzt eingeblendet wurde
im UTC-Format: “yyyy-mm-dd hh-mm-ss +00:00” - previewTyp: object | null · Response36Afe1097B20_PreviewImage
_image Vorschaubild der Anzeige
- heightTyp: integer | null
Höhe des Vorschaubilds
- urlTyp: string | null
Such-URL mit Verfeinerungsparametern
- widthTyp: integer | null Format: int64
Breite des Vorschaubilds
- previewTyp: string | null
_url URL zur Anzeigenvorschau
- rankTyp: integer | null
_absolute absolutes Ranking in der SERP
absolute Position unter allen Elementen in der SERP - rankTyp: integer | null
_group Gruppenrang in der SERP
Position innerhalb einer Gruppe von Elementen mit identischentype-Werten
Positionen von Elementen mit anderentype-Werten werden ausrank_groupausgelassen - titleTyp: string | null
Titel des Elements
- typeTyp: string | null
Elementtyp
- urlTyp: string | null
Such-URL mit Verfeinerungsparametern
- verifiedTyp: boolean | null
verifiziertes Werbetreibendenkonto
entsprichttrue, wenn das Werbetreibendenkonto von Google Ads verifiziert ist
- itemsTyp: integer | null Format: int64
_count die Anzahl der im
items-Array zurückgegebenen Ergebnisse - keywordTyp: string | null
Keyword, das in einem POST-Array empfangen wurde
das Keyword wird mit dekodierten %## zurückgegeben (das Pluszeichen '+' wird in ein Leerzeichen dekodiert) - languageTyp: string | null
_code Sprachcode in einem POST-Array
- locationTyp: integer | null
_code Standortcode in einem POST-Array
- refinementTyp: object | null · Response36Afe1097B20_RefinementChipsInfo
_chips Suchverfeinerungs-Chips
- itemsTyp: array (object | null)[] | null
Einträge des Elements
- domainTyp: string | null
Domain in der SERP
- optionsTyp: array (object | null)[] | null
weitere Optionen zur Suchverfeinerung
- domainTyp: string | null
Domain in der SERP
- titleTyp: string | null
Titel des Elements
- typeTyp: string | null
Elementtyp
- urlTyp: string | null
Such-URL mit Verfeinerungsparametern
- titleTyp: string | null
Titel des Elements
- typeTyp: string | null
Elementtyp
- urlTyp: string | null
Such-URL mit Verfeinerungsparametern
- typeTyp: string | null
Elementtyp
- xpathTyp: string | null
der XPath des Elements
- seTyp: string | null
_domain Suchmaschinen-Domain in einem POST-Array
- seTyp: integer | null Format: int64
_results _count Gesamtzahl der Ergebnisse in der SERP
- spellTyp: object | null · Response36Afe1097B20_SpellInfo
Autokorrektur der Suchmaschine
wenn die Suchmaschine Ergebnisse für ein korrigiertes Keyword geliefert hat, geben wir das von der Suchmaschine korrigierte Keyword und die Art der Autokorrektur an;
in diesem Fall entspricht sienull- keywordTyp: string | null
Keyword, das durch die Autokorrektur der Suchmaschine ermittelt wurde die Ergebnisse werden für das korrigierte Keyword bereitgestellt
- typeTyp: string | null
Art der Autokorrektur mögliche Werte: did_you_mean, showing_results_for, no_results_found_for, including_results_for Hinweis: Yahoo und Yandex unterstützen nur die folgende Autokorrekturart: including_results_for
- 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/serp/google/ads_search/task_get/advanced/00000000-0000-0000-0000-000000000000 \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"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": [
{
"keyword": null,
"type": null,
"se_domain": null,
"location_code": null,
"language_code": null,
"check_url": null,
"datetime": null,
"spell": {
"keyword": null,
"type": null
},
"refinement_chips": {
"type": null,
"xpath": null,
"items": [
"[Max Depth Exceeded]"
]
},
"item_types": [
null
],
"se_results_count": null,
"items_count": null,
"items": [
{
"type": null,
"rank_group": null,
"rank_absolute": null,
"advertiser_id": null,
"creative_id": null,
"title": null,
"url": null,
"verified": null,
"format": null,
"preview_image": "[Max Depth Exceeded]",
"preview_url": null,
"first_shown": null,
"last_shown": null
}
]
}
]
}
]
}