# Kpop Profiles Idol Database API

> Search Kpop Profiles: K-pop group and idol profile pages with facts, positions and birthdays

- Vendor: `kpopprofilesidoldatabaseapi` · version 1.0 · category Music · tags kpop api, kpop idols api, kpop groups api, kprofiles api, korean music api, idol profiles api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/kpopprofilesidoldatabaseapi
- This document: https://apiclay.com/docs/kpopprofilesidoldatabaseapi.md
- OpenAPI 3.1: https://apiclay.com/api/kpopprofilesidoldatabaseapi/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `kpopprofilesidoldatabaseapi`
- Updated: 2026-11-18

## About

## Kpop Profiles Idol Database API

Kpop Profiles' WordPress API: search the site's group and idol profiles by name, read one profile with its full text (members, positions, birthdays, heights, MBTI and fun facts), and list the categories used to file groups, soloists and actors.

Data comes from **kprofiles.com** (https://kprofiles.com). Every route calls the source's own public API and returns it unchanged.

Typical flow: `/profiles?search=blackpink&amp;_fields=id,link,title`, then `/profile?id=`.

### Routes

#### GET `/profiles` - Search profiles
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| search | query | string | no | Group or idol name. |
| per_page | query | number | no | Up to 100. |
| page | query | number | no | Page. |
| categories | query | string | no | Category ids, comma-separated. |
| _fields | query | string | no | e.g. `id,link,title` for a short answer. |

Returns: array of posts: `id`, `date`, `link`, `title.rendered`, `excerpt.rendered`, `content.rendered`, `categories`, `tags`.

#### GET `/profile` - Profile
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| id | path | number | yes | Post `id` from `/profiles`. |

Returns: one post with the full profile in `content.rendered` (HTML).

#### GET `/categories` - Categories
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| search | query | string | no | Name filter. |
| per_page | query | number | no | Up to 100. |
| page | query | number | no | Page. |

Returns: array of `id`, `name`, `slug`, `count`, `parent`.

### Caveats

- Profiles are fan-written content owned by Kpop Profiles; check its terms before republishing text.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by kprofiles.com.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /profiles — Search profiles
- Gateway: `GET https://api.apiclay.com/v1/api/kpopprofilesidoldatabaseapi/profiles`
- Public query params: `search` (string), `per_page` (number), `page` (number), `categories` (string), `_fields` (string)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /profile — Profile
- Gateway: `GET https://api.apiclay.com/v1/api/kpopprofilesidoldatabaseapi/profile`
- Public query params: `id` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /categories — Categories
- Gateway: `GET https://api.apiclay.com/v1/api/kpopprofilesidoldatabaseapi/categories`
- Public query params: `search` (string), `per_page` (number), `page` (number)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/kpopprofilesidoldatabaseapi/profiles" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
