Felo API PlatformFelo API Platform
Alle Endpoints von DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Ergebnisse für „Ads Traffic By Keywords“ nach ID abrufen

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

Ergebnisse für „Ads Traffic By Keywords“ nach ID abrufen

​

Ruft eine in die Warteschlange gestellte Google Ads-Traffic-Prognose anhand von id ab: prognostizierte Impressionen, Klicks, Kosten und durchschnittliche Position für das angegebene Gebot. 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. Anders als die Volumen-Endpunkte ist dies eine Prognose, keine Messung – die Zahlen ändern sich mit bid und match.

Preisreferenz

  • Abrechnung: Gemeldete Antwortkosten.
  • Referenzschätzung pro Anfrage: USD 0.012.
  • 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.

Pfadparameter
  • id
    Typ: string
    erforderlich

    Aufgaben-ID
    eindeutige Aufgaben-ID in unserem System im UUID-Format
    Sie können sie 30 Tage lang verwenden, um die Ergebnisse der Aufgabe jederzeit abzurufen

Antworten
  • 200
    Typ: object | null · Response36Afe1097B20_KeywordsDataGoogleAdsAdTrafficByKeywordsTaskGetResponseInfo
    • 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_KeywordsDataGoogleAdsAdTrafficByKeywordsTaskGetTaskInfo
        • 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: array (object | null)[] | null

          Array von Ergebnissen

          • average_cpc
            Typ: number | null Format: double

            der durchschnittliche Kosten-pro-Klick-Wert
            stellt die für ein Keyword geschätzten Kosten pro Klick (USD) auf Basis des angegebenen Zeitraums und historischer Daten dar;
            liegen keine Daten vor, ist der Wert null

          • bid
            Typ: number | null

            das maximale benutzerdefinierte Gebot
            das Gebot, das Sie beim Anlegen der Aufgabe angegeben haben
            stellt den Preis dar, den Sie für eine Anzeige zu zahlen bereit sind
            je höher der angegebene Wert, desto höhere Metriken und Kosten erhalten Sie in der Antwort
            mehr erfahren Sie in diesem Help-Center-Artikel

          • clicks
            Typ: number | null

            Anzahl der Klicks auf eine Anzeige
            Anzahl der Klicks, die eine Anzeige im angegebenen Zeitraum voraussichtlich erhält
            liegen keine Daten vor, ist der Wert null

          • cost
            Typ: number | null

            Kosten für eine Anzeige
            Betrag, der für die Auslieferung einer Anzeige im angegebenen Zeitraum berechnet wird
            liegen keine Daten vor, ist der Wert null

          • ctr
            Typ: number | null Format: double

            voraussichtliche Klickrate (CTR) der Anzeige
            Anzahl der Klicks, die eine Anzeige voraussichtlich erhält, geteilt durch die Anzahl der Anzeigenimpressionen;
            Hinweis: Parameter veraltet, der Wert ist immer null

          • date_interval
            Typ: string | null

            Prognose-Datumsintervall in einem POST-Array

          • impressions
            Typ: integer | null

            voraussichtliche Anzahl von Anzeigenimpressionen
            Anzahl der Impressionen, die eine Anzeige im angegebenen Zeitraum voraussichtlich erhält
            Hinweis: Parameter veraltet, der Wert ist immer null

          • keyword
            Typ: string | null

            Keyword in einem POST-Array
            Metriken werden für alle im POST-Array angegebenen Keywords bereitgestellt

          • language_code
            Typ: string | null

            Sprachcode in einem POST-Array
            liegen keine Daten vor, ist der Wert null

          • location_code
            Typ: integer | null

            Standortcode in einem POST-Array
            liegen keine Daten vor, ist der Wert null

          • match
            Typ: string | null

            Übereinstimmungstyp für Keywords
            kann folgende Werte annehmen: exact, broad, phrase

          • search_partners
            Typ: boolean | null

            Google-Suchpartner einbeziehen
            der Wert ist immer false

        • 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
Request Example for get/v1/beta/dataforseo/keywords_data/google_ads/ad_traffic_by_keywords/task_get/{id}
curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/google_ads/ad_traffic_by_keywords/task_get/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,
          "location_code": null,
          "language_code": null,
          "date_interval": null,
          "search_partners": null,
          "bid": null,
          "match": null,
          "impressions": null,
          "ctr": null,
          "average_cpc": null,
          "cost": null,
          "clicks": null
        }
      ]
    }
  ]
}

Erfolgreicher Vorgang

Get ‘Ads Traffic By Keywords’ Results by id