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

> 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-dlsite-com-api-a8585c29/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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.paywithlocus.com/api/wrapped/parse-dlsite-com-api-a8585c29/get_new_releases \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-dlsite-com-api-a8585c29/get_product_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-dlsite-com-api-a8585c29/get_ranking \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-dlsite-com-api-a8585c29/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keyword":"<string>","page":"<integer>","site_section":"<string>","work_type":"<string>"}'
```