Live-taken voor ‘DataForSEO Trends Merged Data’ instellen
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Live-taken voor ‘DataForSEO Trends Merged Data’ instellen
Explore-, demografie- en subregiongegevens voor dezelfde keywords in één respons in plaats van drie aanroepen. Verpakt in de DataForSEO-envelop: data in tasks[0].result, uitkomst in tasks[0].status_code – een geweigerd verzoek retourneert nog steeds HTTP 200. Gebruik het als je het volledige beeld wilt: de drie verwante endpoints kosten elk een aanroep en dit levert wat alle drie zouden opleveren.
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.
- Type: array (object | null)[]
- dateType: string | null
_from startdatum van de periode
optioneel veld
als je dit veld niet opgeeft, worden standaard de huidige dag en maand van het voorgaande jaar gebruikt
minimumwaarde voor het typeweb:2004-01-01
minimumwaarde voor andere typen:2008-01-01
datumformaat:"yyyy-mm-dd"
voorbeeld:"2019-01-15" - dateType: string | null
_to einddatum van de periode
optioneel veld
als je dit veld niet opgeeft, wordt standaard de datum van vandaag gebruikt
datumformaat:"yyyy-mm-dd"
voorbeeld:"2019-01-15" - keywordsType: array string[]
keywords
verplicht veld
maximaal aantal keywords dat u kunt opgeven: 5
vermijd symbolen en speciale tekens (bijv. UTF-symbolen, emoji's);
als u niet-Latijnse tekens opgeeft, ontvangt u gegevens voor de landen waar ze worden gebruiktmeer informatie over regels en beperkingen van de velden
keywordenkeywordsin DataForSEO-API's vindt u in dit Help Center-artikel - locationType: integer | null
_code locatiecode van de zoekmachine
optioneel veld
als u dit veld niet gebruikt, ontvangt u wereldwijde resultaten
als u dit veld gebruikt, hoeft ulocation_nameniet op te geven
de lijst met beschikbare locaties van de zoekmachines en hunlocation_codeontvangt u via een afzonderlijk verzoek aanhttps://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
let op: de gegevens worden geleverd voor het land waartoe de opgegevenlocation_codebehoort;
voorbeeld:2840 - locationType: string | null
_name volledige naam van de zoekmachinelocatie
optioneel veld
als u dit veld niet gebruikt, ontvangt u wereldwijde resultaten
als u dit veld gebruikt, hoeft ulocation_codeniet op te geven
de lijst met beschikbare locaties van de zoekmachine en hunlocation_nameontvangt u via een afzonderlijk verzoek aanhttps://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
let op: de gegevens worden geleverd voor het land waartoe de opgegevenlocation_namebehoort;
voorbeeld:United Kingdom - 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 - timeType: string | null
_range vooraf ingestelde tijdsbereiken
optioneel veld
als u de parametersdate_fromofdate_toopgeeft, wordt dit veld genegeerd bij het instellen van een taak
mogelijke waarden voor alletype-parameters:past_4_hours,past_day,past_7_days,past_30_days,past_90_days,past_12_months,past_5_years - typeType: string | null
elementtype
- Type: object | null · Response36Afe1097B20_KeywordsDataDataforseoTrendsMergedDataLiveResponseInfo200
- 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_KeywordsDataDataforseoTrendsMergedDataLiveTaskInfo
- 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
- datetimeType: string | null
datum en tijd waarop het resultaat is ontvangen
in UTC-indeling: “yyyy-mm-dd hh-mm-ss +00:00”
voorbeeld:2019-11-15 12:57:46 +00:00 - itemsType: array (object | null)[] | null
bevat keywordpopulariteit en gerelateerde gegevens
- keywordsType: array (string | null)[] | null
keywords in een POST-array
- positionType: integer | null
de uitlijning van het element
kan de volgende waarden hebben:1,2,3,4, enz. - typeType: string | null
elementtype
- itemsType: integer | null Formaat: int64
_count het aantal resultaten dat in de array
itemswordt geretourneerd - keywordsType: array (string | null)[] | null
keywords in een POST-array
- 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 - typeType: string | null
elementtype
- 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/dataforseo_trends/merged_data/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"keywords": [
"rugby",
"cricket"
],
"date_from": "2023-01-01",
"date_to": "2024-01-01",
"type": "web",
"location_name": "United States"
}
]'
{
"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": [
{
"keywords": [
null
],
"type": null,
"location_code": null,
"language_code": null,
"datetime": null,
"items_count": null,
"items": [
{
"type": null,
"position": null,
"keywords": [
"[Max Depth Exceeded]"
]
}
]
}
]
}
]
}