> ## Documentation Index > Fetch the complete documentation index at: https://developers.scrunch.com/llms.txt > Use this file to discover all available pages before exploring further. # List Sites > List the brand's sites. A domain can have more than one row, and each route accepts only some of them: pass the `id` with `agent_pages_active: true` to the Agent Pages force refresh, and the one with `agent_traffic_active: true` to agent traffic. ## OpenAPI ````yaml /api-reference/openapi.json get /{brand_id}/sites openapi: 3.1.0 info: title: Scrunch Data API version: 0.1.0 servers: - url: https://api.scrunchai.com/v1 security: [] paths: /{brand_id}/sites: get: tags: - agent-pages summary: List Sites description: >- List the brand's sites. A domain can have more than one row, and each route accepts only some of them: pass the `id` with `agent_pages_active: true` to the Agent Pages force refresh, and the one with `agent_traffic_active: true` to agent traffic. operationId: listSites parameters: - name: brand_id in: path required: true schema: type: integer title: Brand Id responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/CollectionResponse_PublicSite_' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - HTTPBearer: [] components: schemas: CollectionResponse_PublicSite_: properties: total: type: integer title: Total offset: type: integer title: Offset default: 0 limit: anyOf: - type: integer - type: 'null' title: Limit items: items: $ref: '#/components/schemas/PublicSite' type: array title: Items metadata: anyOf: - $ref: '#/components/schemas/TimeSeriesMetadata' - type: 'null' type: object required: - total - items title: CollectionResponse[PublicSite] HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError PublicSite: properties: id: type: string title: Id description: >- Site ID. Pass it as `{site_id}` to a route whose flag below is `true`. domain: type: string title: Domain description: The site's registered domain. agent_pages_active: type: boolean title: Agent Pages Active description: >- Whether this site accepts an Agent Pages force refresh. Other sites return 404 or 409. agent_traffic_active: type: boolean title: Agent Traffic Active description: >- Whether `GET /{brand_id}/sites/{site_id}/agent-traffic` accepts this site. Other sites return 404. type: object required: - id - domain - agent_pages_active - agent_traffic_active title: PublicSite TimeSeriesMetadata: properties: aggregation_granularity: $ref: '#/components/schemas/AggregationGranularity' description: 'The aggregation granularity: daily, weekly, or monthly' period_count: type: integer title: Period Count description: The number of periods in the time series start_date: type: string format: date-time title: Start Date description: The start date of the time series end_date: type: string format: date-time title: End Date description: The end date of the time series top_domains: anyOf: - $ref: '#/components/schemas/TopDomainsMetadata' - type: 'null' description: Top domains metadata (only populated by sources/domains endpoints) type: object required: - aggregation_granularity - period_count - start_date - end_date title: TimeSeriesMetadata ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError AggregationGranularity: type: string enum: - daily - weekly - monthly TopDomainsMetadata: properties: domains: items: $ref: '#/components/schemas/TopDomainSummary' type: array title: Domains description: Top domains by observation count (always domain-level aggregated) grand_total: type: integer title: Grand Total description: Total observation count across all domains (for calculating 'Other') owner_totals: additionalProperties: type: integer type: object title: Owner Totals description: Observation counts by owner type (brand, competitor, other) owner_time_series: anyOf: - items: $ref: '#/components/schemas/OwnerTimeSeriesPoint' type: array - type: 'null' title: Owner Time Series description: Time series data by owner type for trend visualization segment_totals: items: $ref: '#/components/schemas/SegmentTotal' type: array title: Segment Totals description: >- Server-side observation counts per citation segment (covers all domains, not just top-N) type: object required: - domains - grand_total - owner_totals title: TopDomainsMetadata description: Metadata about top domains, used by sources/domains endpoints. TopDomainSummary: properties: domain: type: string title: Domain domain_owner: type: string title: Domain Owner observation_count: type: integer title: Observation Count type: object required: - domain - domain_owner - observation_count title: TopDomainSummary OwnerTimeSeriesPoint: properties: time_bucket: type: string title: Time Bucket description: Date string for the time bucket (YYYY-MM-DD) brand: type: integer title: Brand description: Observation count for brand-owned domains competitor: type: integer title: Competitor description: Observation count for competitor-owned domains other: type: integer title: Other description: Observation count for third-party domains type: object required: - time_bucket - brand - competitor - other title: OwnerTimeSeriesPoint description: A single time bucket with observation counts by owner type. SegmentTotal: properties: name: type: string title: Name observation_count: type: integer title: Observation Count type: object required: - name - observation_count title: SegmentTotal description: Observation count for a citation segment, computed server-side. securitySchemes: HTTPBearer: type: http scheme: bearer ```` ## Related topics - [Agent Pages Force Refresh: Update Pages on Demand](https://developers.scrunch.com/api-reference/agent-pages/force-refresh-overview.md) - [Configuration API: Manage Brands and Prompts](https://developers.scrunch.com/api-reference/configuration/overview.md) - [Agent Traffic API: Monitor AI Bot Crawls](https://developers.scrunch.com/api-reference/agent-traffic/overview.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.