채널 API

채널 정보 조회, 검색, 랭킹 API입니다.

채널 조회

채널 ID 또는 webPath로 채널 정보를 가져옵니다.

Endpoint


GET /v1/channels/{identifier}

Request

Path Parameters

Name	Type	Default
`identifier`	`string` 채널 ID (숫자) 또는 webPath (문자열)

Query Parameters

Name	Type	Default
`expand`	`boolean` 통계 정보 포함 여부	`false`

Response

Name	Type	Default
`id`	`number` 채널 ID
`name`	`string` 채널명
`webPath`	`string` URL 경로 (예: “meloming-official”)
`platformUrl`	`string` 플랫폼 URL
`profileImageUrl`	`string` 프로필 이미지 URL
`topBannerUrl`	`string` 상단 배너 URL
`leftBannerUrl`	`string` 좌측 배너 URL
`rightBannerUrl`	`string` 우측 배너 URL
`themeColor`	`string` 테마 색상
`channelDescription`	`string` 채널 설명
`additionalLinks`	`{ type: string; url: string; }[]` 추가 링크 목록
`createdAt`	`string` 생성일 (ISO 8601)
`updatedAt`	`string` 수정일 (ISO 8601)
`favoritesCount`	`expand=true` 즐겨찾기 수
`songLikesCount`	`expand=true` 노래 좋아요 수
`songsCount`	`expand=true` 등록 노래 수
`popularityScore`	`expand=true` 인기 점수
`isOwnerProSubscriber`	`expand=true` Pro 구독 여부
`isOwnerAmbassador`	`expand=true` 앰배서더 여부

Examples

cURL

Terminal


# ID로 조회
curl https://openapi.meloming.com/v1/channels/1
 
# webPath로 조회
curl https://openapi.meloming.com/v1/channels/meloming-official
 
# 통계 포함
curl "https://openapi.meloming.com/v1/channels/1?expand=true"

JavaScript

index.js


// fetch 사용
const response = await fetch('https://openapi.meloming.com/v1/channels/1');
const channel = await response.json();
 
// 통계 포함
const response = await fetch('https://openapi.meloming.com/v1/channels/1?expand=true');
const channelWithStats = await response.json();

Python

main.py


import requests
 
# ID로 조회
response = requests.get('https://openapi.meloming.com/v1/channels/1')
channel = response.json()
 
# 통계 포함
response = requests.get('https://openapi.meloming.com/v1/channels/1',
                        params={'expand': 'true'})
channel_with_stats = response.json()

플랫폼 채널 ID로 채널 조회

외부 플랫폼(SOOP, CHZZK, CIME)의 채널 ID로 인증된 meloming 채널 정보를 조회합니다.

Endpoint


GET /v1/channels/platforms/{platform}/{channelId}

인증(APPROVED) 상태의 채널만 조회됩니다. OTHER 플랫폼은 지원하지 않습니다.

platform 값은 대소문자를 구분하지 않습니다. CIME, cime, Cime 모두 동일하게 동작합니다.

Request

Path Parameters

Name	Type	Default
`platform`	`"SOOP" \| "CHZZK" \| "CIME"` 스트리밍 플랫폼. 대소문자 무관 (예: ‘SOOP’, ‘soop’, ‘Soop’ 모두 허용). 타입은 canonical(대문자) 값만 표기하지만 런타임은 case-insensitive하다.
`channelId`	`string` 플랫폼 채널 ID

Response

