# Iclr — 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 ICLR conference papers by keyword and browse accepted papers across different presentation formats (oral and poster), while accessing detailed paper metadata and conference information. Explore papers from multiple conference years and workshops to find research relevant to your interests.

**Category:** Education | **Website:** [iclr.cc/](https://iclr.cc/) | **Docs:** [parse.bot/marketplace/a51d112d-d716-4986-a0f4-71cfbf868fc2/iclr-cc-api](https://parse.bot/marketplace/a51d112d-d716-4986-a0f4-71cfbf868fc2/iclr-cc-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-iclr-cc-api-a51d112d/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_all_accepted_papers

Retrieves accepted papers for a given ICLR year from the OpenReview API. Supports client-side pagination via limit and offset over up to 1000 papers per year. Returns full OpenReview note objects including content (title, authors, abstract, venue, keywords).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of papers to return. |
| `offset` | integer | No | Pagination offset. |
| `year` | string | No | Conference year. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-iclr-cc-api-a51d112d/get_all_accepted_papers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","offset":"<integer>","year":"<string>"}'
```

### get_conference_info

Retrieves high-level information about a given ICLR conference year, including the full conference name and relevant OpenReview URLs. Returns a static computed object without network call.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `year` | string | No | Conference year. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-iclr-cc-api-a51d112d/get_conference_info \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":"<string>"}'
```

### get_conference_years

Returns the list of available ICLR conference years (2013-2025). No parameters required. Useful as a starting point to discover which years have data available.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-iclr-cc-api-a51d112d/get_conference_years \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_oral_papers

Retrieves only oral-accepted papers for a given ICLR year by filtering on the venue field. Fetches all accepted papers and returns those whose venue contains 'oral'. Typically returns 30-50 papers per year.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `year` | string | No | Conference year. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-iclr-cc-api-a51d112d/get_oral_papers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":"<string>"}'
```

### get_paper_by_id

Retrieves a single paper note object by its OpenReview ID. Returns the full paper submission including content (title, authors, abstract, venue, keywords). Use paper IDs obtained from search or list endpoints.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `paper_id` | string | Yes | OpenReview note ID for the paper. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-iclr-cc-api-a51d112d/get_paper_by_id \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"paper_id":"<string>"}'
```

### get_paper_detail

Retrieves all notes associated with a paper forum including the submission itself, reviews, meta-reviews, decisions, author responses, and discussion threads. Returns the full forum thread for a paper.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `paper_id` | string | Yes | OpenReview forum ID for the paper. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-iclr-cc-api-a51d112d/get_paper_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"paper_id":"<string>"}'
```

### get_paper_titles_with_word

Finds all paper titles containing a specific word across one or more ICLR conference years. Searches via OpenReview and filters titles locally for exact word match (case-insensitive). Returns lightweight title objects with year and paper ID.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `word` | string | Yes | Word to search for in paper titles. |
| `years` | string | No | Comma-separated list of conference years to search. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-iclr-cc-api-a51d112d/get_paper_titles_with_word \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"word":"<string>","years":"<string>"}'
```

### get_papers_by_keyword

Searches for ICLR papers by keyword in a specific year using the OpenReview search API. Returns matching papers with their full content. The search matches against all paper fields (title, abstract, keywords). Supports server-side pagination via limit and offset.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `keyword` | string | Yes | Search keyword to match against paper content. |
| `limit` | integer | No | Maximum number of results to return. |
| `offset` | integer | No | Pagination offset. |
| `year` | string | No | Conference year. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-iclr-cc-api-a51d112d/get_papers_by_keyword \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keyword":"<string>","limit":"<integer>","offset":"<integer>","year":"<string>"}'
```

### get_poster_papers

Retrieves only poster-accepted papers for a given ICLR year by filtering on the venue field. Fetches all accepted papers and returns those whose venue contains 'poster'. Typically returns 700-900 papers per year.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `year` | string | No | Conference year. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-iclr-cc-api-a51d112d/get_poster_papers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":"<string>"}'
```

### get_workshops

Returns the OpenReview workshop group URL for a given ICLR year. Provides a direct link to the workshop listings on OpenReview.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `year` | string | No | Conference year. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-iclr-cc-api-a51d112d/get_workshops \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":"<string>"}'
```
