DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Hustota klíčových slov
Četnost slov a frází v procházení, kde keyword_length volí velikost n-gramu. Vrací total_items_count, items_count a items. Načítá dokončené procházení, takže potřebuje id z post_dataforseo_on_page_submit a vrací crawl_progress a crawl_status s hodnotami max_crawl_pages, pages_in_queue a pages_crawled — zkontrolujte je, než budete malému výsledku důvěřovat, protože procházení, které stále běží, má prostě méně co hlásit. Popisuje, co o sobě říká web; o tom, co o něm říká internet, vypovídá post_dataforseo_backlinks_anchors_live a o tom, co lidé hledají, post_dataforseo_keywords_gads_search_volume_live. 💰 Zdarma na straně upstreamu: dotaz na dokončené procházení nic nestojí, platí se jen samotné procházení.
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. Znovu jej neaplikujte na již 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)[]
- filtersTyp: array (object | null)[] | null
pole parametrů pro filtrování výsledků
volitelné pole
můžete přidat několik filtrů najednou (maximálně 8 filtrů)
mezi podmínkami je nutné nastavit logický operátorand,or
podporované operátory:regex,not_regex,=,<>,in,not_in,like,not_like
operátor%můžete použít slikeanot_likepro shodu s libovolným řetězcem o nule nebo více znacích
příklad:["keyword","=","%seo%"][["keyword","=","%seo%"],
"and",
["frequency","<","6"]][["keyword","not_like","%seo%"],
"and",
[["frequency",">","6"],"or",["density",">","0.02"]]]Prázdný objekt - idTyp: string
- keywordTyp: integer
_length počet slov pro klíčové slovo
povinné pole
možné hodnoty:1,2,3,4,5 - limitTyp: integer | null
maximální počet vrácených klíčových slov
volitelné pole
výchozí hodnota:100
maximální hodnota:1000 - orderTyp: array string[] | null
_by pravidla řazení výsledků
volitelné pole
k řazení výsledků můžete použít stejné hodnoty jako v polifilters
možné typy řazení:asc- výsledky budou seřazeny vzestupnědesc- výsledky budou seřazeny sestupně
typ řazení nastavte pomocí čárky
příklad:["frequency,desc"]
pamatujte, že v jednom požadavku můžete nastavit maximálně tři pravidla řazení
jednotlivá pravidla řazení oddělte čárkou
příklad:["keyword,asc","frequency,desc"] - 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 - urlTyp: string | null
URL stránky
volitelné pole
pokud zde stránku nezadáte, výsledky budou poskytnuty pro celý web
pokud toto pole použijete, odpověď API bude obsahovat pouze klíčová slova ze zadané stránky
stránku je nutné zadat jako absolutní URL (včetněhttp://nebohttps://)
- Typ: object | null · Response36Afe1097B20_OnPageKeywordDensityResponseInfo200
- 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_OnPageKeywordDensityTaskInfo
- 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ů
- crawlTyp: string | null
_progress stav relace procházení
možné hodnoty:in_progress,finished - crawlTyp: object | null · Response36Afe1097B20_CrawlStatusInfo
_status podrobnosti relace procházení
- maxTyp: integer | null Formát: int64
_crawl _pages maximální počet stránek k procházení udává limit max_crawl_pages, který jste zadali při nastavování úlohy
- pagesTyp: integer | null Formát: int64
_crawled počet procházených stránek
- pagesTyp: integer | null Formát: int64
_in _queue počet stránek, které jsou aktuálně ve frontě procházení
- itemsTyp: array (object | null)[] | null
pole položek
- densityTyp: number | null
hustota klíčových slov
vypočítá se jako poměrfrequencyk celkovému počtu klíčových slov se zadanoukeyword_lengthna webové stránce nebo webu - frequencyTyp: integer | null
frekvence klíčového slova
počet výskytů klíčového slova na webu (nebo na stránce, pokud zadáteurl) - keywordTyp: string | null
vrácené klíčové slovo
- itemsTyp: integer | null Formát: int64
_count počet položek v poli výsledků
- totalTyp: integer | null Formát: int64
_items _count celkový počet relevantních položek
celkový počet klíčových slov na zadaném webu nebo webové stránce odpovídajících zadanékeyword_lengthafilters
- 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/on_page/keyword_density \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"id": "09101923-1535-0216-0000-2389a8854b70",
"url": "https://dataforseo.com/",
"keyword_length": 2,
"filters": [
"frequency",
">",
5
]
}
]'
{
"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": [
{
"crawl_progress": null,
"crawl_status": {
"max_crawl_pages": null,
"pages_in_queue": null,
"pages_crawled": null
},
"total_items_count": null,
"items_count": null,
"items": [
{
"keyword": null,
"frequency": null,
"density": null
}
]
}
]
}
]
}