Vytváření úloh live ‘Clickstream Global Search Volume’
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Vytváření úloh live ‘Clickstream Global Search Volume’
Hledanost z clickstreamu pro keywords celosvětově, zcela bez argumentu lokality – globální součet a jeho rozdělení po zemích. 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. Použijte jej k rozhodnutí, které trhy stojí za volání pro konkrétní lokalitu; varianta s lokalitou je post_dataforseo_keywords_clickstream_search_volume_live.
Cenová reference
- Účtování: nahlášené náklady na odpověď.
- Referenční odhad požadavku: USD 0.09.
- 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: array (object | null)[]
- keywordsTyp: array string[]
cílová klíčová slova
povinné pole
kódování UTF-8
maximální počet klíčových slov, která můžete v tomto poli zadat: 1000;
každé klíčové slovo musí mít alespoň 3 znaky;
klíčová slova se převedou na malá písmena;
Poznámka: některé symboly a znaky (např. symboly UTF, emoji) nejsou povoleny
informace o tom, které symboly a znaky lze použít, najdete v tomto článkudalší informace o pravidlech a omezeních polí
keywordakeywordsv rozhraních DataForSEO najdete v tomto článku nápovědy - tagTyp: string | null
uživatelem definovaný identifikátor úlohy
volitelné pole
limit znaků je 255
tento parametr můžete použít k identifikaci úlohy a jejímu spárování s výsledkem
zadanou hodnotutagnajdete v objektudataodpovědi
- Typ: object | null · Response36Afe1097B20_KeywordsDataClickstreamDataGlobalSearchVolumeLiveResponseInfo200
- 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_KeywordsDataClickstreamDataGlobalSearchVolumeLiveTaskInfo
- 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ů
- itemsTyp: array (object | null)[] | null
obsahuje klíčová slova a související data
- countryTyp: array (object | null)[] | null
_distribution rozdělení clickstreamu podle zemí
představuje objem vyhledávání založený na clickstreamu v dostupných zemích a jeho procentuální podíl na globálním objemu vyhledávání- countryTyp: string | null
_iso _code kód ISO země
- percentageTyp: number | null
procento globálního objemu vyhledávání
- searchTyp: integer | null Formát: int64
_volume průměrná měsíční hledanost založená na clickstreamu
představuje (přibližný) počet vyhledávání daného námětu klíčového slova na základě clickstreamu
více o objemu vyhledávání z clickstreamu se dočtete v tomto článku centra nápovědy
- keywordTyp: string | null
klíčové slovo
klíčové slovo se vrací s dekódovaným %## (znak plus '+' bude dekódován jako mezera) - searchTyp: integer | null Formát: int64
_volume průměrná měsíční hledanost založená na clickstreamu
představuje (přibližný) počet vyhledávání daného námětu klíčového slova na základě clickstreamu
více o objemu vyhledávání z clickstreamu se dočtete v tomto článku centra nápovědy
- itemsTyp: integer | null Formát: int64
_count počet výsledků vrácených v poli
items
- 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/clickstream_data/global_search_volume/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"tag": "test-tag",
"keywords": [
"you tube",
"youtube",
"youtub"
]
}
]'
{
"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": [
{
"items_count": null,
"items": [
{
"keyword": null,
"search_volume": null,
"country_distribution": [
"[Max Depth Exceeded]"
]
}
]
}
]
}
]
}