KpopViz Data
# K-pop Data API by KpopViz Comprehensive K-pop database for developers building apps, websites, and analytics tools. --- ## What's New in v1.7.0 **Instagram + Provider Contract Cleanup** Version 1.7.0 is a focused follow-up to `v1.6.0`. It keeps the same core API shape and marketplace settings, but corrects the social-profile contract before `v1.6.0` usage hardens. - New group-scoped Instagram…
KpopViz Data endpoints
| Method | Endpoint | Description |
|---|---|---|
| Groups — Spotify Catalog (PRO / ULTRA only) | ||
| GET |
/groups/{group_id}/spotify/top-tracks /groups/{group_id}/spotify/top-tracks |
List DB-backed Spotify top tracks for a group. Merged old group IDs return `409` with the canonical replacement. |
| GET |
/groups/{group_id}/spotify/tracks/{track_id} /groups/{group_id}/spotify/tracks/{track_id} |
Get a DB-backed Spotify track for a group with optional album context. Merged old group IDs return `409` with the canonical replacement. |
| GET |
/groups/{group_id}/spotify/albums/{album_id} /groups/{group_id}/spotify/albums/{album_id} |
Get a DB-backed Spotify album for a group with its DB-backed tracks. Merged old group IDs return `409` with the canonical replacement. |
| Other endpoints | ||
| GET |
get_company /companies/{company_id} |
Get a specific company by ID. |
| GET |
get_company_groups /companies/{company_id}/groups |
Get all groups managed by a specific company. |
| GET |
get_companies /companies |
Get all K-pop entertainment companies. |
| GET |
get_groups /groups |
Get all K-pop groups with optional filters. - **status**: Filter by group status (1=active, 0=hiatus, -1=disbanded) - **gender**: Filter by group gender (0=female groups, 1=male… |
| GET |
health_check /health |
Check API status and database connectivity. |
| GET |
get_member /members/{member_id} |
Get a specific member by ID. |
| GET |
get_group_members /groups/{group_id}/members |
Get all members of a specific group with their status (active, former, hiatus). |
| GET |
get_group /groups/{group_id} |
Get a specific K-pop group by ID. |
| GET |
get_members /members |
Get K-pop members with optional filters. - **group_id**: Filter members by their group - **status**: Filter by member status (1=active, 2=former, 3=hiatus) - **gender**: Filter… |
| GET |
search_groups /groups/search |
Search for K-pop groups by name. - **name**: Search term (prefix match, min 2 characters) - **limit**: Maximum number of results (default 10, max 50) |
| GET |
get_group /groups/{group_id} |
Get a specific K-pop group by ID. |
| GET |
get_group_members /groups/{group_id}/members |
Get all members of a specific group with their status (active, former, hiatus). |
| GET |
get_groups /groups |
Get all K-pop groups with optional filters. - **status**: Filter by group status (1=active, 0=hiatus, -1=disbanded) - **gender**: Filter by group gender (0=female groups, 1=male… |
| GET |
health_check /health |
Check API status and database connectivity. |
| GET |
search_members /members/search |
Search for K-pop members by name. - **name**: Search term (prefix match, min 2 characters) - **limit**: Maximum number of results (default 10, max 50) |
| GET |
get_company /companies/{company_id} |
Get a specific company by ID. |
| GET |
get_member /members/{member_id} |
Get a specific member by ID. |
| GET |
search_companies /companies/search |
Search for K-pop companies by name. - **name**: Search term (prefix match, min 2 characters) - **limit**: Maximum number of results (default 10, max 50) |
| GET |
get_company_groups /companies/{company_id}/groups |
Get all groups managed by a specific company. |
| GET |
get_companies /companies |
Get all K-pop entertainment companies. |
| GET |
get_members /members |
Get K-pop members with optional filters. - **group_id**: Filter members by their group - **status**: Filter by member status (1=active, 2=former, 3=hiatus) - **gender**: Filter… |
| GET |
get_member /members/{member_id} |
Get a specific member by ID. |
| GET |
health_check /health |
Check API status and database connectivity. |
| GET |
get_members /members |
Get K-pop members with optional filters. - **group_id**: Filter members by their group - **status**: Filter by member status (1=active, 2=former, 3=hiatus) - **gender**: Filter… |
| GET |
search_members /members/search |
Search for K-pop members by name. - **name**: Search term (prefix match, min 2 characters) - **limit**: Maximum number of results (default 10, max 50) |
| GET |
get_group_members /groups/{group_id}/members |
Get all members of a specific group with their status (active, former, hiatus). |
| GET |
get_groups /groups |
Get all K-pop groups with optional filters. - **status**: Filter by group status (1=active, 0=hiatus, -1=disbanded) - **gender**: Filter by group gender (0=female groups, 1=male… |
| GET |
search_groups /groups/search |
Search for K-pop groups by name. - **name**: Search term (prefix match, min 2 characters) - **limit**: Maximum number of results (default 10, max 50) |
| GET |
get_company /companies/{company_id} |
Get a specific company by ID. |
| GET |
get_company_groups /companies/{company_id}/groups |
Get all groups managed by a specific company. |
| GET |
get_group /groups/{group_id} |
Get a specific K-pop group by ID. |
| GET |
search_companies /companies/search |
Search for K-pop companies by name. - **name**: Search term (prefix match, min 2 characters) - **limit**: Maximum number of results (default 10, max 50) |
| GET |
get_companies /companies |
Get all K-pop entertainment companies. |
| GET |
get_members_members_get /members |
Get K-pop members with optional filters. - **group_id**: Filter members by their group - **status**: Filter by member status in group (1=active, 2=hiatus, 3=former) - only works… |
| GET |
get_company_companies__company_id__get /companies/{company_id} |
Get a specific company by ID. - **company_id**: The unique identifier of the company |
| GET |
get_companies_companies_get /companies |
Get all K-pop entertainment companies. - **limit**: Number of results (BASIC: max 10, PRO: max 100, ULTRA: max 500) - **offset**: Pagination offset |
| GET |
get_groups_groups_get /groups |
Get all K-pop groups with optional filters. - **status**: Filter by group status (1=active, 0=hiatus, -1=disbanded) - **gender**: Filter by group gender (0=female, 1=male) -… |
| GET |
get_group_groups__group_id__get /groups/{group_id} |
Get a specific K-pop group by ID. - **group_id**: The unique identifier of the group |
| GET |
search_groups_groups_search_get /groups/search |
Search for K-pop groups by name. - **name**: Search term (prefix match, min 2 characters) - **limit**: Max results (BASIC: max 5, PRO: max 25, ULTRA: max 50) |
| GET |
search_companies_companies_search_get /companies/search |
Search for K-pop companies by name. - **name**: Search term (prefix match, min 2 characters) - **limit**: Max results (BASIC: max 5, PRO: max 25, ULTRA: max 50) |
| GET |
search_members_members_search_get /members/search |
Search for K-pop members by name. - **name**: Search term (prefix match, min 2 characters) - **limit**: Max results (BASIC: max 5, PRO: max 25, ULTRA: max 50) |
| GET |
get_member_members__member_id__get /members/{member_id} |
Get a specific member by ID. - **member_id**: The unique identifier (UUID) of the member |
| GET |
health_check_health_get /health |
Health check endpoint. Returns the API status and database connectivity. |
| GET |
getMembers /members |
Get K-pop members with optional filters. - **group_id**: Filter members by their group - **status**: Filter by member status in group (1=active, 2=hiatus, 3=former) - only works… |
| GET |
searchMembers /members/search |
Search for K-pop members by name. - **name**: Search term (prefix match, min 2 characters) - **limit**: Max results (BASIC: max 5, PRO: max 25, ULTRA: max 50) |
| GET |
healthCheck /health |
Health check endpoint. Returns the API status and database connectivity. |
| GET |
getMember /members/{member_id} |
Get a specific member by ID. - **member_id**: The unique identifier (UUID) of the member |
KpopViz Data pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — |
|
| PRO Recommended | $9 / month | 30 / minute |
|
| ULTRA | $29 / month | 100 / minute |
|