v0.2.0-beta

OpenAPI 3.1.0

Aufgaben für „Ad Traffic By Keywords“ einstellen

Felo API Support

MIT

Server

https://openapi.felo.ai

Client-Bibliotheken

Shell Curl

DataForSEO

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

DataForSEO Operationen

post/v1/beta/dataforseo/keywords_data/google_ads/ad_traffic_by_keywords/task_post

Aufgaben für „Ad Traffic By Keywords“ einstellen

Stellt eine Prognose von Klicks, Impressionen und Ausgaben für keywords bei einem bestimmten bid und match-Typ in die Warteschlange und gibt eine Aufgaben-id zurück. search_partners schließt Googles Partnernetzwerk ein. 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. Dies ist der einzige Google Ads-Endpunkt hier ohne Live-Variante – Prognosen laufen immer über die Warteschlange. Rufen Sie mit get_dataforseo_keywords_gads_ad_traffic_fetch ab.

Preisreferenz

Abrechnung: Gemeldete Antwortkosten.
Referenzschätzung pro Anfrage: USD 0.09.
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)[]
- bid
  Typ: number
  
  maximales benutzerdefiniertes Gebot
  Pflichtfeld
  Die erhobenen Daten basieren auf diesem Wert
  Er steht für den Preis, den Sie für eine Anzeige zu zahlen bereit sind; je höher der hier angegebene Wert, desto höher die Werte in den zurückgegebenen Kennzahlen
  Weitere Informationen finden Sie in diesem Help-Center-Artikel
- date_from
  Typ: string
  
  Startdatum des Prognosezeitraums
  Pflichtfeld, wenn Sie date_to angeben
  Wenn Sie date_from und date_to angeben, müssen Sie date_interval nicht angeben
  Der Mindestwert ist das morgige Datum
  Der in date_from angegebene Wert darf nicht weiter als date_to entfernt sein
  Datumsformat: "yyyy-mm-dd"
  Beispiel:
  "2021-10-30"Wenn Status-Endpunkt im Feld actual_data den Wert false zurückgibt, kann date_from auf den vorletzten Monat und früher gesetzt werden;
  wenn Status-Endpunkt im Feld actual_data den Wert true zurückgibt, kann date_from auf den letzten Monat und früher gesetzt werden
- date_interval
  Typ: string | null
  
  Datumsintervall der Prognose
  Optionales Feld
  Wenn Sie date_interval angeben, müssen Sie date_from und date_to nicht angeben
  mögliche Werte: next_week, next_month, next_quarter
  Standardwert: next_month
- date_to
  Typ: string
  
  Enddatum des Prognosezeitraums
  Pflichtfeld, wenn Sie date_from angeben
  Wenn Sie date_from und date_to angeben, müssen Sie date_interval nicht angeben
  Der Mindestwert ist date_from +1 Tag
  Der Höchstwert ist der aktuelle Tag und Monat des nächsten Jahres
  Datumsformat: "yyyy-mm-dd"
  Beispiel:
  "2022-10-30"
- keywords
  Typ: array string[]
  
  Keywords
  Pflichtfeld
  Maximale Anzahl der Keywords, die Sie angeben können: 1000
  Maximale Anzahl der Zeichen pro Keyword: 80
  Maximale Anzahl der Wörter pro Keyword-Phrase: 10
  Die von Ihnen angegebenen Keywords werden in Kleinbuchstaben umgewandelt
  Hinweis Nr. 1: Google Ads liefert möglicherweise keine Daten für bestimmte Keyword-Gruppen;
  Hinweis Nr. 2: Google Ads liefert kombinierte Suchvolumenwerte für Gruppen ähnlicher Keywords
  Um das Suchvolumen für ähnliche Keywords zu erhalten, empfehlen wir, solche Keywords in separaten Anfragen zu übermitteln;
  Hinweis Nr. 3: Google Ads erlaubt die Verwendung bestimmter Symbole und Zeichen nicht (z. B. UTF-Symbole, Emojis), daher können Sie sie beim Einstellen einer Aufgabe nicht verwenden;
  Weitere Informationen zu den zulässigen Symbolen und Zeichen finden Sie in diesem Artikel
  
  Weitere Informationen zu Regeln und Einschränkungen der Felder keyword und keywords in DataForSEO-APIs finden Sie in diesem Help-Center-Artikel
- language_code
  Typ: string | null
  
  Sprachcode der Suchmaschine
  Optionales Feld
  Die Liste der verfügbaren Sprachen der Suchmaschine mit ihrem language_code erhalten Sie durch eine separate Anfrage an https://api.dataforseo.com/v3/keywords_data/google_ads/languages
  Beispiel:
  en
- language_name
  Typ: string | null
  
  Vollständiger Name der Suchmaschinensprache
  Optionales Feld
  Die Liste der verfügbaren Sprachen der Suchmaschine mit ihrem language_name erhalten Sie durch eine separate Anfrage an https://api.dataforseo.com/v3/keywords_data/google_ads/languages
  Beispiel:
  English
