Skip to content
BrandVisibility.ai

Citations

Read cited domains or URLs, including rolling 90-day and all-time measures.

GET /api/v1/reporting/teams/{team_id}/citations
Terminal window
curl --fail-with-body "https://api.brandvisibility.ai/api/v1/reporting/teams/$TEAM_ID/citations" \
  -H "Authorization: Bearer $BRANDVISIBILITY_API_KEY"

Parameters

Section titled “Parameters”
Parameter Location Required Description
team_id path Yes {"format": "uuid"}
level query No {"enum": ["domain", "url"], "default": "domain"}
sort query No {"enum": ["references_last_90_days", "references_all_time", "first_cited_at", "last_cited_at", "source"], "default": "references_last_90_days"}
direction query No {"enum": ["asc", "desc"], "default": "desc"}
provider_id query No Restrict to one AI provider
limit query No Page size, 1-200 {"maximum": 200, "minimum": 1, "default": 50}
cursor query No next_cursor from the previous page

Response fields

Section titled “Response fields”

These fields appear in data (one object or a list, depending on the endpoint). The OpenAPI document defines exact types, nullable values and response envelopes.

Field Meaning
source Domain (level=domain) or URL (level=url)
level See the downloadable schema for the complete type and nullability.
domain_ranking See the downloadable schema for the complete type and nullability.
references_last_90_days See the downloadable schema for the complete type and nullability.
share_last_90_days See the downloadable schema for the complete type and nullability.
mentions_own_brand_last_90_days See the downloadable schema for the complete type and nullability.
references_all_time See the downloadable schema for the complete type and nullability.
share_all_time See the downloadable schema for the complete type and nullability.
first_cited_at See the downloadable schema for the complete type and nullability.
last_cited_at See the downloadable schema for the complete type and nullability.
is_own_domain See the downloadable schema for the complete type and nullability.
competitor_brand_id See the downloadable schema for the complete type and nullability.
competitor_name See the downloadable schema for the complete type and nullability.

Requires read-only reporting access. Team-scoped requests return 404 if the credential cannot access that team. See authentication, pagination and dates, and errors and rate limits.