citlyze docs
API

Attributes

The canonical attributes AI answers associate with tracked brands.

GET /api/v1/attributes returns the workspace's attribute registry: the canonical descriptors Brand Perception has clustered from what engines say about tracked brands (for example "easy to use" or "expensive"). Where each attribute was observed, and for which brand, is in attribute mentions.

Filters

ParameterMeaning
statusactive, or merged for attributes folded into another.

Standard parameters (limit, offset, format=csv) work as described in Pagination, filtering, and errors.

Key fields

  • attribute_id: stable identifier, referenced by attribute mentions
  • canonical_label: the attribute's display label
  • member_terms_json: the observed phrasings clustered under this label
  • status: active, or merged when the attribute has been consolidated into another entry
  • created_at: when the attribute first appeared

Rows are ordered by canonical_label, so offset pagination is stable.

Example

curl -H "Authorization: Bearer $AEO_API_KEY" \
  "https://app.citlyze.com/api/v1/attributes?status=active"

Use this resource as the lookup table for attribute mentions, and to see the vocabulary AI answers use around your category.

Auf dieser Seite