v0.2.0-beta

OpenAPI 3.1.0

Live-taken voor ‘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/bing/search_volume/live

Live-taken voor ‘Search Volume’ instellen

Bing-zoekvolume voor een lijst keywords. Retourneert keyword, location_code, language_code, search_partners, device, competition, cpc, search_volume, categories en monthly_searches – let op categories, dat het Google-equivalent niet retourneert, en het ontbreken van competition_index. Verpakt in de DataForSEO-envelop: data in tasks[0].result, uitkomst in tasks[0].status_code; een geweigerd verzoek retourneert nog steeds HTTP 200. De Google-tegenhanger is post_dataforseo_keywords_gads_search_volume_live; voer beide uit wanneer het publiek niet alleen Google is. De submit- en fetch-tegenhangers van dit endpoint doen hetzelfde werk asynchroon, tegen dezelfde prijs, voor batches die te groot zijn om op te wachten.

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)[]
- date_from
  Type: string | null
  
  startdatum van de periode
  optioneel veld
  minimumwaarde: 24 maanden vanaf de datum van vandaag;
  als je dit veld niet opgeeft, worden gegevens voor de laatste 12 maanden geleverd;
  minimumwaarde: twee jaar terug vanaf de datum van vandaag;
  als het status-endpoint false retourneert voor het veld actual_data, kan date_from op de voorlaatste maand en eerder worden ingesteld;
  als het status-endpoint true retourneert voor het veld actual_data, kan date_from op de laatste maand en eerder worden ingesteld;
  datumformaat: "yyyy-mm-dd"
  voorbeeld:
  "2020-01-01"Let op: we raden aan geen aangepaste periode te gebruiken voor datums van het afgelopen jaar
- date_to
  Type: string | null
  
  einddatum van de periode
  optioneel veld
  als je dit veld niet opgeeft, worden gegevens voor de laatste 12 maanden geleverd;
  minimumwaarde: twee jaar terug vanaf de datum van vandaag;
  maximumwaarde: één maand vanaf de datum van vandaag;
  let op: we raden aan geen aangepaste periode te gebruiken voor datums van het afgelopen jaar;
  datumformaat: "yyyy-mm-dd"
  voorbeeld:
  "2020-03-15"Let op: we raden aan geen aangepaste periode te gebruiken voor datums van het afgelopen jaar
- device
  Type: string | null
  
  apparaattype
  optioneel veld
  geef dit veld op als je de gegevens voor een bepaald apparaattype wilt ontvangen;
  mogelijke waarden: all, mobile, desktop, tablet
  standaardwaarde: all
- keywords
  Type: array string[]
  
  keywords
  verplicht veld
  maximaal aantal keywords dat je kunt opgeven: 1000
  maximaal aantal tekens per keyword: 100
  de opgegeven keywords worden omgezet naar kleine letters, de gegevens worden in een aparte array geleverd. 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 niet opgegeven language_name
  bij gebruik van dit veld hoef je language_name niet op te geven
  ondersteunde talen:
  en, fr, de
- language_name
  Type: string
  
  volledige naam van de taal van de zoekmachine
  verplicht veld als niet opgegeven language_code
  bij gebruik van dit veld hoef je language_code niet op te geven
  ondersteunde talen:
  English, French, German
- location_code
  Type: integer
  
  locatiecode van de zoekmachine
  verplicht veld als niet opgegeven location_name of location_coordinate
  bij gebruik van dit veld hoef je location_name of location_coordinate niet op te geven
  de lijst met beschikbare locaties van de zoekmachines en hun location_code ontvang je via een apart verzoek aan https://api.dataforseo.com/v3/keywords_data/bing/locations
  voorbeeld:
  2840
- location_coordinate
  Type: string
  
  GPS-coördinaten van een locatie
  verplicht veld als niet opgegeven location_name of location_code
  bij gebruik van dit veld hoef je 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
  
  volledige naam van de locatie van de zoekmachine
  verplicht veld als niet opgegeven location_code of location_coordinate
  bij gebruik van dit veld hoef je location_code of location_coordinate niet op te geven
  de lijst met beschikbare locaties van de zoekmachine en hun location_name ontvang je via een apart verzoek aan https://api.dataforseo.com/v3/keywords_data/bing/locations
  voorbeeld:
  London,England,United Kingdom
- search_partners
  Type: boolean | null
  
  type Bing-zoekpartners
  optioneel veld
  als je true opgeeft, worden de resultaten geleverd voor eigen, geëxploiteerde en gesyndiceerde netwerken binnen Bing, Yahoo, AOL en partnersites die Bing-, AOL- en Yahoo-zoekopdrachten hosten.
  standaardwaarde: false - resultaten worden geretourneerd voor de zoeknetwerken Bing, AOL en Yahoo
- sort_by
  Type: string | null
  
  sorteerparameters voor resultaten
  optioneel veld
  gebruik deze parameters om de resultaten te sorteren op search_volume, cpc, competition of relevance 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 het data-object van de respons

Responsen

200
Type: object | null · Response36Afe1097B20_KeywordsDataBingSearchVolumeLiveResponseInfo
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_KeywordsDataBingSearchVolumeLiveTaskInfo
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

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

product- en servicecategorieën
onze API retourneert geen categorieën voor dit endpoint: de parameter is altijd null

competition
Type: number | null

concurrentie
vertegenwoordigt de relatieve concurrentie-intensiteit voor het opgegeven keyword, uitsluitend in de betaalde SERP. Deze waarde is gebaseerd op Bing Ads-gegevens.
mogelijke waarden: 0.1, 0.5,0.90.1 - lage concurrentie,
0.5 - gemiddelde concurrentie,
0.9 - hoge concurrentie;
als er geen gegevens zijn, is de waarde null

cpc
Type: number | null

kosten per klik
vertegenwoordigt de gemiddelde kosten per klik (USD) die historisch voor het keyword zijn betaald.
als er geen gegevens zijn, is de waarde null

device
Type: string | null

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

keyword
Type: string | null

keyword in een POST-array

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

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

maandelijkse zoekopdrachten
vertegenwoordigt het (bij benadering) aantal zoekopdrachten op deze keyword-idee (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 in de Bing-zoekmachine, afhankelijk van de targeting van de gebruiker;
het zoekvolume wordt afgerond op de dichtstbijzijnde tientallen;
als er geen gegevens zijn, is de waarde null

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/bing/search_volume/live

curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/bing/search_volume/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "location_name": "United States",
    "language_code": "en",
    "keywords": [
      "tom and jerry",
      "silicon valley",
      "spider man"
    ]
  }
]'

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,
          "search_partners": null,
          "device": null,
          "competition": null,
          "cpc": null,
          "search_volume": null,
          "categories": [
            null
          ],
          "monthly_searches": [
            {
              "year": null,
              "month": null,
              "search_volume": null
            }
          ]
        }
      ]
    }
  ]
}

Geslaagde bewerking

Live-taken voor ‘Search Volume’ instellen

AuthenticatieRequired

DataForSEO

Live-taken voor ‘Search Volume’ instellen

Prijsreferentie