Agent analytics

Perception

Brand perception summaries for the selected project and scope.

GET/api/domains/{host}/agent-analytics

Request#

http
GET /api/domains/{host}/agent-analytics?section=perception
cURL
curl --fail-with-body 'https://app.keptai.com/api/domains/example.com/agent-analytics?section=perception&days=30' \
  -H "Authorization: Bearer $KEPT_API_TOKEN"

Parameters#

Parameter Values
host (path) Project domain without a scheme or path.
section Use perception for this page.
days 7, 30, or 90; default 30.
engine Supported engine ID; comma-separated values are supported.
topic, category, brand Optional comma-separated values from scope-options.

Response and interpretation#

The response is JSON in the perception section’s application shape. Preserve its structure when building an integration; do not assume it shares a schema with other sections. Use the actual returned data rather than invented example values.

Results depend on the available collected data and selected filters.

See Scope options for valid filters and Authentication for errors.

Search titles, guides, and API references.