> ## Documentation Index
> Fetch the complete documentation index at: https://lava.so/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Pearch

> Pearch is an AI-powered search API that returns ranked candidate results with per-result pricing, designed for retrieval and discovery use cases.

Pearch is an AI-powered search API that returns ranked candidate results with per-result pricing, designed for retrieval and discovery use cases. Best when you need semantic search with transparent cost-per-candidate pricing — Pearch differs from web search APIs by pricing per returned result rather than per query, making it economically predictable for high-precision retrieval workflows.

3 endpoints available through Lava's AI Gateway. See the [Pearch API docs](https://docs.pearch.ai) for full documentation.

<Warning>This provider requires your own credentials — connect your API key or OAuth account before use.</Warning>

## Endpoints

### Semantic search with ranked candidates (v2)

**GET** `https://api.pearch.ai/v2/search?q=machine+learning+frameworks` — \$0.266 / request

<Tabs>
  <Tab title="SDK">
    ```typescript theme={null}
    const data = await lava.gateway('https://api.pearch.ai/v2/search?q=machine+learning+frameworks', { method: 'GET' });
    ```
  </Tab>

  <Tab title="cURL">
    ```bash theme={null}
    curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.pearch.ai%2Fv2%2Fsearch%3Fq%3Dmachine%2Blearning%2Bframeworks" \
      -H "Authorization: Bearer $LAVA_SECRET_KEY"
    ```
  </Tab>
</Tabs>

### Semantic search with ranked candidates

**GET** `https://api.pearch.ai/search` — \$0.266 / request

<Tabs>
  <Tab title="SDK">
    ```typescript theme={null}
    const data = await lava.gateway('https://api.pearch.ai/search', { method: 'GET' });
    ```
  </Tab>

  <Tab title="cURL">
    ```bash theme={null}
    curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.pearch.ai%2Fsearch" \
      -H "Authorization: Bearer $LAVA_SECRET_KEY"
    ```
  </Tab>
</Tabs>

### Get profile information

**GET** `https://api.pearch.ai/v1/profile` — Free

<Tabs>
  <Tab title="SDK">
    ```typescript theme={null}
    const data = await lava.gateway('https://api.pearch.ai/v1/profile', { method: 'GET' });
    ```
  </Tab>

  <Tab title="cURL">
    ```bash theme={null}
    curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.pearch.ai%2Fv1%2Fprofile" \
      -H "Authorization: Bearer $LAVA_SECRET_KEY"
    ```
  </Tab>
</Tabs>

## Next Steps

<CardGroup cols={2}>
  <Card title="All Providers" icon="grid" href="/gateway/supported-providers">
    Browse all supported AI providers
  </Card>

  <Card title="Forward Proxy" icon="route" href="/gateway/forward-proxy">
    Learn how to construct proxy URLs and authenticate requests
  </Card>
</CardGroup>