# Exa — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.paywithlocus.com/llms.txt)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API |
> |---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> AI-native search engine — semantic search, content retrieval, and research.

**Category:** Search | **Website:** [exa.ai](https://exa.ai) | **Docs:** [docs.exa.ai](https://docs.exa.ai)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/exa/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### Search

Search the web using natural language queries with neural or keyword matching.

**Estimated cost:** $0.010

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Natural language search query |
| `numResults` | number | No | Number of results to return |
| `type` | string | No | Search type: 'neural' or 'keyword' |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/exa/search \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>","numResults":"<number>","type":"<string>"}'
```

### Contents

Retrieve the full content of web pages by URL or document ID.

**Estimated cost:** $0.004/page

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `urls` | string[] | No | URLs to fetch content from |
| `ids` | string[] | No | Document IDs to fetch content from |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/exa/contents \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":"<string[]>","ids":"<string[]>"}'
```

### Find Similar

Find web pages similar to a given URL.

**Estimated cost:** $0.010

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | URL to find similar pages for |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/exa/find-similar \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### Answer

Get an AI-generated answer to a question with cited sources.

**Estimated cost:** $0.008

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Question to answer |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/exa/answer \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

### Research Status

Check the status of an async research job.

**Estimated cost:** Free

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `researchId` | string | Yes | Research job ID |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/exa/research-status \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"researchId":"<string>"}'
```

### Research List

List all research jobs.

**Estimated cost:** Free

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | number | No | Max results to return |
| `cursor` | string | No | Pagination cursor |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/exa/research-list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<number>","cursor":"<string>"}'
```