DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Načtení výsledků hledanosti podle id
Načte zařazenou úlohu hledanosti Google Ads podle id. Stejný tvar jako post_dataforseo_keywords_gads_search_volume_live. Zabaleno do obálky DataForSEO: data v tasks[0].result, výsledek v tasks[0].status_code – odmítnutý požadavek stále vrací HTTP 200.
Cenová reference
- Účtování: nahlášené náklady na odpověď.
- Referenční odhad požadavku: USD 0.012.
- Referenční multiplikátor zákazníka: 1.0. Neaplikujte jej znovu na zúčtovanou částku zákazníka.
Pouze referenční metadata, nikoli nabídka pro účet, garantovaná cena či limit utrácení. Kredity prostředků nejsou kredity Felo. Konečné účtování se řídí fakturačními záznamy Felo.
- Typ: object | null · Response36Afe1097B20_KeywordsDataGoogleAdsSearchVolumeTaskGetResponseInfo200
- Typ: number | null Formát: doublecost
celkové náklady na úlohy, USD
- Typ: integer | nullstatus
_code obecný kód stavu úplný seznam kódů odpovědí najdete zde
- Typ: string | nullstatus
_message obecná informační zpráva úplný seznam obecných informačních zpráv najdete zde
- Typ: array (object | null)[] | nulltasks
pole úloh
- Typ: object | null · Response36Afe1097B20_KeywordsDataGoogleAdsSearchVolumeTaskGetTaskInfo
- costTyp: number | null Formát: double
celkové náklady na úlohy, USD
- dataTyp: object | null
obsahuje stejné parametry, které jste zadali v požadavku POST
- propertyTyp: object | null
Name
- idTyp: string | null
identifikátor úlohy jedinečný identifikátor úlohy v našem systému ve formátu UUID
- pathTyp: array (string | null)[] | null
cesta URL
- resultTyp: array (object | null)[] | null
pole výsledků
- competitionTyp: string | null
- competitionTyp: integer | null
_index - cpcTyp: number | null
cena za kliknutí
udává částku zaplacenou (USD) za každé kliknutí na reklamu zobrazenou pro dané klíčové slovo - highTyp: number | null
_top _of _page _bid maximální nabídka, aby se reklama zobrazovala v horní části první stránky
udává hodnotu vyšší než přibližně 80 % nejnižších nabídek, při kterých se reklamy zobrazovaly (na základě statistik Google Ads pro inzerenty);
hodnota se může lišit v závislosti na lokalitě uvedené v požadavku POST - keywordTyp: string | null
klíčové slovo
klíčové slovo se vrací s dekódovaným %## (znak '+' bude dekódován jako mezera) - languageTyp: string | null
_code kód jazyka v poli POST
pokud nejsou k dispozici žádná data, hodnota jenull - locationTyp: integer | null
_code kód lokality v poli POST
pokud nejsou k dispozici žádná data, hodnota jenull - lowTyp: number | null
_top _of _page _bid minimální nabídka, aby se reklama zobrazovala v horní části první stránky
udává hodnotu vyšší než přibližně 20 % nejnižších nabídek, při kterých se reklamy zobrazovaly (na základě statistik Google Ads pro inzerenty);
hodnota se může lišit v závislosti na lokalitě uvedené v požadavku POST - monthlyTyp: array (object | null)[] | null
_searches měsíční vyhledávání
představuje (přibližný) počet vyhledávání daného námětu klíčového slova (ve výchozím nastavení dostupný za posledních dvanáct měsíců) v zadaných zeměpisných lokalitách;
pokud nejsou k dispozici žádná data, hodnota jenull- monthTyp: integer | null
Měsíc.
- searchTyp: integer | null
_volume průměrná měsíční hledanost
- yearTyp: integer | null
Rok.
- searchTyp: boolean | null
_partners udává, zda jsou v odpovědi zahrnuta data z partnerských sítí
- searchTyp: integer | null Formát: int64
_volume průměrná měsíční hledanost
- spellTyp: string | null
- resultTyp: integer | null Formát: int64
_count počet prvků v poli result
- statusTyp: integer | null
_code stavový kód úlohy vygenerovaný DataForSEO; může být v následujícím rozsahu: 10000-60000 úplný seznam kódů odpovědí najdete zde
- statusTyp: string | null
_message informační zpráva úlohy úplný seznam obecných informačních zpráv najdete zde
- timeTyp: string | null
doba provedení, sekundy
- Typ: integer | null Formát: int64tasks
_count počet úloh v poli tasks
- Typ: integer | null Formát: int64tasks
_error počet úloh v poli tasks vrácených s chybou
- Typ: string | nulltime
celková doba provádění, sekundy
- Typ: string | nullversion
aktuální verze API
application/json - 400
Požadavek se nepodařilo zpracovat. Zkontrolujte parametry požadavku.
- 401
Je vyžadován platný API klíč Felo.
- 402
V požadavku nelze pokračovat, protože není splněn požadavek na fakturaci.
- 403
Účet nemá oprávnění tuto operaci provést.
- 429
Byl dosažen limit požadavků nebo útraty.
- 502
Služba nemohla požadavek dokončit.
- 503
API nebo fakturační služba je dočasně nedostupná.
- 504
Při zpracování požadavku vypršel časový limit služby.
- default
Chybová odpověď; odpovědi předávané přímo od upstream poskytovatele mohou používat formáty poskytovatele
application/json
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'
{
"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
}
]
}
]
}
]
}