Similarweb API v5 (generated from docs.similarweb.com/api-v5 pages) / Category Top Keywords

Request parameters

• asc query · optional

  Orders the results by ascending or descending

• brands query · optional

  Optional comma-separated brand names to restrict results (case-sensitive matching per gateway).

• category_id query · required

  Custom category UUID from the describe endpoint's custom_categories list (required on analytics endpoints).

• domains query · optional

  Optional comma-separated retailer domains (without 'www.') to restrict results. Use categories/domains or describe category filters to discover valid domains.

• end_date query · required

  End date in 'YYYY-MM' or 'YYYY-MM-DD' format or relative keywords: latest, X_months_ago, X_days_ago

• format query · optional

  Format in which the reply should be returned

• granularity query · optional

  Time granularity for the returned values

• keyword_contains query · optional

  Filter keywords containing this text.

• keyword_not_contains query · optional

  Filter keywords not containing this text.

• keyword_total_clicks_max query · optional

  Maximum keyword total clicks.

• keyword_total_clicks_min query · optional

  Minimum keyword total clicks.

• limit query · optional

  Sets how many results to return.

• market_code query · optional

  Optional two-letter market code (e.g., 'us', 'uk'). Omit to include all markets. Use describe to list supported values.

• metrics query · optional

  Comma-separated metrics: keyword, keyword_total_clicks, keyword_clicks_change, selected_brand_clicks, selected_brand_share, top_brand, top_brand_share.

• mtd query · optional

  When true with weekly granularity, end_date is set to the latest available Saturday. NOT supported for monthly granularity.

• offset query · optional

  Defines the number of results to skip

• selected_brand_clicks_max query · optional

  Maximum selected brand clicks.

• selected_brand_clicks_min query · optional

  Minimum selected brand clicks.

• selected_brand_share_max query · optional

  Maximum selected brand share.

• selected_brand_share_min query · optional

  Minimum selected brand share.

• sort query · optional

  Selects a specific metric to order results by

• start_date query · required

  Start date in 'YYYY-MM' or 'YYYY-MM-DD' format or relative keywords: latest, X_months_ago, X_days_ago

• top_brands query · optional

  Filter results to keywords where the top-clicked brand.