> ## 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. # Create a data store > Collects YouTube channels and videos, with their comments, in the background. Starts as `collecting`; poll Get a data store until `ready`. Scope: `datasets:write`. Send an `Idempotency-Key` header to make retries safe. ## OpenAPI ````yaml /api-reference/openapi.json post /data-stores 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: /data-stores: post: tags: - Data stores summary: Create a data store description: >- Collects YouTube channels and videos, with their comments, in the background. Starts as `collecting`; poll Get a data store until `ready`. Scope: `datasets:write`. Send an `Idempotency-Key` header to make retries safe. operationId: create_data_store parameters: - name: Idempotency-Key in: header required: false description: >- Any unique string. Repeating a request with the same key returns the first result instead of doing it twice. schema: type: string maxLength: 200 requestBody: required: true content: application/json: schema: type: object properties: name: type: string minLength: 1 maxLength: 160 sources: type: array items: type: object properties: url: type: string minLength: 1 maxLength: 1000 description: A YouTube channel or video URL. type: type: string enum: - channel - video description: Detected from the URL when left out. videosPerChannel: type: integer minimum: 1 maximum: 50 description: Recent videos to read per channel. Default 10. required: - url additionalProperties: false minItems: 1 maxItems: 100 private: type: boolean description: Only visible to the key's creator. Default false. required: - name - sources additionalProperties: false example: name: Building toy channels sources: - url: https://www.youtube.com/@LEGO videosPerChannel: 10 - url: https://www.youtube.com/watch?v=dQw4w9WgXcQ responses: '201': description: Success content: application/json: schema: type: object properties: id: type: string name: type: string description: type: string status: type: string description: >- `collecting`, `ready` or `error`. Collection usually takes minutes. error: type: - string - 'null' scope: type: string enum: - workspace - private - library description: '`library` stores are shared by Fandom and read-only.' channelCount: type: number videoCount: type: number createdAt: type: - string - 'null' updatedAt: type: - string - 'null' readyAt: type: - string - 'null' required: - id - name - description - status - error - scope - channelCount - videoCount - createdAt - updatedAt - readyAt additionalProperties: false '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '409': $ref: '#/components/responses/Conflict' '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' Conflict: description: >- The current state doesn't allow this (for example, it's already done or still generating). 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.