# Ccfddl — 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.

> Access computer science conference deadlines, rankings, and acceptance rates across all CCF and CORE categories. Search and filter conferences by name, rank, or research area to explore venues and submission timelines.

**Category:** Education | **Website:** [ccfddl.com/](https://ccfddl.com/) | **Docs:** [parse.bot/marketplace/7b553c68-3ac7-4883-93ae-14a1400f24f5/ccfddl-com-api](https://parse.bot/marketplace/7b553c68-3ac7-4883-93ae-14a1400f24f5/ccfddl-com-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-ccfddl-com-api-7b553c68/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_all_conferences

Retrieve all conferences with full details including timelines, ranks, and acceptance rates. Returns the complete database of conferences with pagination support via limit and offset. Each conference includes yearly editions, submission deadlines, CCF/CORE/THCPL rankings, and historical acceptance rate data. The total field reflects the full count regardless of pagination.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of conferences to return. |
| `offset` | integer | No | Number of conferences to skip before returning results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ccfddl-com-api-7b553c68/get_all_conferences \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","offset":"<integer>"}'
```

### get_conference_acceptance_rate

Retrieve historical acceptance rate statistics for a specific conference. Each record includes the year, number of submissions, number of accepted papers, computed rate, a human-readable summary string, and the data source URL. Returns an empty array for conferences without acceptance rate data. Returns input_not_found when no conference matches the given title.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `title` | string | Yes | Conference short name (e.g. 'AAAI', 'NeurIPS', 'ICSE'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ccfddl-com-api-7b553c68/get_conference_acceptance_rate \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"<string>"}'
```

### get_conference_details

Get detailed information for a specific conference by its short name. Returns the full conference record including all yearly editions with submission timelines, CCF/CORE/THCPL rankings, and historical acceptance rates. Title matching is case-insensitive. Returns input_not_found when no conference matches the given title.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `title` | string | Yes | Conference short name (e.g. 'NeurIPS', 'AAAI', 'ICSE', 'VLDB'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ccfddl-com-api-7b553c68/get_conference_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"<string>"}'
```

### get_conferences_by_category

Filter conferences by research category. Accepts the two-letter category code or the full category name (case-insensitive). Returns all conferences classified under the specified category.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | Yes | Category code or full name. Codes: AI, CG, CT, DB, SE, DS, HI, MX, NW, SC. Full names: Artificial Intelligence, Graphics, Computing Theory, Database, Software Engineering, Computer Architecture, Computer-Human Interaction, Interdiscipline, Network System, Network and System Security. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ccfddl-com-api-7b553c68/get_conferences_by_category \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>"}'
```

### get_conferences_by_multiple_filters

Filter conferences using multiple criteria simultaneously with AND logic. Supports filtering by search keyword, category, CCF rank, and CORE rank. Multiple values for category, ccf_rank, or core_rank are comma-separated and OR'd within each filter. At least one filter should be provided for meaningful results; omitting all filters returns the entire database.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Comma-separated category codes or full names (e.g. 'AI' or 'AI,DB'). |
| `ccf_rank` | string | No | Comma-separated CCF ranks (e.g. 'A' or 'A,B'). Accepted values per rank: A, B, C, Non-CCF. |
| `core_rank` | string | No | Comma-separated CORE ranks (e.g. 'A*' or 'A*,A'). |
| `query` | string | No | Search keyword to match against title and description. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ccfddl-com-api-7b553c68/get_conferences_by_multiple_filters \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","ccf_rank":"<string>","core_rank":"<string>","query":"<string>"}'
```

### get_conferences_by_rank

Filter conferences by CCF rank level. Returns all conferences holding the specified CCF ranking. Use 'Non-CCF' for conferences not ranked by CCF.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `rank` | string | Yes | CCF rank to filter by. Accepted values: A, B, C, Non-CCF. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ccfddl-com-api-7b553c68/get_conferences_by_rank \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"rank":"<string>"}'
```

### get_upcoming_deadlines

Retrieve conferences sorted by their next upcoming submission deadline. Only includes conferences with at least one future deadline. Each entry includes the soonest upcoming deadline as an ISO datetime and the specific yearly edition details. Useful for finding conferences still accepting submissions.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ccfddl-com-api-7b553c68/get_upcoming_deadlines \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_conferences

Search conferences by keyword matching against title and description fields. Returns all conferences where the query appears (case-insensitive) in either the short title or the full conference name. An empty result set is valid when no conferences match.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword to match against conference titles and descriptions. |

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