# arXiv Export — Wrapped API

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

> Search and retrieve academic paper information from arXiv, including titles, authors, abstracts, submission dates, and subject categories. Look up specific papers by ID or discover relevant research through flexible search queries.

**Category:** Education | **Website:** [export.arxiv.org/abs/2412.15115](https://export.arxiv.org/abs/2412.15115) | **Docs:** [parse.bot/marketplace/8d883f3e-96dd-4659-8be5-6c90789708d2/export-arxiv-org-api](https://parse.bot/marketplace/8d883f3e-96dd-4659-8be5-6c90789708d2/export-arxiv-org-api)

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

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-export-arxiv-org-api-8d883f3e/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_paper

Retrieve full metadata for a single arXiv paper by its ID. Returns submission date/year, title, authors with affiliations, abstract, categories, and links. One upstream request per call.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `paper_id` | string | Yes | arXiv paper identifier, with or without version suffix (e.g. '2412.15115' or '2412.15115v2'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-export-arxiv-org-api-8d883f3e/get_paper \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"paper_id":"<string>"}'
```

### search_papers

Search arXiv papers by query. Supports field-prefixed queries (ti: for title, au: for author, abs: for abstract, cat: for category, all: for all fields). Returns paginated results with total count. One upstream request per call.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `max_results` | integer | No | Number of results to return per page, between 1 and 100. |
| `query` | string | Yes | Search query string. Supports arXiv query syntax with field prefixes: 'ti:' (title), 'au:' (author), 'abs:' (abstract), 'cat:' (category), 'all:' (all fields). Boolean operators AND, OR, ANDNOT are supported. |
| `start` | integer | No | Zero-based offset for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-export-arxiv-org-api-8d883f3e/search_papers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"max_results":"<integer>","query":"<string>","start":"<integer>"}'
```