v0.2.0-beta

OpenAPI 3.1.0

Resultaten voor ‘Ads Traffic By Keywords’ op id ophalen

Felo API Support

MIT

Server

https://openapi.felo.ai

Clientbibliotheken

Shell Curl

DataForSEO

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

DataForSEO Operaties

get/v1/beta/dataforseo/keywords_data/google_ads/ad_traffic_by_keywords/task_get/{id}

Resultaten voor ‘Ads Traffic By Keywords’ op id ophalen

Haalt een in de wachtrij gezette Google Ads-verkeersprognose op basis van id op: verwachte vertoningen, klikken, kosten en gemiddelde positie voor het opgegeven bod. Verpakt in de DataForSEO-envelop: data in tasks[0].result, uitkomst in tasks[0].status_code – een geweigerd verzoek retourneert nog steeds HTTP 200. Anders dan de volume-endpoints is dit een projectie, geen meting – de cijfers veranderen mee met bid en match.

Prijsreferentie

Afrekening: gerapporteerde responskosten.
Referentieschatting per verzoek: USD 0.012.
Referentiemultiplier voor klanten: 1.0. Niet opnieuw toepassen op een al afgerekend klantbedrag.

Alleen referentiemetadata, geen accountofferte en geen gegarandeerde prijs of bestedingslimiet. Resourcecredits zijn geen Felo-tegoed. De uiteindelijke kosten volgen de factureringsgegevens van Felo.

Padparameters

id
Type: string
verplicht

taak-ID
unieke taak-ID in ons systeem in UUID-formaat
je kunt deze 30 dagen lang gebruiken om op elk moment de resultaten van de taak op te vragen

Responsen

200
Type: object | null · Response36Afe1097B20_KeywordsDataGoogleAdsAdTrafficByKeywordsTaskGetResponseInfo
cost
Type: number | null Formaat: double

Totale kosten van taken, USD

status_code
Type: integer | null

algemene statuscode de volledige lijst met responscodes vindt u hier

status_message
Type: string | null

algemeen informatief bericht de volledige lijst met algemene informatieve berichten vindt u hier

tasks
Type: array (object | null)[] | null

array van taken

Type: object | null · Response36Afe1097B20_KeywordsDataGoogleAdsAdTrafficByKeywordsTaskGetTaskInfo
cost
Type: number | null Formaat: double

Totale kosten van taken, USD

data
Type: object | null

Bevat dezelfde parameters die je in het POST-verzoek hebt opgegeven

propertyName
Type: object | null
id
Type: string | null

taak-id eenduidige taak-id in ons systeem in UUID-indeling

path
Type: array (string | null)[] | null

URL-pad

result
Type: array (object | null)[] | null

array van resultaten

average_cpc
Type: number | null Formaat: double

de gemiddelde kosten per klik
vertegenwoordigt de kosten per klik (USD) die voor een keyword zijn geschat op basis van de opgegeven periode en historische gegevens;
als er geen gegevens zijn, is de waarde null

bid
Type: number | null

het maximale aangepaste bod
het bod dat je hebt opgegeven bij het instellen van de taak
vertegenwoordigt de prijs die je bereid bent voor een advertentie te betalen
hoe hoger de opgegeven waarde, hoe hoger de metrieken en kosten die je in de respons ontvangt
lees meer in dit Help Center-artikel

clicks
Type: number | null

aantal klikken op een advertentie
aantal klikken dat een advertentie naar verwachting binnen de opgegeven periode krijgt
als er geen gegevens zijn, is de waarde null

cost
Type: number | null

kosten voor een advertentie
bedrag dat wordt aangerekend voor het laten draaien van een advertentie binnen de opgegeven periode
als er geen gegevens zijn, is de waarde null

ctr
Type: number | null Formaat: double

verwachte clickthrough-rate (CTR) van de advertentie
het aantal klikken dat een advertentie naar verwachting ontvangt, gedeeld door het aantal advertentievertoningen;
Let op: parameter verouderd, de waarde is altijd null

date_interval
Type: string | null

prognosedatuminerval in een POST-array

impressions
Type: integer | null

verwacht aantal advertentievertoningen
aantal vertoningen dat een advertentie naar verwachting binnen de opgegeven periode krijgt
Let op: parameter verouderd, de waarde is altijd null

keyword
Type: string | null

keyword in een POST-array
metrieken worden verstrekt voor alle keywords die in de POST-array zijn opgegeven

language_code
Type: string | null

taalcode in een POST-array
als er geen gegevens zijn, is de waarde null

location_code
Type: integer | null

locatiecode in een POST-array
als er geen gegevens zijn, is de waarde null

match
Type: string | null

matchtype voor keywords
kan de volgende waarden aannemen: exact, broad, phrase

search_partners
Type: boolean | null

Google-zoekpartners opnemen
de waarde is altijd false

result_count
Type: integer | null Formaat: int64

Aantal elementen in de result-array

status_code
Type: integer | null

statuscode van de taak gegenereerd door DataForSEO, kan binnen het volgende bereik liggen: 10000-60000 de volledige lijst met responscodes vindt u hier

status_message
Type: string | null

informatief bericht van de taak de volledige lijst met algemene informatieve berichten vindt u hier

time
Type: string | null

Uitvoeringstijd in seconden

tasks_count
Type: integer | null Formaat: int64

Het aantal taken in de tasks-array

tasks_error
Type: integer | null Formaat: int64

Het aantal taken in de tasks-array dat met een fout is geretourneerd

time
Type: string | null

totale uitvoeringstijd, seconden

version
Type: string | null

De huidige versie van de API
application/json
400

Het verzoek kon niet worden verwerkt. Controleer de verzoekparameters.
401

Een geldige Felo-API-sleutel is vereist.
402

Het verzoek kan niet doorgaan omdat niet aan een factureringsvoorwaarde is voldaan.
403

Het account mag deze bewerking niet uitvoeren.
429

Een verzoek- of bestedingslimiet is bereikt.
502

De dienst kon het verzoek niet voltooien.
503

De API of factureringsdienst is tijdelijk niet beschikbaar.
504

Er is een time-out opgetreden bij het verwerken van het verzoek.
default

Foutrespons; upstream-passthrough-responsen kunnen indelingen van de provider gebruiken

application/json

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'

Schema tonen

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

Geslaagde bewerking

Resultaten voor ‘Ads Traffic By Keywords’ op id ophalen

AuthenticatieRequired

DataForSEO

Resultaten voor ‘Ads Traffic By Keywords’ op id ophalen

Prijsreferentie