DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Live: erweiterte Google-Ads-Suche
Gibt die Anzeigen zurück, die für ein Keyword bei Google ausgeliefert werden, synchron. Gibt keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count und items zurück. advanced ist die Standardwahl; nehmen Sie regular, wenn nur die Rangliste zählt, und html nur, um zu prüfen, was der Parser verworfen hat. 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: array object[]
- advertiserTyp: array string[]
_ids erforderlichAdvertiser-IDs; erforderlich, wenn target nicht angegeben ist
- locationTyp: integer
_code Standortcode der Suchmaschine
- locationTyp: string
_coordinate GPS-Koordinaten eines Standorts
- locationTyp: string
_name Vollständiger Name des Suchmaschinen-Standorts
- targetTyp: string
Domainname des Advertiser-Kontos; erforderlich, wenn advertiser_ids nicht angegeben ist
- Typ: object200
Erfolgreiche Antwort
- Typ: numbercost
Gesamtkosten der Aufgaben, USD
- Typ: integerstatus
_code Allgemeiner Statuscode
- Typ: stringstatus
_message Allgemeine Informationsmeldung
- Typ: array string[]tasks
Array der Aufgaben
- Typ: array string[]tasks[]
.result Array der Live-SERP-Ergebnisse
- Typ: stringtime
Ausführungszeit, Sekunden
- Typ: stringversion
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/live/advanced \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{}
]'
{
"version": "string",
"status_code": 1,
"status_message": "string",
"time": "string",
"cost": 1,
"tasks": [
"string"
],
"tasks[].result": [
"string"
]
}