Getting Started

Sections

Theme switcher

Brand/Category performance for a CRIQ custom category (aggregated)

Header Parameters

api-keystring

Query Parameters

granularitystring

Time granularity for the returned values

Enum values:
weekly
start_datestring Required

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

end_datestring Required

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

metricsarray

Comma-separated metrics: domain, views, number_of_skus, category_views, category_number_of_skus, views_share.

Style
form
Enum values:
domainviewsnumber_of_skuscategory_viewscategory_number_of_skusviews_share
mtdboolean

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

category_idstring Required

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

domainsarray

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

Style
form
market_codestring

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

aggregate_across_domainsboolean

When true, aggregates results across domains. Defaults to false on aggregated endpoints.

aggregate_across_timeboolean

When true, aggregates results across time; date is omitted from rows. Defaults to true on aggregated endpoints.

brand_namestring

Optional brand name. When provided, returns brand vs category metrics; when omitted, returns category performance only.

formatstring

Format in which the reply should be returned

Enum values:
jsonxml
limitinteger

Sets how many results to return.

offsetinteger

Defines the number of results to skip

ascboolean | null

Orders the results by ascending or descending

sortstring

Selects a specific metric to order results by

Response

200
Object

OK

Response Attributes

metaobject

Show child attributes

dataarray | null

Show child attributes

Was this section helpful?

GET

/

Select
1

Response

Was this section helpful?
View as Markdown

Ask an AI

Open in ChatGPTOpen in ClaudeOpen in Perplexity

Code with AI

Open in Copilot