> ## Documentation Index > Fetch the complete documentation index at: https://docs.fandom.ai/llms.txt > Use this file to discover all available pages before exploring further. # List campaigns > Newest first. Scope: `campaigns:read`. ## OpenAPI ````yaml /api-reference/openapi.json get /campaigns openapi: 3.1.0 info: title: Fandom API version: 1.0.0 description: >- Campaigns, targeting, audiences, data stores, brands and Audience Exploration. The same operations are available as MCP tools at /mcp. servers: - url: https://fandom-api-preview.vercel.app/api/v1 - url: https://www.fandom.ai/api/v1 security: - bearerAuth: [] tags: - name: Workspace description: What's in the workspace. - name: Campaigns description: Campaigns, as the app's Marketing section shows them. - name: Targeting description: Keywords, segments, topics and websites for each audience on a campaign. - name: Google Ads description: Connected accounts, performance, and creating campaigns in Google Ads. - name: Audiences description: Saved audiences you can attach to campaigns. - name: Data stores description: >- YouTube channels and videos, with their comments, that audiences are built from. - name: Brands description: Brands that campaigns belong to. - name: Audience Exploration description: >- Who an audience is on YouTube: the channels they watch and how they group. Invite-only for now. paths: /campaigns: get: tags: - Campaigns summary: List campaigns description: |- Newest first. Scope: `campaigns:read`. operationId: list_campaigns parameters: - name: search in: query required: false description: Only items whose name contains this text. schema: anyOf: - not: {} - type: string maxLength: 200 - name: limit in: query required: false description: How many to return, 1–100. Default 25. schema: anyOf: - not: {} - type: integer minimum: 1 maximum: 100 - name: cursor in: query required: false description: The `nextCursor` from the previous page. schema: anyOf: - not: {} - type: string maxLength: 64 - name: brandId in: query required: false description: Only this brand's campaigns. schema: anyOf: - not: {} - type: string pattern: ^[a-f0-9]{24}$ description: Brand id. responses: '200': description: Success content: application/json: schema: type: object properties: data: type: array items: type: object properties: id: type: string name: type: string status: type: string description: >- `draft`, `loading` (collecting data), `ready` or `error`. objective: type: string brandId: type: - string - 'null' brand: type: object properties: name: type: string website: type: string description: type: string required: - name - website - description additionalProperties: false industry: type: string language: type: string locations: type: array items: type: string successMetrics: type: array items: type: string campaignType: type: - string - 'null' budget: type: - number - 'null' description: In the account's currency. budgetType: anyOf: - type: string enum: - daily - total - type: 'null' endDate: type: - string - 'null' biddingStrategy: type: - string - 'null' targetCpa: type: - number - 'null' targetRoas: type: - number - 'null' audiences: type: array items: type: object properties: id: type: string description: >- This audience's slot on the campaign. Stable; use it for targeting. name: type: string audienceId: type: - string - 'null' description: >- The saved audience, or null for the campaign's own primary audience. dataStoreIds: type: array items: type: string required: - id - name - audienceId - dataStoreIds additionalProperties: false googleAds: type: object properties: customerId: type: - string - 'null' accountName: type: - string - 'null' campaignId: type: - string - 'null' description: Set once the campaign exists in Google Ads. status: type: - string - 'null' required: - customerId - accountName - campaignId - status additionalProperties: false url: type: string description: Opens the campaign in Fandom. createdAt: type: - string - 'null' updatedAt: type: - string - 'null' required: - id - name - status - objective - brandId - brand - industry - language - locations - successMetrics - campaignType - budget - budgetType - endDate - biddingStrategy - targetCpa - targetRoas - audiences - googleAds - url - createdAt - updatedAt additionalProperties: false nextCursor: type: - string - 'null' description: >- Pass as `cursor` to get the next page. Null on the last page. required: - data - nextCursor additionalProperties: false '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/RateLimited' components: responses: BadRequest: description: >- The request is missing something or has a bad value. The message says what. content: application/json: schema: $ref: '#/components/schemas/Error' Unauthorized: description: No API key, or the key is wrong or revoked. content: application/json: schema: $ref: '#/components/schemas/Error' Forbidden: description: >- The key doesn't have the scope, or isn't allowed this campaign or account. content: application/json: schema: $ref: '#/components/schemas/Error' RateLimited: description: More than 120 requests in a minute. Wait and retry. content: application/json: schema: $ref: '#/components/schemas/Error' schemas: Error: type: object required: - error properties: error: type: object required: - code - message properties: code: type: string description: Stable, machine-readable. examples: - not_found message: type: string description: Plain-language explanation. requestId: type: string description: Quote this when asking for help. securitySchemes: bearerAuth: type: http scheme: bearer description: An API key from Settings → API access, starting with `fnd_`. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.