> ## Documentation Index > Fetch the complete documentation index at: https://docs.get3rd.com/llms.txt > Use this file to discover all available pages before exploring further. # List brands > Every active brand this key can read. An unscoped key returns every active brand in its organization; a key limited to specific brands returns only those. Use a brand's `id` as the `brandId` parameter on the other endpoints. Returns the matching brands in one response — no pagination, no date filter. ## OpenAPI ````yaml https://app.get3rd.com/api/export/v1/openapi.json get /api/export/v1/brands openapi: 3.1.0 info: title: 3RD Export API version: 1.0.0 description: >- Read-only access to a brand's AI-visibility data: daily visibility by model and market, the URLs the models cite and the Citation Share they add up to, daily brand sentiment, the Recommended rate, and the same visibility measure for tracked competitors. Built for loading into a BI tool, a warehouse, or a data-normalization service. Every endpoint is a `GET`, returns JSON, and never writes. **Authentication.** Send an export API key in the `X-API-Key` header. Keys are created by an organization owner or admin under Settings → Looker Studio in the 3RD app, are shown once, and can be revoked at any time (revocation is immediate). The organization needs an active paid plan. An unscoped key reads every active brand in the organization that issued it. A key limited to specific brands reads only those. A key stops working once the owner or admin who created it leaves the organization or loses that role. **Pagination.** Responses are cursor-paginated at 1000 rows per page. Follow `pagination.nextCursor` until `pagination.hasMore` is false. Do not construct cursors yourself — the encoding is not part of this contract. **History.** The window is capped by the organization's plan (lite: no access, pro: 90 days, agency: 180 days, enterprise: full history). A request for a wider window is silently clamped rather than rejected, so read `meta.fromDate` to see what was actually returned. **Rate limit.** 100 requests per minute. A request that carries a session cookie or an `Authorization` header shares that session's budget. Otherwise the budget is the client IP together with the User-Agent, so a different User-Agent is a separate budget. The `X-API-Key` header is not its own budget. Exceeding the budget returns 429. **Ad performance is not on this API.** Paid-placement data is currently available only through the MCP server, reads live from the ad platform with a fixed 30-day window, and cannot be backfilled. servers: - url: https://app.get3rd.com security: - ApiKeyAuth: [] tags: - name: Export description: >- Brand visibility, citations, Citation Share, sentiment, Recommended rate and competitor data. paths: /api/export/v1/brands: get: tags: - Export summary: List brands description: >- Every active brand this key can read. An unscoped key returns every active brand in its organization; a key limited to specific brands returns only those. Use a brand's `id` as the `brandId` parameter on the other endpoints. Returns the matching brands in one response — no pagination, no date filter. operationId: listBrands parameters: [] responses: '200': description: Success content: application/json: schema: type: object properties: data: type: array items: $ref: '#/components/schemas/BrandsRow' required: - data '401': description: >- Missing, unknown, revoked, expired, or wrongly scoped API key, or one whose creator is no longer an owner or admin of the organization content: application/json: schema: $ref: '#/components/schemas/Error' '403': description: The key's organization has no active paid plan content: application/json: schema: $ref: '#/components/schemas/Error' '429': description: Rate limit exceeded content: application/json: schema: $ref: '#/components/schemas/Error' components: schemas: BrandsRow: type: object properties: id: type: string description: Brand id (UUID) — pass as `brandId` to the other endpoints name: type: string description: >- Canonical brand name. Stable — consumers of this versioned endpoint key off it displayName: type: - string - 'null' description: Friendly label shown in the app; null when the brand has none set url: type: - string - 'null' deprecated: true description: >- Deprecated: the website as first entered, which can carry a stray path or tracking parameters. Use `siteUrl` siteUrl: type: - string - 'null' description: >- Brand's website: its primary tracked domain, plus the tracked section when the brand tracks only part of the site. Null when the brand has no tracked domain industry: type: - string - 'null' description: Industry the brand was classified into createdAt: type: string format: date-time description: When the brand was added, ISO 8601 required: - id - name - createdAt Error: type: object properties: error: type: string description: Human-readable failure reason. required: - error securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key description: >- Export API key, format `3rd_live_<64 hex characters>`. Created under Settings → Looker Studio. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.