Name	Type	Default
`id`	`number` meloming 채널 ID
`name`	`string` 채널명
`webPath`	`string` URL 경로 (예: “streamer123”)
`platformUrl`	`string` 플랫폼 URL (예: “https://www.sooplive.co.kr/station/streamer123 ”)
`profileImageUrl`	`string` 프로필 이미지 URL
`themeColor`	`string` 테마 색상
`platform`	`"SOOP" \| "CHZZK" \| "CIME"` 스트리밍 플랫폼
`platformChannelId`	`string` 플랫폼 채널 ID

Examples

cURL

Terminal


# SOOP 채널 조회
curl https://openapi.meloming.com/v1/channels/platforms/SOOP/streamer123
 
# CHZZK 채널 조회
curl https://openapi.meloming.com/v1/channels/platforms/CHZZK/abc123def456
 
# 소문자도 허용됨 (CIME 채널 조회)
curl https://openapi.meloming.com/v1/channels/platforms/cime/lumoungs2

JavaScript

index.js


const platform = 'SOOP';
const channelId = 'streamer123';
 
const response = await fetch(
  `https://openapi.meloming.com/v1/channels/platforms/${platform}/${channelId}`
);
const channel = await response.json();
console.log(channel.webPath); // meloming 채널 경로

Python

main.py


import requests
 
platform = 'SOOP'
channel_id = 'streamer123'
 
response = requests.get(
    f'https://openapi.meloming.com/v1/channels/platforms/{platform}/{channel_id}'
)
channel = response.json()
print(channel['webPath'])  # meloming 채널 경로

채널 검색

Endpoint


GET /v1/channels/search

Request

Query Parameters

Name	Type	Default
`q`	`string` 검색어 (채널명, webPath, 닉네임)
`page`	`number` 페이지 번호	`1`
`limit`	`number` 결과 수 (최대 100)	`20`

Response

Name	Type	Default
`items`	`ChannelWithCountsResponse[]` 채널 목록
`pagination`	`Pagination` 페이지네이션 정보

Examples

cURL

Terminal


curl "https://openapi.meloming.com/v1/channels/search?q=멜로밍&limit=10"

JavaScript

index.js


const params = new URLSearchParams({ q: '멜로밍', limit: '10' });
const response = await fetch(`https://openapi.meloming.com/v1/channels/search?${params}`);
const result = await response.json();
 
console.log(result.items);           // 채널 목록
console.log(result.pagination.total); // 전체 개수

Python

main.py


import requests
 
response = requests.get('https://openapi.meloming.com/v1/channels/search',
                        params={'q': '멜로밍', 'limit': 10})
result = response.json()
 
print(result['items'])              # 채널 목록
print(result['pagination']['total']) # 전체 개수

채널 랭킹

인기도 점수를 기반으로 채널 순위를 조회합니다.

Endpoint


GET /v1/channels/ranking

Request

Query Parameters

Name	Type	Default
`limit`	`number` 조회 개수 (최대 50)	`10`
`days`	`number` 최근 N일 기준	`30`
`favoritesWeight`	`number` 즐겨찾기 가중치	`1.0`
`songLikesWeight`	`number` 노래 좋아요 가중치	`1.0`
`songsWeight`	`number` 등록 노래 수 가중치	`0.5`

Response

Name	Type	Default
`id`	`number` 채널 ID
`name`	`string` 채널명
`webPath`	`string` URL 경로
`profileImageUrl`	`string` 프로필 이미지 URL
`favoritesCount`	`number` 즐겨찾기 수
`songLikesCount`	`number` 노래 좋아요 수
`songsCount`	`number` 등록 노래 수
`popularityScore`	`number` 계산된 인기도 점수

인기도 점수 계산식: (즐겨찾기 × favoritesWeight) + (노래 좋아요 × songLikesWeight) + (노래 수 × songsWeight)

Examples

cURL

Terminal


# 기본 랭킹 조회
curl "https://openapi.meloming.com/v1/channels/ranking?limit=10"
 
# 커스텀 가중치 적용
curl "https://openapi.meloming.com/v1/channels/ranking?limit=20&favoritesWeight=2.0&songLikesWeight=1.5"

JavaScript

index.js


const params = new URLSearchParams({
  limit: '10',
  days: '7',
  favoritesWeight: '2.0'
});
 
const response = await fetch(`https://openapi.meloming.com/v1/channels/ranking?${params}`);
const ranking = await response.json();
 
ranking.forEach((channel, index) => {
  console.log(`${index + 1}. ${channel.name} (점수: ${channel.popularityScore})`);
});

Python

main.py


import requests
 
response = requests.get('https://openapi.meloming.com/v1/channels/ranking',
                        params={'limit': 10, 'days': 7})
ranking = response.json()
 
for i, channel in enumerate(ranking, 1):
    print(f"{i}. {channel['name']} (점수: {channel['popularityScore']})")