# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/ccfddl/`
**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 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/credits/ccfddl/get-all-conferences \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/ccfddl/get-conference-acceptance-rate \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/ccfddl/get-conference-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/ccfddl/get-conferences-by-category \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/ccfddl/get-conferences-by-multiple-filters \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/ccfddl/get-conferences-by-rank \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/ccfddl/get-upcoming-deadlines \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/ccfddl/search-conferences \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

## Next steps

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