> ## Documentation Index > Fetch the complete documentation index at: https://docs.valyu.ai/llms.txt > Use this file to discover all available pages before exploring further. # List Datasources > Returns all available datasources with metadata, schemas, and pricing ## OpenAPI ````yaml GET /v1/datasources openapi: 3.0.3 info: title: Valyu API version: 2.2.0 description: > The search API built for AI agents. One API that gives your AI unified access to web search, academic papers, financial data, SEC filings, clinical trials, patents, and 36+ proprietary data sources. ## Products | Product | Endpoint | Description | | --- | --- | --- | | **Search** | `POST /v1/search` | Multi-source search across web and proprietary datasets | | **Contents** | `POST /v1/contents` | Extract clean, structured content from URLs | | **Answer** | `POST /v1/answer` | AI-powered answers with real-time search | | **DeepResearch** | `POST /v1/deepresearch/tasks` | Async research agents for comprehensive analysis | | **Datasources** | `GET /v1/datasources` | Discover available data sources and their schemas | ## Authentication All endpoints require an API key passed via the `X-API-Key` header. Get your key at [platform.valyu.ai](https://platform.valyu.ai). ``` X-API-Key: your_api_key_here ``` ## Pricing Valyu uses transparent, pay-per-use pricing: - **Search**: CPM-based (cost per mille tokens retrieved) - **Contents**: $0.001 per URL extracted, +$0.001 with AI features - **Answer**: $0.10 per request + variable search and AI costs - **DeepResearch**: Fixed per-task pricing by mode ($0.10 - $15.00) See [docs.valyu.ai](https://docs.valyu.ai) for full pricing details. ## SDKs - [Python SDK](https://pypi.org/project/valyu/) - `pip install valyu` - [TypeScript SDK](https://www.npmjs.com/package/valyu) - `npm install valyu` contact: name: Valyu Support url: https://valyu.ai email: support@valyu.ai x-logo: url: https://valyu.ai/logo.png altText: Valyu servers: - url: https://api.valyu.ai description: Production security: - ApiKeyAuth: [] tags: - name: Search description: >- Search across web, academic, financial, and proprietary data sources. Returns results ready for RAG pipelines, AI agents, and applications. externalDocs: description: Search API Guide url: https://docs.valyu.ai/search/quickstart - name: Contents description: >- Extract clean, structured content from web pages at scale. Supports batch processing, AI-powered summaries, structured extraction via JSON schemas, and async jobs for large URL sets. externalDocs: description: Contents API Guide url: https://docs.valyu.ai/guides/content-extraction - name: Answer description: >- Get AI-powered answers grounded in real-time search results. The Answer API searches across web, academic, and financial sources, then uses AI to generate a readable response via Server-Sent Events streaming. externalDocs: description: Answer API Guide url: https://docs.valyu.ai/guides/answer-api - name: DeepResearch description: >- Async research agents that perform comprehensive, multi-step research. DeepResearch searches multiple sources, analyzes content, and generates detailed reports with citations. Tasks run in the background and can take minutes to complete. externalDocs: description: DeepResearch Guide url: https://docs.valyu.ai/guides/deepresearch - name: Batches description: >- Run multiple DeepResearch tasks in parallel with shared configuration, unified monitoring, and aggregated cost tracking. externalDocs: description: Batch API Guide url: https://docs.valyu.ai/guides/deepresearch-batch-quickstart - name: Datasources description: >- Discover available data sources and their schemas. A tool manifest for AI agents - instead of hardcoding knowledge of available datasets, agents can query this API to discover sources, filter by category, and use `example_queries` for few-shot prompting. externalDocs: description: Datasources Guide url: https://docs.valyu.ai/guides/datasources externalDocs: description: Complete API Documentation url: https://docs.valyu.ai paths: /v1/datasources: get: tags: - Datasources summary: List available data sources description: >- Discover all data sources available through Valyu's search API. Each datasource includes metadata, example queries (optimized for few-shot prompting), pricing information, and response schemas. Use this endpoint to build dynamic tool manifests for AI agents instead of hardcoding knowledge of available datasets. operationId: listDatasources parameters: - name: category in: query schema: type: string description: >- Filter datasources by category. Use the categories endpoint to discover available categories. example: research responses: '200': description: List of available datasources. content: application/json: schema: $ref: '#/components/schemas/DatasourcesResponse' examples: example: summary: All datasources value: success: true datasources: - id: valyu/valyu-arxiv name: arXiv description: >- Preprints in physics, mathematics, computer science, quantitative biology, and more. category: research topics: - physics - mathematics - computer science modality: text example_queries: - CRISPR gene editing mechanisms - quantum error correction methods pricing: cpm: 0.5 update_frequency: daily size: 2.5M papers - id: valyu/valyu-pubmed name: PubMed description: >- Biomedical literature from MEDLINE, life science journals, and online books. category: healthcare topics: - medicine - biology - pharmacology modality: text example_queries: - GLP-1 receptor agonists for type 2 diabetes - CAR-T cell therapy advances pricing: cpm: 0.5 update_frequency: daily size: 36M citations '401': $ref: '#/components/responses/Unauthorized' '500': $ref: '#/components/responses/InternalServerError' components: schemas: DatasourcesResponse: type: object required: - success - datasources properties: success: type: boolean description: Whether the request succeeded. example: true datasources: type: array items: $ref: '#/components/schemas/Datasource' description: List of available datasources. total_count: type: integer description: Total number of datasources returned. example: 36 categories: type: object description: Summary of categories with counts. additionalProperties: type: object properties: name: type: string count: type: integer Datasource: type: object description: A data source available through Valyu's search API. required: - id - name - description - category properties: id: type: string description: Unique datasource identifier. example: valyu/valyu-arxiv name: type: string description: Display name of the datasource. example: arXiv description: type: string description: What data this source provides. example: Preprints in physics, mathematics, computer science, and more. category: type: string description: Category classification. enum: - research - healthcare - patents - markets - company - economic - predictions - transportation - legal - politics example: research type: type: string description: Content type (e.g. paper, data, report). example: paper topics: type: array description: Subject areas covered by this datasource. items: type: string example: - physics - mathematics - computer science languages: type: array description: Languages supported by this datasource. items: type: string example: - en - es - fr source: type: string description: Source provider or origin of the datasource. example: pubmed modality: type: array items: type: string description: Data modalities available (e.g. text, images, tabular). example: - text example_queries: type: array description: Example queries optimized for few-shot prompting. items: type: string example: - CRISPR gene editing mechanisms - quantum error correction methods pricing: type: object description: Cost information for this datasource. properties: cpm: type: number description: Cost per mille (thousand) tokens. example: 0.5 response_schema: type: object description: >- JSON Schema describing the response format for results from this source. additionalProperties: true update_frequency: type: string description: How often the data is updated (Realtime, Daily, Monthly). example: daily size: type: integer description: Approximate number of records or documents. example: 2500000 coverage: type: object description: Temporal coverage of the data. properties: start_date: type: string format: date-time description: Earliest data available. end_date: type: string format: date-time nullable: true description: Latest data available. `null` if continuously updated. geography: type: object description: Geographic coverage information, if available. additionalProperties: true capabilities: type: object description: Search capabilities supported by this datasource. additionalProperties: true data_source: type: object description: Data provider information. properties: provider: type: string license: type: string Error: type: object description: Standard error response. required: - success - error properties: success: type: boolean description: Always `false` for error responses. example: false error: type: string description: Human-readable error message describing what went wrong. example: Invalid request parameters responses: Unauthorized: description: Missing or invalid API key. content: application/json: schema: $ref: '#/components/schemas/Error' examples: example: summary: Invalid API key value: success: false error: Invalid API key InternalServerError: description: An unexpected error occurred on the server. content: application/json: schema: $ref: '#/components/schemas/Error' examples: example: summary: Internal error value: success: false error: Internal server error. Please try again later. securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key description: >- API key for authentication. Get yours at [platform.valyu.ai](https://platform.valyu.ai). ````