Content Analysis – API trendů kategorií
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Content Analysis – API trendů kategorií
Stejné metriky po obdobích jako post_dataforseo_content_phrase_trends_live, ale pro celou kategorii produktů místo jednoho klíčového slova. Bere category_code z get_dataforseo_content_categories, přičemž date_from, date_to a date_group určují rozsah a granularitu, a pro každé období vrací date plus total_count, rank, top_domains (každý s domain a count), sentiment_connotations (hněv, štěstí, láska, smutek, sdílení, zábava), connotation_types (pozitivní, negativní, neutrální), text_categories, page_categories, page_types, countries a languages. Pomáhá sledovat, jak se trh vyvíjí, nikoli jednu frázi; na endpoint frází přejděte, když už znáte přesné znění, které vás zajímá.
Referenční ceny
- Účtování: vykázaná cena odpovědi.
- Referenční odhad ceny požadavku: USD 0.0276.
- 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 ani 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)[]
- categoryTyp: integer | null
_code - dateTyp: string
_from počáteční datum časového rozsahu
povinné pole
minimální hodnota:2022-10-31
formát data:"yyyy-mm-dd"
příklad:"2019-01-15" - dateTyp: string | null
_group časový rozsah, který bude použit k seskupení výsledků
volitelné pole
výchozí hodnota:month
možné hodnoty:day,week,month - dateTyp: string | null
_to koncové datum časového rozsahu
volitelné pole
pokud toto pole nezadáte, použije se ve výchozím nastavení dnešní datum
formát data:"yyyy-mm-dd"
příklad:"2019-01-15" - initialTyp: array (object | null)[] | null
_dataset _filters parametry filtrování počáteční datové sady
volitelné pole
počáteční parametry filtrování, které se vztahují na pole v endpointu Search;
můžete přidat několik filtrů najednou (maximálně 8)
mezi podmínkami je nutné nastavit logický operátorand,or
podporované operátory:regex,not_regex,<,<=,>,>=,=,<>,in,not_in,like,not_like,has,has_not,match,not_match
operátor%můžete použít slikeanot_likepro shodu s libovolným řetězcem o nule nebo více znacích
příklad:["domain","<>", "logitech.com"][["domain","<>","logitech.com"],"and",["content_info.connotation_types.negative",">",1000]][["domain","<>","logitech.com"]],
"and",
[["content_info.connotation_types.negative",">",1000],
"or",["content_info.text_category","has",10994]]]
další informace o filtrech najdete v Content Analysis API - Filters
další informace o filtrech počáteční datové sady najdete v tomto článku Centra nápovědy.Prázdný objekt - internalTyp: integer | null
_list _limit maximální počet prvků ve vnitřních polích
volitelné pole
toto pole můžete použít k omezení počtu prvků v následujících polích:top_domainstext_categoriespage_categoriescountrieslanguages
výchozí hodnota:1
maximální hodnota:20 - pageTyp: array string[] | null
_type cílové typy stránek
volitelné pole
tento parametr použijte k filtrování datové sady podle typů stránek
možné hodnoty:"ecommerce","news","blogs","message-boards","organization" - rankTyp: string | null
_scale určuje škálu použitou pro výpočet a zobrazení hodnot
rank
volitelné poletento parametr můžete použít k volbě, zda se hodnoty rank zobrazují na škále 0–100, nebo 0–1000
možné hodnoty:
one_hundred— hodnoty rank se zobrazují na škále 0–100one_thousand— hodnoty rank se zobrazují na škále 0–1000výchozí hodnota:
one_thousanddalší informace o tom, jak tento parametr funguje, najdete v tomto článku Centra nápovědy
- searchTyp: string | null
_mode typ seskupení výsledků
volitelné pole
možné typy seskupení:as_is— vrací data o všech citacích pro cílovýcategory_codeone_per_domain— vrací data o jedné citacicategory_codena doménu
výchozí hodnota:as_is - 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_ContentAnalysisCategoryTrendsLiveResponseInfo200
- 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_ContentAnalysisCategoryTrendsLiveTaskInfo
- 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ů
- connotationTyp: object | null
_types typy konotací
obsahuje typy sentimentů (polaritu sentimentu) související s citací kategorie a počet citací pro každý typ sentimentu
možné typy konotací:"positive","negative","neutral"- propertyTyp: integer | null Formát: int64
Name Signed 64-bit integers (long type).
- countriesTyp: object | null
- propertyTyp: integer | null Formát: int64
Name Signed 64-bit integers (long type).
- dateTyp: string | null
datum, pro které jsou data poskytnuta
- languagesTyp: object | null
- propertyTyp: integer | null Formát: int64
Name Signed 64-bit integers (long type).
- pageTyp: array (object | null)[] | null
_categories - categoryTyp: array (integer | null)[] | null
- countTyp: integer | null Formát: int64
Signed 64-bit integers (long type).
- pageTyp: object | null
_types typy stránek
obsahuje typy stránek a počet citací pro každý typ stránky- propertyTyp: integer | null Formát: int64
Name Signed 64-bit integers (long type).
- rankTyp: integer | null
pořadí všech URL citujících
keyword
normalizovaný součet pořadí všech URL citujících cílovékeywordpro dané datum - sentimentTyp: object | null
_connotations konotace sentimentu
obsahuje sentimenty (emoční reakce) související s citací cílové kategorie a počet citací pro každý sentiment
možné konotace:"anger","fear","happiness","love","sadness","share","neutral","fun"- propertyTyp: integer | null Formát: int64
Name Signed 64-bit integers (long type).
- textTyp: array (object | null)[] | null
_categories - categoryTyp: array (integer | null)[] | null
- countTyp: integer | null Formát: int64
Signed 64-bit integers (long type).
- topTyp: array (object | null)[] | null
_domains hlavní domény citující cílové klíčové slovo
obsahuje objekty s hlavními doménami citujícími cílovou kategorii a počet citací pro každou doménu- countTyp: integer | null Formát: int64
Signed 64-bit integers (long type).
- domainTyp: string | null
- totalTyp: integer | null Formát: int64
_count celkový počet výsledků v naší databázi relevantních pro váš požadavek
- typeTyp: string | null
typ prvku
- 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/content_analysis/category_trends/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"category_code": 10994,
"search_mode": "as_is",
"date_from": "2022-09-01",
"date_group": "month"
}
]'
{
"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": [
{
"type": null,
"date": null,
"total_count": null,
"rank": null,
"top_domains": [
{
"domain": null,
"count": null
}
],
"sentiment_connotations": null,
"connotation_types": null,
"text_categories": [
{
"category": [
"[Max Depth Exceeded]"
],
"count": null
}
],
"page_categories": [
{
"category": [
"[Max Depth Exceeded]"
],
"count": null
}
],
"page_types": null,
"countries": null,
"languages": null
}
]
}
]
}