DataForSEO Content Analysis API icon

DataForSEO Content Analysis API

DataForSEO

Get Category Trends

AI-generated

Summary

Fetches category trend data from DataForSEO for a specified category code and date range, with optional filtering and grouping.

Inputs

  • category_code (required) — Category code to analyse (see DataForSEO categories documentation).
  • date_from (required) — Start date of the time range (minimum 2019-01-15). Time part is ignored; only date is used.
  • date_to — End date of the time range; if omitted, today's date is used.
  • page_type — Page types to include: blogs, ecommerce, message-boards, news, organization. Empty array means all types.
  • search_mode — Results grouping: 'as_is' (all entries) or 'one_per_domain' (one per domain). Default: 'as_is'.
  • internal_list_limit — Maximum number of elements within internal arrays (1-20). Default: 1.
  • date_group — Granularity for grouping results: 'day', 'week', or 'month'. Default: 'month'.
  • initial_dataset_filters — JSON array of filter conditions to apply to the dataset (see DataForSEO filters documentation).
  • rank_scale — Scale for domain rank and URL rank values: 'one_hundred' (0-100) or 'one_thousand' (0-1000). Default: 'one_thousand'.

Output shape

object

Raw JSON response from the /content_analysis/category_trends/live endpoint.

Links

Discussion