v0.2.0-beta

OpenAPI 3.1.0

Live-taken voor ‘Google Ads Search Volume’ instellen

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

post/v1/beta/dataforseo/keywords_data/google_ads/search_volume/live

Live-taken voor ‘Google Ads Search Volume’ instellen

Google Ads-zoekvolume voor een lijst keywords. Retourneert keyword, location_code, language_code, search_partners, competition, competition_index, search_volume, low_top_of_page_bid, high_top_of_page_bid, cpc en monthly_searches, plus spell wanneer Google de term heeft gecorrigeerd. Verpakt in de DataForSEO-envelop: data in tasks[0].result, uitkomst in tasks[0].status_code – een geweigerd verzoek retourneert nog steeds HTTP 200. Dit is het klassieke zoekvolumegetal; voor hoe vaak mensen in plaats daarvan een assistent vragen, gebruik je post_dataforseo_ai_keyword_volume_live. De submit- en fetch-tweeling van dit endpoint doet hetzelfde werk asynchroon, tegen dezelfde prijs, voor batches die te groot zijn om op te wachten.

Prijsreferentie

Afrekening: gerapporteerde responskosten.
Referentieschatting per verzoek: USD 0.09.
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.

Body

application/json

Type: array (object | null)[]
- date_from
  Type: string | null
  
  startdatum van het tijdsbereik
  optioneel veld
  datumnotatie: "yyyy-mm-dd"
  minimumwaarde: 4 jaar vanaf de huidige datum
  standaard worden gegevens voor de afgelopen 12 maanden geretourneerd;
  Let op: de opgegeven datum mag niet groter zijn dan de datum in date_to en/of de datum van gisteren;als Status-endpoint false retourneert in het veld actual_data, kan date_from worden ingesteld op de maand vóór de vorige en eerder;
  als Status-endpoint true retourneert in het veld actual_data, kan date_from worden ingesteld op de vorige maand en eerder
- date_to
  Type: string | null
  
  einddatum van het tijdsbereik
  optioneel veld
  Let op: de opgegeven datum mag niet verder terugliggen dan de afgelopen maand; Google Ads retourneert geen gegevens over de huidige maand;
  als u dit veld niet opgeeft, wordt standaard de datum van gisteren gebruikt
  datumnotatie: "yyyy-mm-dd"
  voorbeeld:
  "2022-11-30"
- include_adult_keywords
  Type: boolean | null
  
  keywords met betrekking tot inhoud voor volwassenen opnemen
  optioneel veld
  bij_true worden keywords voor volwassenen in de respons opgenomen
  standaardwaarde:_false
  let opdat de API voor zulke keywords mogelijk geen gegevens retourneert vanwegebeperkingen van Google Adsn
