# Vldb — 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 VLDB conference schedules, workshop agendas, keynote speaker details, and PVLDB journal paper abstracts and metadata across multiple volumes. Search and browse research papers, plan your conference attendance, and discover key presentations all in one place.

**Category:** Education | **Website:** [vldb.org/](https://vldb.org/) | **Docs:** [parse.bot/marketplace/19e2d378-e1f2-4dec-b10c-990cb0c4bad4/vldb-org-api](https://parse.bot/marketplace/19e2d378-e1f2-4dec-b10c-990cb0c4bad4/vldb-org-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/vldb/`
**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 conference list

Returns a list of all known VLDB conferences with their names and URLs, as listed on the VLDB Endowment homepage sidebar. Each conference entry includes the year, host city, and a link to its dedicated page.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/vldb/get-conference-list \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get keynote speakers

Returns information about keynote speakers for a given year, including talk titles, speaker bios, abstracts, and time slots. Currently only year 2024 has keynote data available; other years may return an upstream error.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `year` | string | No | Conference year. Currently only '2024' is confirmed to return keynote data. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/vldb/get-keynote-speakers \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"year":"<string>"}'
```

### Get main conference schedule

Returns the main conference schedule for a given year, including research sessions, their chairs, time slots, and listed papers with authors. Currently only year 2024 has schedule data available; other years may return an empty schedule array.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `year` | string | No | Conference year. Currently only '2024' is confirmed to return schedule data. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/vldb/get-main-conference-schedule \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"year":"<string>"}'
```

### Get paper abstract

Returns the abstract and metadata for a specific paper in a PVLDB volume. The title must match exactly as listed in the volume. Returns title, authors, abstract text, PDF URL (if available), and BibTeX citation (if available).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `title` | string | Yes | Full exact title of the paper as listed in the PVLDB volume. |
| `vol` | string | No | PVLDB volume number (e.g. '15', '16', '17'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/vldb/get-paper-abstract \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"title":"<string>","vol":"<string>"}'
```

### Get pvldb volume

Returns metadata and paper listings for a specific PVLDB volume, grouped by issue number. Each paper includes title, authors, page range, and PDF URL. Confirmed working for volumes 15, 16, and 17.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `vol` | string | No | PVLDB volume number (e.g. '15', '16', '17'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/vldb/get-pvldb-volume \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"vol":"<string>"}'
```

### Get workshop schedule

Returns the workshop schedule for a given year. Each workshop entry includes the day, title, external URL, and organizers. Confirmed working for years 2022, 2023, and 2024.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `year` | string | No | Conference year (e.g. '2022', '2023', '2024'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/vldb/get-workshop-schedule \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"year":"<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.