# arXiv Export — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/arxiv-export/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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.beta.paywithlocus.com/api/wrapped/credits/arxiv-export/get-paper \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/arxiv-export/search-papers \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"max_results":"<integer>","query":"<string>","start":"<integer>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.