- keywords
  Type: array string[]
  
  keywords
  verplicht veld
  maximaal aantal keywords dat u kunt opgeven: 1000
  maximaal aantal tekens per keyword: 80
  maximaal aantal woorden per keyword-frase: 10
  de keywords die u opgeeft, worden omgezet naar kleine letters
  Opmerking nr. 1: Google Ads retourneert mogelijk geen gegevens voor bepaalde groepen keywords;
  Opmerking nr. 2: Google Ads levert gecombineerde zoekvolumewaarden voor groepen vergelijkbare keywords
  om zoekvolume voor vergelijkbare keywords te krijgen, raden we aan dergelijke keywords in afzonderlijke verzoeken in te dienen;
  Opmerking nr. 3: Google Ads staat het gebruik van bepaalde symbolen en tekens niet toe (bijv. UTF-symbolen, emoji's), dus u kunt ze niet gebruiken bij het instellen van een taak;
  meer informatie over welke symbolen en tekens kunnen worden gebruikt, vindt u in dit artikel
  
  meer informatie over regels en beperkingen van de velden keyword en keywords in DataForSEO-API's vindt u in dit Help Center-artikel
- language_code
  Type: string | null
  
  taalcode van de zoekmachine
  optioneel veld
  de lijst met beschikbare talen van de zoekmachine en hun language_code ontvangt u via een afzonderlijk verzoek aan https://api.dataforseo.com/v3/keywords_data/google_ads/languages
  voorbeeld:
  en
- language_name
  Type: string | null
  
  volledige naam van de zoekmachinetaal
  optioneel veld
  de lijst met beschikbare talen van de zoekmachine en hun language_name ontvangt u via een afzonderlijk verzoek aan https://api.dataforseo.com/v3/keywords_data/google_ads/languages
  voorbeeld:
  English
- location_code
  Type: integer | null
  
  locatiecode van de zoekmachine
  optioneel veld
  als u de locatie niet opgeeft, ontvangt u wereldwijde resultaten, dat wil zeggen voor alle beschikbare locaties;
  als u dit veld gebruikt, hoeft u location_name of location_coordinate niet op te geven;
  de lijst met beschikbare locaties van de zoekmachines en hun location_code ontvangt u via een afzonderlijk verzoek aan https://api.dataforseo.com/v3/keywords_data/google_ads/locations
  voorbeeld:
  2840
- location_coordinate
  Type: string | null
  
  GPS-coördinaten van een locatie
  optioneel veld
  als u de locatie niet opgeeft, ontvangt u wereldwijde resultaten, dat wil zeggen voor alle beschikbare locaties;
  als u dit veld gebruikt, hoeft u location_name of location_code niet op te geven;
  de parameter location_coordinate moet in het formaat "latitude,longitude" worden opgegeven;
  de gegevens worden geleverd voor het land waartoe de opgegeven coördinaten behoren;
  voorbeeld:
  52.6178549,-155.352142
- location_name
  Type: string | null
  
  volledige naam van de zoekmachinelocatie
  optioneel veld
  als u de locatie niet opgeeft, ontvangt u wereldwijde resultaten, dat wil zeggen voor alle beschikbare locaties;
  als u dit veld gebruikt, hoeft u location_code of location_coordinate niet op te geven
  de lijst met beschikbare locaties van de zoekmachine en hun location_name ontvangt u via een afzonderlijk verzoek aan https://api.dataforseo.com/v3/keywords_data/google_ads/locations
  voorbeeld:
  London,England,United Kingdom
- search_partners
  Type: boolean | null
  
  Google-zoekpartners opnemen
  optioneel veld
  als u true opgeeft, worden de resultaten geleverd voor eigen, beheerde en gesyndiceerde netwerken op Google- en partnersites die Google Zoeken hosten;
  standaardwaarde: false - resultaten worden geretourneerd voor Google-zoeksites
- sort_by
  Type: string | null
  
  sorteerparameters voor resultaten
  optioneel veld
  gebruik deze parameters om de resultaten te sorteren op relevance, search_volume, competition_index, low_top_of_page_bid of high_top_of_page_bid in aflopende volgorde
  standaardwaarde: relevance
- tag
  Type: string | null
  
  door gebruiker gedefinieerde taak-ID
  optioneel veld
  de tekenslimiet is 255
  je kunt deze parameter gebruiken om de taak te identificeren en aan het resultaat te koppelen
  de opgegeven waarde tag vind je in de data-array van de respons

Responsen

200
Type: object | null · Response36Afe1097B20_KeywordsDataGoogleAdsSearchVolumeLiveResponseInfo
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_KeywordsDataGoogleAdsSearchVolumeLiveTaskInfo
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

competition
Type: string | null

concurrentie
vertegenwoordigt de relatieve concurrentie-intensiteit voor het opgegeven keyword, uitsluitend in de betaalde SERP;
deze waarde is gebaseerd op Google Ads-gegevens en kan de volgende waarden aannemen: HIGH, MEDIUM, LOW;
als er geen gegevens zijn, is de waarde null;
meer over de metriek lees je in dit Help Center-artikel

competition_index
Type: integer | null

concurrentie
vertegenwoordigt de relatieve concurrentie-intensiteit voor het opgegeven keyword, uitsluitend in de betaalde SERP;
deze waarde is gebaseerd op Google Ads-gegevens en kan tussen 0 en 100 (inclusief) liggen;
als er geen gegevens zijn, is de waarde null;
meer over de metriek lees je in dit Help Center-artikel

cpc
Type: number | null

kosten per klik
geeft het bedrag (USD) aan dat voor elke klik op de advertentie voor een bepaald keyword wordt betaald

high_top_of_page_bid
Type: number | null

maximaal bod om de advertentie bovenaan de eerste pagina te laten verschijnen
geeft de waarde aan die hoger ligt dan ongeveer 80% van de laagste biedingen waarvoor advertenties zijn weergegeven (op basis van Google Ads-statistieken voor adverteerders);
de waarde kan verschillen afhankelijk van de locatie die in een POST-verzoek is opgegeven

keyword
Type: string | null

keyword
het keyword wordt geretourneerd met gedecodeerde %## (het plusteken '+' wordt gedecodeerd naar een spatie)

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

low_top_of_page_bid
Type: number | null

minimaal bod om de advertentie bovenaan de eerste pagina te laten verschijnen
geeft de waarde aan die hoger ligt dan ongeveer 20% van de laagste biedingen waarvoor advertenties zijn weergegeven (op basis van Google Ads-statistieken voor adverteerders);
de waarde kan verschillen afhankelijk van de locatie die in een POST-verzoek is opgegeven

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

maandelijkse zoekopdrachten
vertegenwoordigt het (bij benadering) aantal zoekopdrachten op deze keyword-idee (standaard beschikbaar voor de afgelopen twaalf maanden), gericht op de opgegeven geografische locaties;
als er geen gegevens zijn, is de waarde null

month
Type: integer | null

Maand

search_volume
Type: integer | null

gemiddelde maandelijkse zoekvolumegraad

year
Type: integer | null

Jaar

search_partners
Type: boolean | null

geeft aan of gegevens van partnernetwerken in de respons zijn opgenomen

search_volume
Type: integer | null Formaat: int64

gemiddeld maandelijks zoekvolume;
vertegenwoordigt het (bij benadering) aantal zoekopdrachten voor de betreffende keyword-idee op google.com of op google.com en partners, afhankelijk van de targeting van de gebruiker;
als er geen gegevens zijn, is de waarde null

spell
Type: string | null

correcte spelling van het keyword
Let op:als het keyword in de POST-array verkeerd gespeld lijkt, worden gegevens geretourneerd voor het correct gespelde keyword;
we gebruiken de functionaliteit van de Google Ads API om de spelling van keywords te controleren en te valideren, meer informatie via deze link

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

post/v1/beta/dataforseo/keywords_data/google_ads/search_volume/live

curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/google_ads/search_volume/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "location_code": 2840,
    "keywords": [
      "buy laptop",
      "cheap laptops for sale",
      "purchase laptop"
    ],
    "date_from": "2021-08-01",
    "search_partners": true
  }
]'

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,
          "spell": null,
          "location_code": null,
          "language_code": null,
          "search_partners": null,
          "competition": null,
          "competition_index": null,
          "search_volume": null,
          "low_top_of_page_bid": null,
          "high_top_of_page_bid": null,
          "cpc": null,
          "monthly_searches": [
            {
              "year": null,
              "month": null,
              "search_volume": null
            }
          ]
        }
      ]
    }
  ]
}

Geslaagde bewerking

Live-taken voor ‘Google Ads Search Volume’ instellen

AuthenticatieRequired

DataForSEO

Live-taken voor ‘Google Ads Search Volume’ instellen

Prijsreferentie