> ## 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.

# API Reference

> Valyu API reference documentation. Copy the OpenAPI spec or import it into Postman and other API tools.

## 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.

<div style={{ display: "flex", gap: "0.75rem", flexWrap: "wrap", marginTop: "1rem", marginBottom: "1.5rem" }}>
  <button className="copy-openapi-btn">Copy OpenAPI Spec</button>

  <a href="https://docs.valyu.ai/api-reference/openapi.json" target="_blank" rel="noopener noreferrer" style={{ display: "inline-flex", alignItems: "center", gap: "0.5rem", padding: "0.5rem 1rem", fontSize: "0.875rem", fontWeight: 500, borderRadius: "0.5rem", border: "1px solid var(--border)", color: "var(--text-secondary)", textDecoration: "none" }}>
    View Raw JSON
  </a>
</div>

## Import into Postman

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

<Frame>
  <img src="https://mintcdn.com/valyu/k0mqs04KtAf53VtP/images/postman-openapi-import.gif?s=220924ddfad95fe982cf292fe22079aa" alt="Importing the Valyu OpenAPI spec into Postman" width="1140" height="720" data-path="images/postman-openapi-import.gif" />
</Frame>

<Steps>
  <Step title="Copy the spec URL">
    Copy this URL: `https://docs.valyu.ai/api-reference/openapi.json`
  </Step>

  <Step title="Open Postman and import">
    In Postman, click **Import** and paste the URL. Postman will generate a complete collection with all Valyu endpoints.
  </Step>

  <Step title="Add your API key">
    Set the `Authorization` header to `Bearer YOUR_API_KEY` in the collection variables.
  </Step>
</Steps>

<Note>
  This also works with other API tools like Insomnia, Bruno, and HTTPie. Any tool that supports OpenAPI 3.0 imports can use this spec.
</Note>

## Endpoints

<CardGroup cols={2}>
  <Card title="Search" icon="magnifying-glass" href="/api-reference/endpoint/search">
    Search the web, research papers, financial data, and proprietary datasets.
  </Card>

  <Card title="Contents" icon="file-lines" href="/api-reference/endpoint/contents">
    Extract clean, structured content from any URL.
  </Card>

  <Card title="Answer" icon="message" href="/api-reference/endpoint/answer">
    AI-powered answers grounded in real-time search results.
  </Card>

  <Card title="DeepResearch" icon="flask" href="/api-reference/endpoint/deepresearch-create">
    Comprehensive multi-step research with detailed reports.
  </Card>

  <Card title="Datasources" icon="database" href="/api-reference/endpoint/datasources-list">
    List and explore available data sources.
  </Card>
</CardGroup>
