Live-taken voor ‘Bing Keyword Performance’ instellen
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Live-taken voor ‘Bing Keyword Performance’ instellen
Hoe een lijst keywords presteert in Bing Ads voor een bepaald device en match-type. ⚠️ language_name is vereist en het ontbreken ervan wordt gemeld als Invalid Field: 'language_name' binnen een HTTP 200 – de melding betekent zowel ontbrekend als onjuist. Verpakt in de DataForSEO-envelop: data in tasks[0].result, uitkomst in tasks[0].status_code; een geweigerd verzoek retourneert nog steeds HTTP 200. Geldige paren komen uit get_dataforseo_keywords_bing_kw_performance_locales. 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.
- Type: array (object | null)[]
- deviceType: string | null
apparaattype
optioneel veld
geef dit veld op als je de gegevens voor een bepaald apparaattype wilt ontvangen; mogelijke waarden:desktop,mobile,tablet,all
standaardwaarde:all - keywordsType: array string[]
keywords
verplicht veld
maximaal aantal keywords dat je kunt opgeven: 1000
maximaal aantal tekens per keyword: 80
maximaal aantal woorden per keyword-frase: 10
de opgegeven keywords worden omgezet naar kleine letters, de gegevens worden in een aparte array geleverdmeer informatie over regels en beperkingen voor de velden
keywordenkeywordsin DataForSEO-API's vind je in dit Help Center-artikel - languageType: string
_code taalcode van de zoekmachine
verplicht veld als niet opgegevenlanguage_name
de lijst met beschikbare locaties en talen ontvang je via een apart verzoek aanhttps://api.dataforseo.com/v3/keywords_data/bing/keyword_performance/locations_and_languages
voorbeeld:"en" - languageType: string
_name volledige naam van de taal van de zoekmachine
verplicht veld als niet opgegevenlanguage_code
bij gebruik van dit veld hoef jelanguage_codeniet op te geven
de lijst met beschikbare locaties en talen ontvang je via een apart verzoek aanhttps://api.dataforseo.com/v3/keywords_data/bing/keyword_performance/locations_and_languages
voorbeeld:English - locationType: integer
_code locatiecode van de zoekmachine
verplicht veld als niet opgegevenlocation_nameoflocation_coordinate
bij gebruik van dit veld hoef jelocation_nameoflocation_coordinateniet op te geven
de lijst met beschikbare locaties en talen ontvang je via een apart verzoek aanhttps://api.dataforseo.com/v3/keywords_data/bing/keyword_performance/locations_and_languages
voorbeeld:2840 - locationType: string
_coordinate GPS-coördinaten van een locatie
verplicht veld als niet opgegevenlocation_nameoflocation_code
bij gebruik van dit veld hoef jelocation_nameoflocation_codeniet op te geven
de parameterlocation_coordinatemoet 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 - locationType: string
_name volledige naam van de locatie van de zoekmachine
verplicht veld als niet opgegevenlocation_codeoflocation_coordinate
bij gebruik van dit veld hoef jelocation_codeoflocation_coordinateniet op te geven
de lijst met beschikbare locaties en talen ontvang je via een apart verzoek aanhttps://api.dataforseo.com/v3/keywords_data/bing/keyword_performance/locations_and_languages
voorbeeld:"United States" - matchType: string | null
matchtype voor keywords
optioneel veld
kan de volgende waarden hebben:aggregateretourneert gegevens over alle matchtypen;broadretourneert gegevens voor alle gebruikerszoekopdrachten die het opgegeven keyword in een andere woordvolgorde bevatten;phraseretourneert gegevens voor alle gebruikerszoekopdrachten die het opgegeven keyword in dezelfde woordvolgorde bevatten;exactretourneert gegevens voor een gebruikerszoekopdracht die overeenkomt met het opgegeven keyword;Let op: het matchtypeaggregatewordt standaard toegepast - tagType: 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 waardetagvind je in hetdata-object van de respons
- Type: object | null · Response36Afe1097B20_KeywordsDataBingKeywordPerformanceLiveResponseInfo200
- Type: number | null Formaat: doublecost
Totale kosten van taken, USD
- Type: integer | nullstatus
_code algemene statuscode de volledige lijst met responscodes vindt u hier
- Type: string | nullstatus
_message algemeen informatief bericht de volledige lijst met algemene informatieve berichten vindt u hier
- Type: array (object | null)[] | nulltasks
array van taken
- Type: object | null · Response36Afe1097B20_KeywordsDataBingKeywordPerformanceLiveTaskInfo
- costType: number | null Formaat: double
Totale kosten van taken, USD
- dataType: object | null
Bevat dezelfde parameters die je in het POST-verzoek hebt opgegeven
- propertyType: object | null
Name
- idType: string | null
taak-id eenduidige taak-id in ons systeem in UUID-indeling
- pathType: array (string | null)[] | null
URL-pad
- resultType: array (object | null)[] | null
array van resultaten
- keywordType: string | null
keyword in een POST-array
- keywordType: object | null · Response36Afe1097B20_KeywordKpi
_kpi object met keywordmetrieken
als er geen gegevens zijn, is de waardenull- desktopType: array (object | null)[] | null
keywordgegevens geaggregeerd voor desktopapparaten
als er geen gegevens zijn, is de waardenull- adType: string | null
_position geeft de positie van de relevante advertentie in de SERP aan
kan de volgende waarden aannemen:FirstPage1: De eerste advertentie aan de rechterkant van de eerste zoekresultatenpaginaFirstPage2: De tweede advertentie aan de rechterkant van de eerste zoekresultatenpaginaFirstPage3: De derde advertentie aan de rechterkant van de eerste zoekresultatenpaginaFirstPage4: De vierde advertentie aan de rechterkant van de eerste zoekresultatenpaginaFirstPage5: De vijfde advertentie aan de rechterkant van de eerste zoekresultatenpaginaFirstPage6: De zesde advertentie aan de rechterkant van de eerste zoekresultatenpaginaFirstPage7: De zevende advertentie aan de rechterkant van de eerste zoekresultatenpaginaFirstPage8: De achtste advertentie aan de rechterkant van de eerste zoekresultatenpaginaFirstPage9: De negende advertentie aan de rechterkant van de eerste zoekresultatenpaginaFirstPage10: De tiende advertentie aan de rechterkant van de eerste zoekresultatenpaginaMainLine1: De eerste advertentie bovenaan de zoekresultatenpaginaMainLine2: De tweede advertentie bovenaan de zoekresultatenpaginaMainLine3: De derde advertentie bovenaan de zoekresultatenpaginaMainLine4: De vierde advertentie bovenaan de zoekresultatenpagina - averageType: number | null Formaat: double
_bid gemiddeld bod van het keyword
- averageType: number | null Formaat: double
_cpc gemiddelde kosten per klik, USD
berekend door de kosten van alle klikken te delen door het aantal klikken - clicksType: integer | null
advertentieklikken
het aantal klikken dat het keyword en het matchtype in de afgelopen maand hebben opgeleverd - ctrType: number | null Formaat: double
clickthrough-rate in procenten
berekend door het aantal klikken te delen door het aantal vertoningen en het resultaat met 100 te vermenigvuldigen - impressionsType: integer | null
advertentievertoningen
het aantal vertoningen dat het keyword en het matchtype in de afgelopen maand hebben opgeleverd - totalType: number | null Formaat: int64
_cost totale kosten van een advertentie, USD
de kosten voor het gebruik van het opgegeven keyword en matchtype in de afgelopen maand
- mobileType: array (object | null)[] | null
keywordgegevens geaggregeerd voor mobiele apparaten
als er geen gegevens zijn, is de waardenull- adType: string | null
_position geeft de positie van de relevante advertentie in de SERP aan
kan de volgende waarden aannemen:FirstPage1: De eerste advertentie aan de rechterkant van de eerste zoekresultatenpaginaFirstPage2: De tweede advertentie aan de rechterkant van de eerste zoekresultatenpaginaFirstPage3: De derde advertentie aan de rechterkant van de eerste zoekresultatenpaginaFirstPage4: De vierde advertentie aan de rechterkant van de eerste zoekresultatenpaginaFirstPage5: De vijfde advertentie aan de rechterkant van de eerste zoekresultatenpaginaFirstPage6: De zesde advertentie aan de rechterkant van de eerste zoekresultatenpaginaFirstPage7: De zevende advertentie aan de rechterkant van de eerste zoekresultatenpaginaFirstPage8: De achtste advertentie aan de rechterkant van de eerste zoekresultatenpaginaFirstPage9: De negende advertentie aan de rechterkant van de eerste zoekresultatenpaginaFirstPage10: De tiende advertentie aan de rechterkant van de eerste zoekresultatenpaginaMainLine1: De eerste advertentie bovenaan de zoekresultatenpaginaMainLine2: De tweede advertentie bovenaan de zoekresultatenpaginaMainLine3: De derde advertentie bovenaan de zoekresultatenpaginaMainLine4: De vierde advertentie bovenaan de zoekresultatenpagina - averageType: number | null Formaat: double
_bid gemiddeld bod van het keyword
- averageType: number | null Formaat: double
_cpc gemiddelde kosten per klik, USD
berekend door de kosten van alle klikken te delen door het aantal klikken - clicksType: integer | null
advertentieklikken
het aantal klikken dat het keyword en het matchtype in de afgelopen maand hebben opgeleverd - ctrType: number | null Formaat: double
clickthrough-rate in procenten
berekend door het aantal klikken te delen door het aantal vertoningen en het resultaat met 100 te vermenigvuldigen - impressionsType: integer | null
advertentievertoningen
het aantal vertoningen dat het keyword en het matchtype in de afgelopen maand hebben opgeleverd - totalType: number | null Formaat: int64
_cost totale kosten van een advertentie, USD
de kosten voor het gebruik van het opgegeven keyword en matchtype in de afgelopen maand
- tabletType: array (object | null)[] | null
keywordgegevens geaggregeerd voor tablets
als er geen gegevens zijn, is de waardenull- adType: string | null
_position geeft de positie van de relevante advertentie in de SERP aan
kan de volgende waarden aannemen:FirstPage1: De eerste advertentie aan de rechterkant van de eerste zoekresultatenpaginaFirstPage2: De tweede advertentie aan de rechterkant van de eerste zoekresultatenpaginaFirstPage3: De derde advertentie aan de rechterkant van de eerste zoekresultatenpaginaFirstPage4: De vierde advertentie aan de rechterkant van de eerste zoekresultatenpaginaFirstPage5: De vijfde advertentie aan de rechterkant van de eerste zoekresultatenpaginaFirstPage6: De zesde advertentie aan de rechterkant van de eerste zoekresultatenpaginaFirstPage7: De zevende advertentie aan de rechterkant van de eerste zoekresultatenpaginaFirstPage8: De achtste advertentie aan de rechterkant van de eerste zoekresultatenpaginaFirstPage9: De negende advertentie aan de rechterkant van de eerste zoekresultatenpaginaFirstPage10: De tiende advertentie aan de rechterkant van de eerste zoekresultatenpaginaMainLine1: De eerste advertentie bovenaan de zoekresultatenpaginaMainLine2: De tweede advertentie bovenaan de zoekresultatenpaginaMainLine3: De derde advertentie bovenaan de zoekresultatenpaginaMainLine4: De vierde advertentie bovenaan de zoekresultatenpagina - averageType: number | null Formaat: double
_bid gemiddeld bod van het keyword
- averageType: number | null Formaat: double
_cpc gemiddelde kosten per klik, USD
berekend door de kosten van alle klikken te delen door het aantal klikken - clicksType: integer | null
advertentieklikken
het aantal klikken dat het keyword en het matchtype in de afgelopen maand hebben opgeleverd - ctrType: number | null Formaat: double
clickthrough-rate in procenten
berekend door het aantal klikken te delen door het aantal vertoningen en het resultaat met 100 te vermenigvuldigen - impressionsType: integer | null
advertentievertoningen
het aantal vertoningen dat het keyword en het matchtype in de afgelopen maand hebben opgeleverd - totalType: number | null Formaat: int64
_cost totale kosten van een advertentie, USD
de kosten voor het gebruik van het opgegeven keyword en matchtype in de afgelopen maand
- languageType: string | null
_code taalcode in een POST-array
als er geen gegevens zijn, is de waardenull - locationType: integer | null
_code locatiecode in een POST-array
als er geen gegevens zijn, is de waardenull - monthType: integer | null
geeft de maand aan waarvoor de gegevens worden verstrekt
voorbeeld:10 - yearType: integer | null
geeft het jaar aan waarvoor de gegevens worden verstrekt
voorbeeld:2020
- resultType: integer | null Formaat: int64
_count Aantal elementen in de result-array
- statusType: integer | null
_code statuscode van de taak gegenereerd door DataForSEO, kan binnen het volgende bereik liggen: 10000-60000 de volledige lijst met responscodes vindt u hier
- statusType: string | null
_message informatief bericht van de taak de volledige lijst met algemene informatieve berichten vindt u hier
- timeType: string | null
Uitvoeringstijd in seconden
- Type: integer | null Formaat: int64tasks
_count Het aantal taken in de tasks-array
- Type: integer | null Formaat: int64tasks
_error Het aantal taken in de tasks-array dat met een fout is geretourneerd
- Type: string | nulltime
totale uitvoeringstijd, seconden
- Type: string | nullversion
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
curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/bing/keyword_performance/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"location_code": 2840,
"language_code": "en",
"keywords": [
"dataforseo",
"seo",
"ranking"
]
}
]'
{
"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,
"year": null,
"month": null,
"keyword_kpi": {
"desktop": [
"[Max Depth Exceeded]"
],
"mobile": [
"[Max Depth Exceeded]"
],
"tablet": [
"[Max Depth Exceeded]"
]
}
}
]
}
]
}