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

> Browse and search DLsite's digital content library, view product details, rankings, and new releases, while managing your personal favorites and library if logged in. Access comprehensive information about games, software, and creative works all in one place.

**Category:** Marketplaces | **Website:** [dlsite.com/](https://dlsite.com/) | **Docs:** [parse.bot/marketplace/a8585c29-6cc2-4e51-ac1b-f3a7a82371f2/dlsite-com-api](https://parse.bot/marketplace/a8585c29-6cc2-4e51-ac1b-f3a7a82371f2/dlsite-com-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/dlsite/`
**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 new releases

Get newly released products from DLsite for a specified time period and site section. Returns product summaries with pricing, rating, tags, images, and release date. An optional work_type filter restricts results to a single work type (client-side filtering).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `locale` | string | No | Locale for localized data (e.g. en-us, ja-jp). |
| `period` | integer | No | Time period in days for new releases. |
| `site_section` | string | No | Site section: home, maniax, soft, pro, girls, books. |
| `work_type` | string | No | Filter by work type code as returned by DLsite (e.g. SOU for voice/ASMR, MNG for manga, RPG, MOV for video, ADV for adventure, DNV for digital novel, STG for shooter). Omitting returns all types. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/dlsite/get-new-releases \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"locale":"<string>","period":"<integer>","site_section":"<string>","work_type":"<string>"}'
```

### Get product details

Fetch full product details for a single DLsite product by its ID. Searches across all site sections to locate the product. Returns title, circle/maker info, pricing in JPY and USD, ratings, sale status, and metadata.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_id` | string | Yes | DLsite product ID in the format RJ/VJ/BJ followed by digits (e.g. RJ01551365, VJ01005806). |

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

### Get ranking

Get ranked product lists from DLsite for a specified time period. Enriches product IDs with metadata (title, price, rating). Returns the term and an array of ranked products.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `site_section` | string | No | Site section: home, maniax, soft, pro, girls, books. |
| `term` | string | No | Ranking time period: day, week, month, total. |

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

### Search products

Search for products by keyword within a site section. Returns paginated results enriched with pricing, rating, and metadata. Each page returns up to 30 items. An optional work_type filter restricts results to a single work type (server-side filtering via DLsite's URL path). For the books section, returns genuine BJ-prefix book products; other sections return RJ/VJ products.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `keyword` | string | Yes | Search keyword (e.g. ASMR, visual novel, RPG). Any text is accepted. |
| `page` | integer | No | Page number for pagination. |
| `site_section` | string | No | Site section to search within: home, maniax, soft, pro, girls, books. |
| `work_type` | string | No | Filter by work type code as returned by DLsite (e.g. SOU for voice/ASMR, MNG for manga, RPG, MOV for video, ADV for adventure, DNV for digital novel, STG for shooter). Omitting returns all types. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/dlsite/search-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"keyword":"<string>","page":"<integer>","site_section":"<string>","work_type":"<string>"}'
```

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