v0.2.0-beta

OpenAPI 3.1.0

Live-taken voor ‘DataForSEO 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/clickstream_data/dataforseo_search_volume/live

Live-taken voor ‘DataForSEO Search Volume’ instellen

Zoekvolume afgeleid uit clickstreampanels in plaats van de advertentieplatforms, voor een lijst keywords. use_clickstream schakelt de mengeling. Retourneert location_code, language_code, use_clickstream, items_count en items. Verpakt in de DataForSEO-envelop: data in tasks[0].result, uitkomst in tasks[0].status_code; een geweigerd verzoek retourneert nog steeds HTTP 200. Clickstream-volume wijkt vaak af van post_dataforseo_keywords_gads_search_volume_live, en dat is juist het punt: het ene meet wat adverteerders te zien krijgen, het andere wat mensen deden.

Prijsreferentie

Metering: Gerapporteerde responskosten.
Referentieschatting per verzoek: USD 0.09.
Referentieklantvermenigvuldiger: 1.0. Pas deze niet opnieuw toe op een afgerekend klantbedrag.

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

Body

application/json

Type: array (object | null)[]
- keywords
  Type: array string[]
  
  doelkeywords
  verplicht veld
  UTF-8-codering
  maximaal aantal keywords dat je in deze array kunt opgeven: 1000
  de keywords worden omgezet naar kleine letters
  
  Let op: bepaalde symbolen en tekens (bijv. UTF-symbolen, emoji's) zijn niet toegestaan
  meer informatie over welke symbolen en tekens kunnen worden gebruikt, vind je in dit artikel
  
  meer informatie over regels en beperkingen voor de velden keyword en keywords in DataForSEO-API's vind je in dit Help Center-artikel
- language_code
  Type: string
  
  taalcode van de zoekmachine
  verplicht veld als je language_name niet opgeeft
  de lijst met beschikbare talen en hun language_code ontvang je via een apart verzoek aan https://api.dataforseo.com/v3/keywords_data/clickstream_data/locations_and_languages
  voorbeeld:
  en
- language_name
  Type: string
  
  volledige naam van de taal van de zoekmachine
  verplicht veld als je language_code niet opgeeft
  de lijst met beschikbare talen en hun language_name ontvang je via een apart verzoek aan https://api.dataforseo.com/v3/keywords_data/clickstream_data/locations_and_languages
  voorbeeld:
  English
- location_code
  Type: integer
  
  locatiecode van de zoekmachine
  verplicht veld als je location_name niet opgeeft
  als je dit veld gebruikt, kun je de lijst met beschikbare locaties met location_code ontvangen via een apart verzoek aan https://api.dataforseo.com/v3/keywords_data/clickstream_data/locations_and_languages
  voorbeeld:
  2826
- location_name
  Type: string
  
  volledige naam van de locatie van de zoekmachine
  verplicht veld als je location_code niet opgeeft
  de lijst met beschikbare locaties met location_name ontvang je via een apart verzoek aan https://api.dataforseo.com/v3/keywords_data/clickstream_data/locations_and_languages
  voorbeeld:
  United Kingdom
- 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 het data-object van de respons
- use_clickstream
  Type: boolean | null
  
  clickstreamgegevens gebruiken voor resultaten
  optioneel veld
  als je dit op true instelt, krijg je DataForSEO-zoekvolumewaarden op basis van clickstreamgegevens;
  als je dit op false instelt, worden Bing-zoekvolumegegevens gebruikt om het DataForSEO-zoekvolume te berekenen;
  standaardwaarde: true;
  Let op: Bing-zoekvolume is beschikbaar voor locaties die worden vermeld in de endpoints Bing Search Volume History Locations en Bing Ads Locations; zoekvolumewaarden voor alle andere locaties worden berekend op basis van clickstreamgegevens, ook als je deze parameter op false instelt

Responsen

200
Type: object | null · Response36Afe1097B20_KeywordsDataClickstreamDataDataforseoSearchVolumeLiveResponseInfo
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_KeywordsDataClickstreamDataDataforseoSearchVolumeLiveTaskInfo
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

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

array met keywords
bevat keywords en hun zoekvolumegraden

keyword
Type: string | null

keyword zoals opgegeven in de POST-array

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

maandelijkse zoekvolumegraden
array met objecten met zoekvolumegraden in een bepaalde maand van een jaar

month
Type: integer | null

Maand

search_volume
Type: integer | null

gemiddelde maandelijkse zoekvolumegraad

year
Type: integer | null

Jaar

search_volume
Type: integer | null Formaat: int64

huidige zoekvolumegraad van een keyword

items_count
Type: integer | null

het aantal resultaten dat in de array items wordt geretourneerd

language_code
Type: string | null

taalcode in een POST-array

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

location_code
Type: integer | null

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

use_clickstream
Type: boolean | null

geeft aan of de parameter use_clickstream actief is
mogelijke waarden: true, 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

post/v1/beta/dataforseo/keywords_data/clickstream_data/dataforseo_search_volume/live

curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/clickstream_data/dataforseo_search_volume/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "location_code": 2840,
    "language_code": "en",
    "tag": "test-tag",
    "keywords": [
      "you tube",
      "youtube",
      "youtub"
    ]
  }
]'

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": [
        {
          "location_code": null,
          "language_code": null,
          "use_clickstream": null,
          "items_count": null,
          "items": [
            {
              "keyword": null,
              "search_volume": null,
              "monthly_searches": [
                "[Max Depth Exceeded]"
              ]
            }
          ]
        }
      ]
    }
  ]
}

Geslaagde bewerking

Live-taken voor ‘DataForSEO Search Volume’ instellen

AuthenticatieRequired

DataForSEO

Live-taken voor ‘DataForSEO Search Volume’ instellen

Prijsreferentie