v0.2.0-beta

OpenAPI 3.1.0

Search Volume-resultaten 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/search_volume/task_get/{id}

Search Volume-resultaten op id ophalen

Haalt een in de wachtrij gezette Google Ads-zoekvolumetaak op basis van id op. Zelfde vorm als post_dataforseo_keywords_gads_search_volume_live. Verpakt in de DataForSEO-envelop: data in tasks[0].result, uitkomst in tasks[0].status_code – een geweigerd verzoek retourneert nog steeds HTTP 200.

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_KeywordsDataGoogleAdsSearchVolumeTaskGetResponseInfo
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_KeywordsDataGoogleAdsSearchVolumeTaskGetTaskInfo
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

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

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

curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/google_ads/search_volume/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,
          "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

Search Volume-resultaten op id ophalen

AuthenticatieRequired

DataForSEO

Search Volume-resultaten op id ophalen

Prijsreferentie