Vytváření úloh live ‘Bulk Clickstream Search Volume’
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Vytváření úloh live ‘Bulk Clickstream Search Volume’
Hledanost z clickstreamu pro mnoho keywords v jednom volání, bez jazykové dimenze. 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. Varianta pro jedno klíčové slovo s jazykem je post_dataforseo_keywords_clickstream_search_volume_live. Protože cena je za volání, nikoli za klíčové slovo, je to ta správná volba pro seznam.
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 - locationTyp: integer
_code kód lokality
povinné pole, pokud nezadátelocation_name
Poznámka: je nutné zadat buďlocation_name, nebolocation_code
seznam dostupných lokalit s jejichlocation_codezískáte odesláním samostatného požadavku nahttps://api.dataforseo.com/v3/keywords_data/clickstream_data/locations_and_languages
příklad:2840 - locationTyp: string
_name úplný název lokality
povinné pole, pokud nezadátelocation_code
Poznámka: je nutné zadat buďlocation_name, nebolocation_code
seznam dostupných lokalit s jejichlocation_namezískáte odesláním samostatného požadavku nahttps://api.dataforseo.com/v3/keywords_data/clickstream_data/locations_and_languages
příklad:United Kingdom - 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_KeywordsDataClickstreamDataBulkSearchVolumeLiveResponseInfo200
- 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_KeywordsDataClickstreamDataBulkSearchVolumeLiveTaskInfo
- 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
- keywordTyp: string | null
klíčové slovo zadané v poli POST
- monthlyTyp: array (object | null)[] | null
_searches míry měsíční hledanosti
pole objektů s mírami hledanosti v určitém měsíci roku- monthTyp: integer | null
Měsíc.
- searchTyp: integer | null
_volume průměrná měsíční hledanost
- yearTyp: integer | null
Rok.
- searchTyp: integer | null Formát: int64
_volume aktuální hledanost klíčového slova
- itemsTyp: integer | null Formát: int64
_count počet výsledků vrácených v poli
items - locationTyp: integer | null
_code kód lokality v poli POST
- 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/bulk_search_volume/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"location_code": 2840,
"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": [
{
"location_code": null,
"items_count": null,
"items": [
{
"keyword": null,
"search_volume": null,
"monthly_searches": [
"[Max Depth Exceeded]"
]
}
]
}
]
}
]
}