Skip to main content

OpenAPI Specification

The full Valyu API is described by an OpenAPI 3.0 specification. You can use it to generate client libraries, import into API tools, or explore the API programmatically.
View Raw JSON

Import into Postman

You can import the Valyu OpenAPI spec directly into Postman to test all endpoints interactively.
Importing the Valyu OpenAPI spec into Postman
1

Copy the spec URL

Copy this URL: https://docs.valyu.ai/api-reference/openapi.json
2

Open Postman and import

In Postman, click Import and paste the URL. Postman will generate a complete collection with all Valyu endpoints.
3

Add your API key

Set the x-api-key header to your API key in the collection variables. Valyu authenticates with the x-api-key header on every request - not a Bearer token.
Every request authenticates with the x-api-key header. This also works with other API tools like Insomnia, Bruno, and HTTPie - any tool that supports OpenAPI 3.0 imports can use this spec.

Built for agents

This reference is machine-readable. Point your coding agent at it directly:

/llms.txt

A curated index of every page for LLM consumption. llms-full.txt has the full text.

Docs MCP server

Connect an MCP client to docs.valyu.ai/mcp to let your agent search the docs live.

Per-page Markdown

Append .md to any page URL for raw Markdown, including the full spec on endpoint pages.

Endpoints

Search

Search the web, research papers, financial data, and proprietary datasets.

Contents

Extract clean, structured content from any URL.

Answer

AI-powered answers grounded in real-time search results.

DeepResearch

Comprehensive multi-step research with detailed reports.

Workflows

Templated, versioned DeepResearch for repeatable analyses. Beta

Datasources

List and explore available data sources.