- location_code
  Typ: integer | null
  
  Standortcode der Suchmaschine
  Optionales Feld
  Wenn Sie den Standort nicht angeben, erhalten Sie weltweite Ergebnisse, d. h. für alle verfügbaren Standorte;
  Wenn Sie dieses Feld verwenden, müssen Sie location_name oder location_coordinate nicht angeben;
  Die Liste der verfügbaren Standorte der Suchmaschinen mit ihrem location_code erhalten Sie durch eine separate Anfrage an https://api.dataforseo.com/v3/keywords_data/google_ads/locations
  Beispiel:
  2840
- location_coordinate
  Typ: string | null
  
  GPS-Koordinaten eines Standorts
  Optionales Feld
  Wenn Sie den Standort nicht angeben, erhalten Sie weltweite Ergebnisse, d. h. für alle verfügbaren Standorte;
  Wenn Sie dieses Feld verwenden, müssen Sie location_name oder location_code nicht angeben;
  Der Parameter location_coordinate muss im Format "latitude,longitude" angegeben werden;
  Die Daten werden für das Land bereitgestellt, zu dem die angegebenen Koordinaten gehören;
  Beispiel:
  52.6178549,-155.352142
- location_name
  Typ: string | null
  
  Vollständiger Name des Suchmaschinenstandorts
  Optionales Feld
  Wenn Sie den Standort nicht angeben, erhalten Sie weltweite Ergebnisse, d. h. für alle verfügbaren Standorte;
  Wenn Sie dieses Feld verwenden, müssen Sie location_code oder location_coordinate nicht angeben
  Die Liste der verfügbaren Standorte der Suchmaschine mit ihrem location_name erhalten Sie durch eine separate Anfrage an https://api.dataforseo.com/v3/keywords_data/google_ads/locations
  Beispiel:
  London,England,United Kingdom
- match
  Typ: string
  
  Keyword-Übereinstimmungstyp
  Pflichtfeld
  kann folgende Werte annehmen: exact, broad, phrase
- pingback_url
  Typ: string | null
  
  Benachrichtigungs-URL für eine abgeschlossene Aufgabe
  Optionales Feld
  Wenn eine Aufgabe abgeschlossen ist, benachrichtigen wir Sie per GET-Anfrage an die von Ihnen angegebene URL
  Sie können die Zeichenfolge ‘$id’ als $id-Variable und ‘$tag’ als URL-kodierte $tag-Variable verwenden. Wir setzen die erforderlichen Werte vor dem Senden der Anfrage.
  Beispiel:
  http://your-server.com/pingscript?id=$id
  http://your-server.com/pingscript?id=$id&tag=$tag
  Hinweis: Sonderzeichen in pingback_url werden URL-kodiert;
  d. h. das Zeichen # wird zu %23 kodiert
  
  Weitere Informationen finden Sie in unserem Help Center
- postback_url
  Typ: string | null
  
  URL zum Senden von Aufgabenergebnissen
  Optionales Feld
  Sobald die Aufgabe abgeschlossen ist, senden wir eine POST-Anfrage mit den im gzip-Format komprimierten Ergebnissen an die von Ihnen angegebene postback_url
  Sie können die Zeichenfolge ‘$id’ als $id-Variable und ‘$tag’ als URL-kodierte $tag-Variable verwenden. Wir setzen die erforderlichen Werte vor dem Senden der Anfrage.
  Beispiel:
  http://your-server.com/postbackscript?id=$id
  http://your-server.com/postbackscript?id=$id&tag=$tag
  Hinweis: Sonderzeichen in postback_url werden URL-kodiert;
  d. h. das Zeichen # wird zu %23 kodiert
  
  Weitere Informationen finden Sie in unserem Help Center
- sort_by
  Typ: string | null
  
  Sortierparameter für Ergebnisse
  Optionales Feld
  Mit diesen Parametern sortieren Sie die Ergebnisse nach relevance, average_cpc, cost oder clicks in absteigender Reihenfolge
  Standardwert: relevance
- 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_KeywordsDataGoogleAdsAdTrafficByKeywordsTaskPostResponseInfo
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_KeywordsDataGoogleAdsAdTrafficByKeywordsTaskPostTaskInfo
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: object | null

Array von Ergebnissen
in diesem Fall ist der Wert null

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

post/v1/beta/dataforseo/keywords_data/google_ads/ad_traffic_by_keywords/task_post

curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/google_ads/ad_traffic_by_keywords/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "bid": 999,
    "match": "exact",
    "keywords": [
      "seo marketing"
    ]
  }
]'

Schema anzeigen

{
  "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": null
    }
  ]
}

Erfolgreicher Vorgang

Aufgaben für „Ad Traffic By Keywords“ einstellen

AuthentifizierungRequired

DataForSEO

Aufgaben für „Ad Traffic By Keywords“ einstellen

Preisreferenz