ugwanggi Partner API

curl -H "Authorization: Bearer ug_live_xxxxx" \
  "https://partner-api.ugwanggi.com/v1/youtube/creators?sort=subscriber_growth&limit=10"

import requests

resp = requests.get(
    "https://partner-api.ugwanggi.com/v1/youtube/creators",
    headers={"Authorization": "Bearer ug_live_xxxxx"},
    params={"sort": "subscriber_growth", "limit": 10},
)
print(resp.json())

const params = new URLSearchParams({ sort: "subscriber_growth", limit: 10 });

const resp = await fetch(
  `https://partner-api.ugwanggi.com/v1/youtube/creators?${params}`,
  { headers: { Authorization: "Bearer ug_live_xxxxx" } },
);
const data = await resp.json();
console.log(data);

Authorization: Bearer ug_live_xxxxxxxxxxxxxxxxxxxxxxxx

headers = {"Authorization": "Bearer ug_live_xxxxxxxxxxxx"}

const headers = { Authorization: "Bearer ug_live_xxxxxxxxxxxx" };

curl -H "Authorization: Bearer ug_live_xxxxx" \
  "https://partner-api.ugwanggi.com/v1/youtube/creators?sort=subscriber_growth&order=desc&limit=10"

import requests

resp = requests.get(
    "https://partner-api.ugwanggi.com/v1/youtube/creators",
    headers={"Authorization": "Bearer ug_live_xxxxx"},
    params={
        "sort": "subscriber_growth",
        "order": "desc",
        "limit": 10,
        # "category": "뷰티",
        # "channel_keyword": "다이어트",   # 부분일치
        # "format": "먹방",                # 23종 중 하나
        # "max_subscribers": 100000,
    },
)
print(resp.json())

const params = new URLSearchParams({
  sort: "subscriber_growth",
  order: "desc",
  limit: 10,
});

const resp = await fetch(
  `https://partner-api.ugwanggi.com/v1/youtube/creators?${params}`,
  { headers: { Authorization: "Bearer ug_live_xxxxx" } },
);
const data = await resp.json();
console.log(data);

{
  "platform": "youtube",
  "total": 12345,
  "limit": 10,
  "offset": 0,
  "sort": "subscriber_growth",
  "order": "desc",
  "data": [
    {
      "channel_id": "UCxxxxxxxx",
      "title": "채널명",
      "thumbnail": "https://...",
      "email": "contact@example.com",
      "countryCode": "KR",
      "topic": ["뷰티 & 메이크업", "일상 & 라이프스타일"],
      "format": ["리뷰 & 언박싱", "브이로그"],
      "channel_keywords": ["뷰티", "메이크업", "코스메틱"],
      "subscribers": 523000,
      "totalViews": 87000000,
      "total_videos": 412,
      "average_views": 95000,
      "average_views_short": 210000,
      "average_views_subs": 0.18,
      "engagement_rate": 0.042,
      "short_ratio": 0.63,
      "subs_growth_3_months": 0.12,
      "subs_growth_3_months_amount": 56000,
      "has_ad": true,
      "average_views_ads": 88000,
      "last_ppl_diff": 5,
      "top_industries": [
        { "industry": "IT & 전자기기", "percentage": 25.0 },
        { "industry": "뷰티 & 메이크업", "percentage": 25.0 }
      ],
      "top_brands": [
        { "brand": "브랜드1", "brand_logo": "https://...", "sponsored_videos": 3 },
        { "brand": "브랜드2", "brand_logo": "https://...", "sponsored_videos": 1 }
      ],
      "demographics": {
        "top_demographic": "F25_34",
        "top_demographic_value": 32,
        "breakdown": {
          "F13_17": 2, "F18_24": 15, "F25_34": 32, "F35_44": 20,
          "F45_54": 8, "F55_64": 3, "F65": 1,
          "M13_17": 1, "M18_24": 9, "M25_34": 5, "M35_44": 3,
          "M45_54": 1, "M55_64": 0, "M65": 0
        }
      },
      "registerYouTubeDate": "2019-03-01",
      "last_update": "2026-06-30"
    }
  ]
}

curl -H "Authorization: Bearer ug_live_xxxxx" \
  "https://partner-api.ugwanggi.com/v1/youtube/creators/UCxxxxxxxx"

import requests

channel_id = "UCxxxxxxxx"
resp = requests.get(
    f"https://partner-api.ugwanggi.com/v1/youtube/creators/{channel_id}",
    headers={"Authorization": "Bearer ug_live_xxxxx"},
)
print(resp.json())

const channelId = "UCxxxxxxxx";

const resp = await fetch(
  `https://partner-api.ugwanggi.com/v1/youtube/creators/${channelId}`,
  { headers: { Authorization: "Bearer ug_live_xxxxx" } },
);
const data = await resp.json();
console.log(data);

{
  "platform": "youtube",
  "data": {
    "channel_id": "UCxxxxxxxx",
    "title": "채널명",
    "thumbnail": "https://...",
    "email": "contact@example.com",
    "countryCode": "KR",
    "topic": ["뷰티 & 메이크업", "일상 & 라이프스타일"],
    "format": ["리뷰 & 언박싱", "브이로그"],
    "channel_keywords": ["뷰티", "메이크업", "코스메틱"],
    "subscribers": 523000,
    "totalViews": 87000000,
    "total_videos": 412,
    "average_views": 95000,
    "average_views_short": 210000,
    "average_views_subs": 0.18,
    "engagement_rate": 0.042,
    "short_ratio": 0.63,
    "subs_growth_3_months": 0.12,
    "subs_growth_3_months_amount": 56000,
    "has_ad": true,
    "average_views_ads": 88000,
    "last_ppl_diff": 5,
    "top_industries": [
      { "industry": "IT & 전자기기", "percentage": 25.0 },
      { "industry": "뷰티 & 메이크업", "percentage": 25.0 }
    ],
    "top_brands": [
      { "brand": "말해보카", "brand_logo": "https://...", "sponsored_videos": 3 }
    ],
    "demographics": {
      "top_demographic": "F25_34",
      "top_demographic_value": 32,
      "breakdown": {
        "F13_17": 2, "F18_24": 15, "F25_34": 32, "F35_44": 20,
        "F45_54": 8, "F55_64": 3, "F65": 1,
        "M13_17": 1, "M18_24": 9, "M25_34": 5, "M35_44": 3,
        "M45_54": 1, "M55_64": 0, "M65": 0
      }
    },
    "registerYouTubeDate": "2019-03-01",
    "last_update": "2026-06-30"
  }
}

curl -X POST -H "Authorization: Bearer ug_live_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{"channel_ids": ["UCaaaaaaaa", "UCbbbbbbbb", "UCcccccccc"]}' \
  "https://partner-api.ugwanggi.com/v1/youtube/creators/batch"

import requests

resp = requests.post(
    "https://partner-api.ugwanggi.com/v1/youtube/creators/batch",
    headers={"Authorization": "Bearer ug_live_xxxxx"},
    json={"channel_ids": ["UCaaaaaaaa", "UCbbbbbbbb", "UCcccccccc"]},
)
print(resp.json())

const resp = await fetch(
  "https://partner-api.ugwanggi.com/v1/youtube/creators/batch",
  {
    method: "POST",
    headers: {
      Authorization: "Bearer ug_live_xxxxx",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      channel_ids: ["UCaaaaaaaa", "UCbbbbbbbb", "UCcccccccc"],
    }),
  },
);
const data = await resp.json();
console.log(data);

{
  "platform": "youtube",
  "requested": 3,
  "found": 2,
  "data": [
    { "channel_id": "UCaaaaaaaa", "title": "채널 A", "subscribers": 523000, ... },
    { "channel_id": "UCbbbbbbbb", "title": "채널 B", "subscribers": 128000, ... }
  ],
  "not_found": ["UCcccccccc"]
}

curl -H "Authorization: Bearer ug_live_xxxxx" \
  "https://partner-api.ugwanggi.com/v1/youtube/rising?period=7d&tier=Micro&sort=growth&limit=10"

import requests

resp = requests.get(
    "https://partner-api.ugwanggi.com/v1/youtube/rising",
    headers={"Authorization": "Bearer ug_live_xxxxx"},
    params={
        "period": "7d",
        "tier": "Micro",   # 생략하면 전 티어 대상
        "sort": "growth",  # "growth_pct"면 성장률 순
        "limit": 10,
    },
)
print(resp.json())

const params = new URLSearchParams({
  period: "7d",
  tier: "Micro",
  sort: "growth",
  limit: 10,
});

const resp = await fetch(
  `https://partner-api.ugwanggi.com/v1/youtube/rising?${params}`,
  { headers: { Authorization: "Bearer ug_live_xxxxx" } },
);
const data = await resp.json();
console.log(data);

{
  "platform": "youtube",
  "period": "7d",
  "tier": "Micro",
  "sort": "growth",
  "calculated_at": "2026-07-06",
  "count": 10,
  "data": [
    {
      "rank": 1,
      "channel_id": "UCxxxxxxxx",
      "title": "채널명",
      "tier": "Micro",
      "current_subs": 82000,
      "base_subs": 61000,
      "growth": 21000,
      "growth_pct": 34.43
    }
  ]
}

curl -H "Authorization: Bearer ug_live_xxxxx" \
  "https://partner-api.ugwanggi.com/v1/youtube/ad-top?period=7d&tier=Micro&sort=total_views&limit=10"

import requests

resp = requests.get(
    "https://partner-api.ugwanggi.com/v1/youtube/ad-top",
    headers={"Authorization": "Bearer ug_live_xxxxx"},
    params={
        "period": "7d",
        "tier": "Micro",        # 생략하면 전 티어 대상
        "sort": "total_views",  # "ad_post_count"면 광고 영상 수 순
        "limit": 10,
    },
)
print(resp.json())

const params = new URLSearchParams({
  period: "7d",
  tier: "Micro",
  sort: "total_views",
  limit: 10,
});

const resp = await fetch(
  `https://partner-api.ugwanggi.com/v1/youtube/ad-top?${params}`,
  { headers: { Authorization: "Bearer ug_live_xxxxx" } },
);
const data = await resp.json();
console.log(data);

{
  "platform": "youtube",
  "period": "7d",
  "tier": "Micro",
  "sort": "total_views",
  "calculated_at": "2026-07-06",
  "count": 10,
  "data": [
    {
      "rank": 1,
      "channel_id": "UCxxxxxxxxxxxxxxxxxxxxxx",
      "title": "크리에이터 채널명",
      "tier": "Micro",
      "subscribers": 52000,
      "ad_post_count": 8,
      "total_views": 1240000
    }
  ]
}

curl -H "Authorization: Bearer ug_live_xxxxx" \
  "https://partner-api.ugwanggi.com/v1/youtube/category-top?period=7d&category=게임&tier=Micro&sort=total_views&limit=10"

import requests

resp = requests.get(
    "https://partner-api.ugwanggi.com/v1/youtube/category-top",
    headers={"Authorization": "Bearer ug_live_xxxxx"},
    params={
        "period": "7d",
        "category": "게임",      # 생략하면 전 카테고리 대상
        "tier": "Micro",         # 생략하면 전 티어 대상
        "sort": "total_views",   # "video_count"면 숏폼 영상 편수 순
        "limit": 10,
    },
)
print(resp.json())

const params = new URLSearchParams({
  period: "7d",
  category: "게임",
  tier: "Micro",
  sort: "total_views",
  limit: 10,
});

const resp = await fetch(
  `https://partner-api.ugwanggi.com/v1/youtube/category-top?${params}`,
  { headers: { Authorization: "Bearer ug_live_xxxxx" } },
);
const data = await resp.json();
console.log(data);

{
  "platform": "youtube",
  "period": "7d",
  "category": "게임",
  "tier": "Micro",
  "sort": "total_views",
  "calculated_at": "2026-07-06",
  "count": 10,
  "data": [
    {
      "rank": 1,
      "channel_id": "UCxxxxxxxxxxxxxxxxxxxxxx",
      "title": "채널명",
      "category": "게임",
      "tier": "Micro",
      "subscribers": 52000,
      "video_count": 8,
      "total_views": 1240000
    }
  ]
}

curl -H "Authorization: Bearer ug_live_xxxxx" \
  "https://partner-api.ugwanggi.com/v1/youtube/ad-content/list?period=30d&category=%EB%B7%B0%ED%8B%B0%20%26%20%EB%A9%94%EC%9D%B4%ED%81%AC%EC%97%85&sort=views&limit=10"

import requests

resp = requests.get(
    "https://partner-api.ugwanggi.com/v1/youtube/ad-content/list",
    headers={"Authorization": "Bearer ug_live_xxxxx"},
    params={
        "period": "30d",
        "sort": "views",       # views / likes / comments / subscribers
        "category": "뷰티 & 메이크업",  # 생략하면 전 카테고리 대상
        "tier": "Micro",       # 생략하면 전 티어 대상
        "limit": 10,
    },
)
print(resp.json())

const params = new URLSearchParams({
  period: "30d",
  sort: "views",
  category: "뷰티 & 메이크업",
  tier: "Micro",
  limit: 10,
});

const resp = await fetch(
  `https://partner-api.ugwanggi.com/v1/youtube/ad-content/list?${params}`,
  { headers: { Authorization: "Bearer ug_live_xxxxx" } },
);
const data = await resp.json();
console.log(data);

{
  "platform": "youtube",
  "count": 10,
  "data": [
    {
      "video_id": "abcd1234",
      "video_url": "https://www.youtube.com/watch?v=abcd1234",
      "video_thumbnails_url": "https://i.ytimg.com/vi/abcd1234/hqdefault.jpg",
      "video_type": 0,
      "channel_id": "UCxxxxxxxx",
      "channel_title": "채널명",
      "title": "신제품 협찬 리뷰",
      "video_description": "이 영상은 유료 광고를 포함하고 있습니다 ...",
      "views": 421000,
      "likes": 12800,
      "comments": 640,
      "subscribers": 52000,
      "duration_seconds": 492,
      "ads_yn": 1,
      "brand1": "브랜드A",
      "brand2": null,
      "brand3": null,
      "publishDate": "2026-07-02T09:00:00",
      "last_update": "2026-07-15T04:00:00"
    }
  ]
}

curl -H "Authorization: Bearer ug_live_xxxxx" \
  "https://partner-api.ugwanggi.com/v1/youtube/ad-content/stats?period=30d&category=%EB%B7%B0%ED%8B%B0%20%26%20%EB%A9%94%EC%9D%B4%ED%81%AC%EC%97%85&tier=Micro"

import requests

resp = requests.get(
    "https://partner-api.ugwanggi.com/v1/youtube/ad-content/stats",
    headers={"Authorization": "Bearer ug_live_xxxxx"},
    params={
        "period": "30d",
        "category": "뷰티 & 메이크업",  # 생략하면 전 카테고리 합산
        "tier": "Micro",       # 생략하면 전 티어
    },
)
print(resp.json())

const params = new URLSearchParams({
  period: "30d",
  category: "뷰티 & 메이크업",
  tier: "Micro",
});

const resp = await fetch(
  `https://partner-api.ugwanggi.com/v1/youtube/ad-content/stats?${params}`,
  { headers: { Authorization: "Bearer ug_live_xxxxx" } },
);
const data = await resp.json();
console.log(data);

{
  "platform": "youtube",
  "period": "30d",
  "category": "뷰티 & 메이크업",
  "tier": "Micro",
  "video_count": 128,
  "total_views": 45200000,
  "total_likes": 1320000,
  "total_comments": 88000,
  "avg_views": 353125.0,
  "avg_likes": 10312.5,
  "avg_comments": 687.5,
  "median_views": 210000.0,
  "median_likes": 6400.0,
  "median_comments": 410.0
}

curl -H "Authorization: Bearer ug_live_xxxxx" \
  "https://partner-api.ugwanggi.com/v1/youtube/search/video_list?keyword=%EC%BA%A0%ED%95%91&limit=10"

import requests

resp = requests.get(
    "https://partner-api.ugwanggi.com/v1/youtube/search/video_list",
    headers={"Authorization": "Bearer ug_live_xxxxx"},
    params={
        "keyword": "캠핑",
        "limit": 10,       # 1~20, 기본 20
    },
)
print(resp.json())

const params = new URLSearchParams({
  keyword: "캠핑",
  limit: 10,
});

const resp = await fetch(
  `https://partner-api.ugwanggi.com/v1/youtube/search/video_list?${params}`,
  { headers: { Authorization: "Bearer ug_live_xxxxx" } },
);
const data = await resp.json();
console.log(data);

{
  "platform": "youtube",
  "keyword": "캠핑",
  "count": 10,
  "videos": [
    {
      "video_id": "abcd1234",
      "duration_seconds": 612,
      "publishDate": "2026-07-02T09:00:00",
      "title": "가을 캠핑 필수템 정리",
      "video_description": "이번 영상에서는 가을 캠핑에 꼭 필요한 ...",
      "ads_yn": 0,
      "video_thumbnails_url": "https://i.ytimg.com/vi/abcd1234/hqdefault.jpg",
      "views": 421000
    }
  ]
}

curl -X POST -H "Authorization: Bearer ug_live_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{"target_date": "2026-07-06"}' \
  "https://partner-api.ugwanggi.com/v1/youtube/trending/long_form_list"

import requests

resp = requests.post(
    "https://partner-api.ugwanggi.com/v1/youtube/trending/long_form_list",
    headers={"Authorization": "Bearer ug_live_xxxxx"},
    json={"target_date": "2026-07-06"},
)
print(resp.json())

const resp = await fetch(
  "https://partner-api.ugwanggi.com/v1/youtube/trending/long_form_list",
  {
    method: "POST",
    headers: {
      Authorization: "Bearer ug_live_xxxxx",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ target_date: "2026-07-06" }),
  },
);
const data = await resp.json();
console.log(data);

{
  "platform": "youtube",
  "target_date": "2026-07-06",
  "count": 20,
  "data": [
    {
      "rank": 1,
      "video_id": "abcdEFGH123",
      "title": "영상 제목",
      "channel_id": "UCxxxxxxxx",
      "views": 1284000,
      "likes": 52000,
      "comments": 3100,
      "channel_name": "채널명",
      "custom_channel_id": "@channel_handle",
      "channel_title": "채널명",
      "channel_thumbnail": "https://.../photo.jpg",
      "channel_total_videos": 842
    }
  ]
}

curl -X POST -H "Authorization: Bearer ug_live_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{"target_date": "2026-07-06"}' \
  "https://partner-api.ugwanggi.com/v1/youtube/trending/shorts_list"

import requests

resp = requests.post(
    "https://partner-api.ugwanggi.com/v1/youtube/trending/shorts_list",
    headers={"Authorization": "Bearer ug_live_xxxxx"},
    json={"target_date": "2026-07-06"},
)
print(resp.json())

const resp = await fetch(
  "https://partner-api.ugwanggi.com/v1/youtube/trending/shorts_list",
  {
    method: "POST",
    headers: {
      Authorization: "Bearer ug_live_xxxxx",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ target_date: "2026-07-06" }),
  },
);
const data = await resp.json();
console.log(data);

{
  "platform": "youtube",
  "target_date": "2026-07-06",
  "count": 20,
  "data": [
    {
      "rank": 1,
      "video_id": "abcdEFGH123",
      "title": "숏폼 영상 제목",
      "channel_id": "UCxxxxxxxx",
      "views": 3820000,
      "likes": 210000,
      "comments": 4500,
      "channel_name": "채널명",
      "custom_channel_id": "@channel_handle",
      "channel_title": "채널명",
      "channel_thumbnail": "https://.../photo.jpg",
      "channel_total_videos": 842
    }
  ]
}

curl -X POST -H "Authorization: Bearer ug_live_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{"target_date": "2026-07-06"}' \
  "https://partner-api.ugwanggi.com/v1/youtube/trending/report"

import requests

resp = requests.post(
    "https://partner-api.ugwanggi.com/v1/youtube/trending/report",
    headers={"Authorization": "Bearer ug_live_xxxxx"},
    json={"target_date": "2026-07-06"},
)
print(resp.json())

const resp = await fetch(
  "https://partner-api.ugwanggi.com/v1/youtube/trending/report",
  {
    method: "POST",
    headers: {
      Authorization: "Bearer ug_live_xxxxx",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ target_date: "2026-07-06" }),
  },
);
const data = await resp.json();
console.log(data);

{
  "platform": "youtube",
  "target_date": "2026-07-06",
  "report": {
    "summary": {
      "summary_title": "오늘의 트렌드 요약",
      "summary": "숏폼 챌린지와 요리 콘텐츠가 강세...",
      "reason": "조회수 상위권에 관련 영상이 집중..."
    },
    "category_and_format": {
      "summary_title": "카테고리·포맷 인사이트",
      "summary": "엔터/음악 카테고리의 롱폼 비중이 상승..."
    },
    "chance_and_risk_title": "지금이 기회, 다만 주의할 점",
    "actions": [
      {
        "action_title": "챌린지 포맷 실험",
        "action_description": "짧은 참여형 챌린지 영상을 시도해 보세요."
      }
    ],
    "chances": [
      {
        "chance_title": "요리 숏폼 수요 급증",
        "chance_description": "간단 레시피 숏폼의 반응이 좋습니다."
      }
    ],
    "risks": [
      {
        "risk_title": "특정 밈 과포화",
        "risk_description": "유행 밈은 소비 주기가 짧아 리스크가 있습니다."
      }
    ]
  }
}

curl -X POST -H "Authorization: Bearer ug_live_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{"target_date": "2026-07-06"}' \
  "https://partner-api.ugwanggi.com/v1/youtube/trending/keyword_list"

import requests

resp = requests.post(
    "https://partner-api.ugwanggi.com/v1/youtube/trending/keyword_list",
    headers={"Authorization": "Bearer ug_live_xxxxx"},
    json={"target_date": "2026-07-06"},
)
print(resp.json())

const resp = await fetch(
  "https://partner-api.ugwanggi.com/v1/youtube/trending/keyword_list",
  {
    method: "POST",
    headers: {
      Authorization: "Bearer ug_live_xxxxx",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ target_date: "2026-07-06" }),
  },
);
const data = await resp.json();
console.log(data);

{
  "platform": "youtube",
  "target_date": "2026-07-06",
  "count": 10,
  "data": [
    {
      "rank": 1,
      "keyword": "여름 휴가 브이로그",
      "keyword_description": "휴가 시즌을 맞아 여행·일상 브이로그 검색이 급증했습니다.",
      "total_views": 12500000,
      "video_count": 42,
      "related_videos": [
        {
          "video_id": "abc123",
          "title": "제주도 3박4일 여름 휴가 브이로그",
          "channel_id": "UCxxxxxxxx",
          "channel_title": "여행하는 민지",
          "views": 820000,
          "likes": 15400,
          "comments": 1200,
          "video_thumbnails_url": "https://i.ytimg.com/vi/abc123/hqdefault.jpg",
          "video_url": "https://www.youtube.com/watch?v=abc123",
          "publishDate": "2026-07-03T09:00:00"
        }
      ]
    }
  ]
}

curl -H "Authorization: Bearer ug_live_xxxxx" \
  "https://partner-api.ugwanggi.com/v1/youtube/trending/related-keywords?term=%EB%A8%B9%EB%B0%A9&top_n=10"

import requests

resp = requests.get(
    "https://partner-api.ugwanggi.com/v1/youtube/trending/related-keywords",
    headers={"Authorization": "Bearer ug_live_xxxxx"},
    params={
        "term": "먹방",
        "top_n": 10,      # 10~20, 기본 10
    },
)
print(resp.json())

const params = new URLSearchParams({
  term: "먹방",
  top_n: 10,
});

const resp = await fetch(
  `https://partner-api.ugwanggi.com/v1/youtube/trending/related-keywords?${params}`,
  { headers: { Authorization: "Bearer ug_live_xxxxx" } },
);
const data = await resp.json();
console.log(data);

{
  "platform": "youtube",
  "term": "먹방",
  "count": 10,
  "data": [
    {
      "keyword": "피자 먹방",
      "video_count": 42,
      "total_views": 18320000,
      "videos": [
        {
          "video_id": "abcd1234",
          "title": "먹방 역대급 한상차림",
          "views": 3210000,
          "video_url": "https://www.youtube.com/watch?v=abcd1234",
          "video_thumbnails_url": "https://i.ytimg.com/vi/abcd1234/hqdefault.jpg"
        },
        {
          "video_id": "efgh5678",
          "title": "먹방 20인분 도전",
          "views": 2870000,
          "video_url": "https://www.youtube.com/watch?v=efgh5678",
          "video_thumbnails_url": "https://i.ytimg.com/vi/efgh5678/hqdefault.jpg"
        }
      ]
    }
  ]
}

curl -H "Authorization: Bearer ug_live_xxxxx" \
  "https://partner-api.ugwanggi.com/v1/instagram/creators?category=뷰티&user_type=휴먼 인플루언서&sort=followers&limit=10"

import requests

resp = requests.get(
    "https://partner-api.ugwanggi.com/v1/instagram/creators",
    headers={"Authorization": "Bearer ug_live_xxxxx"},
    params={
        "category": "뷰티",
        "user_type": "휴먼 인플루언서",   # 브랜드 계정·커머스 셀러 제외
        "sort": "followers",
        "order": "desc",
        "limit": 10,
        # "keyword": "다이어트",         # 동의어 확장 검색
        # "mood": "감성적",
        # "min_followers": 10000,
        # "has_ad": True,
    },
)
print(resp.json())

const params = new URLSearchParams({
  category: "뷰티",
  user_type: "휴먼 인플루언서",
  sort: "followers",
  order: "desc",
  limit: 10,
});

const resp = await fetch(
  `https://partner-api.ugwanggi.com/v1/instagram/creators?${params}`,
  { headers: { Authorization: "Bearer ug_live_xxxxx" } },
);
const data = await resp.json();
console.log(data);

{
  "platform": "instagram",
  "total": 33359,
  "limit": 10,
  "offset": 0,
  "sort": "followers",
  "order": "desc",
  "data": [
    {
      "user_id": "example.beauty",
      "username": "이그잼플뷰티 | Example Beauty",
      "profile_picture_url": "https://...",
      "user_type": "휴먼 인플루언서",
      "content_function": ["리뷰", "꿀팁/하우투"],
      "topic": ["뷰티", "패션"],
      "mood": ["러블리/귀여운", "밝은"],
      "persona": "얼굴 중심",
      "keywords": ["뷰티", "메이크업", "스킨케어"],
      "target_countries": ["KR", "JP"],
      "followers": 146266,
      "following": 412,
      "follower_following_ratio": 355.01,
      "posts": 1627,
      "has_ad": true,
      "latest_post_publish_date": "2026-07-31T08:15:34",
      "demographics": { "primary_age": "25-34세", "primary_gender": "F", "primary_audience_ratio": 31.2 },
      "feed": { "...": "피드 성과 지표" },
      "reel": { "...": "릴스 성과 지표" },
      "ad": { "...": "광고 산업 정보" }
    }
  ]
}

curl -H "Authorization: Bearer ug_live_xxxxx" \
  "https://partner-api.ugwanggi.com/v1/instagram/creators/example.motors"

import requests

user_id = "example.motors"
resp = requests.get(
    f"https://partner-api.ugwanggi.com/v1/instagram/creators/{user_id}",
    headers={"Authorization": "Bearer ug_live_xxxxx"},
)
print(resp.json())

const userId = "example.motors";

const resp = await fetch(
  `https://partner-api.ugwanggi.com/v1/instagram/creators/${userId}`,
  { headers: { Authorization: "Bearer ug_live_xxxxx" } },
);
const data = await resp.json();
console.log(data);

{
  "platform": "instagram",
  "data": {
    "user_id": "example.motors",
    "username": "이그잼플모터스 | Example Motors",
    "profile_picture_url": "https://...",
    "user_type": "공식/브랜드 계정",
    "content_function": ["프로모션/광고", "큐레이션/에디토리얼"],
    "topic": ["자동차"],
    "mood": ["럭셔리", "미니멀", "시크"],
    "persona": "제품 중심",
    "keywords": ["ExampleMotors", "이그잼플모터스", "전기차", "SUV", "디자인"],
    "target_countries": ["KR"],
    "followers": 146266,
    "following": 28,
    "follower_following_ratio": 5223.79,
    "posts": 1627,
    "has_ad": true,
    "latest_post_publish_date": "2026-07-03T17:35:33",
    "demographics": {
      "primary_age": "35-44세",
      "primary_gender": "M",
      "primary_audience_ratio": 22.75
    },
    "feed": {
      "feed_share_pct": 65.88,
      "avg_likes_last_10_org_feed": 311.7,
      "avg_likes_last_10_ad_feed": 1399.0,
      "avg_comments_last_10_org_feed": 2.0,
      "avg_comments_last_10_ad_feed": 40.0,
      "engagement_pct_last_10_org_feed": 2.14,
      "engagement_pct_last_10_ad_feed": 0.98
    },
    "reel": {
      "reel_share_pct": 34.12,
      "avg_views_last_10_org_reel": 18328.2,
      "avg_views_last_10_ad_reel": null,
      "engagement_pct_last_10_org_reel": 2.06,
      "engagement_pct_last_10_ad_reel": null,
      "reels_followers_per_view": 12.53,
      "reels_engagement_ratio": 0.01
    },
    "ad": {
      "primary_ad_industry": "자동차",
      "primary_ad_industry_ratio": 100.0,
      "ad_industries": ["자동차"]
    }
  }
}

curl -X POST -H "Authorization: Bearer ug_live_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{"user_ids": ["example.beauty", "example.motors", "no.such.handle"]}' \
  "https://partner-api.ugwanggi.com/v1/instagram/creators/batch"

import requests

resp = requests.post(
    "https://partner-api.ugwanggi.com/v1/instagram/creators/batch",
    headers={"Authorization": "Bearer ug_live_xxxxx"},
    json={"user_ids": ["example.beauty", "example.motors", "no.such.handle"]},
)
print(resp.json())

const resp = await fetch(
  "https://partner-api.ugwanggi.com/v1/instagram/creators/batch",
  {
    method: "POST",
    headers: {
      Authorization: "Bearer ug_live_xxxxx",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      user_ids: ["example.beauty", "example.motors", "no.such.handle"],
    }),
  },
);
const data = await resp.json();
console.log(data);

{
  "platform": "instagram",
  "requested": 3,
  "found": 2,
  "data": [
    { "user_id": "example.beauty", "username": "이그잼플뷰티", "followers": 146266, ... },
    { "user_id": "example.motors", "username": "이그잼플모터스", "followers": 98120, ... }
  ],
  "not_found": ["no.such.handle"]
}

curl -H "Authorization: Bearer ug_live_xxxxx" \
  "https://partner-api.ugwanggi.com/v1/instagram/rising?period=7d&tier=Micro&sort=growth&limit=10"

import requests

resp = requests.get(
    "https://partner-api.ugwanggi.com/v1/instagram/rising",
    headers={"Authorization": "Bearer ug_live_xxxxx"},
    params={
        "period": "7d",
        "tier": "Micro",   # 생략하면 전 티어 대상
        "sort": "growth",  # "growth_pct"면 성장률 순
        "limit": 10,
    },
)
print(resp.json())

const params = new URLSearchParams({
  period: "7d",
  tier: "Micro",
  sort: "growth",
  limit: 10,
});

const resp = await fetch(
  `https://partner-api.ugwanggi.com/v1/instagram/rising?${params}`,
  { headers: { Authorization: "Bearer ug_live_xxxxx" } },
);
const data = await resp.json();
console.log(data);

{
  "platform": "instagram",
  "period": "7d",
  "tier": "Micro",
  "sort": "growth",
  "calculated_at": "2026-07-06",
  "count": 10,
  "data": [
    {
      "rank": 1,
      "user_id": "17841400000000000",
      "username": "creator_handle",
      "tier": "Micro",
      "current_followers": 82000,
      "base_followers": 61000,
      "growth": 21000,
      "growth_pct": 34.43
    }
  ]
}

curl -H "Authorization: Bearer ug_live_xxxxx" \
  "https://partner-api.ugwanggi.com/v1/instagram/ad-top?period=7d&tier=Micro&sort=total_views&limit=10"

import requests

resp = requests.get(
    "https://partner-api.ugwanggi.com/v1/instagram/ad-top",
    headers={"Authorization": "Bearer ug_live_xxxxx"},
    params={
        "period": "7d",
        "tier": "Micro",        # 생략하면 전 티어 대상
        "sort": "total_views",  # "ad_post_count"면 광고 게시물 수 순
        "limit": 10,
    },
)
print(resp.json())

const params = new URLSearchParams({
  period: "7d",
  tier: "Micro",
  sort: "total_views",
  limit: 10,
});

const resp = await fetch(
  `https://partner-api.ugwanggi.com/v1/instagram/ad-top?${params}`,
  { headers: { Authorization: "Bearer ug_live_xxxxx" } },
);
const data = await resp.json();
console.log(data);

{
  "platform": "instagram",
  "period": "7d",
  "tier": "Micro",
  "sort": "total_views",
  "calculated_at": "2026-07-06",
  "count": 10,
  "data": [
    {
      "rank": 1,
      "user_id": "17841400000000000",
      "username": "creator_handle",
      "tier": "Micro",
      "followers": 52000,
      "ad_post_count": 8,
      "total_views": 1240000
    }
  ]
}

curl -H "Authorization: Bearer ug_live_xxxxx" \
  "https://partner-api.ugwanggi.com/v1/instagram/category-top?period=7d&category=뷰티&tier=Micro&sort=total_views&limit=10"

import requests

resp = requests.get(
    "https://partner-api.ugwanggi.com/v1/instagram/category-top",
    headers={"Authorization": "Bearer ug_live_xxxxx"},
    params={
        "period": "7d",
        "category": "뷰티",     # 생략하면 전 카테고리 대상
        "tier": "Micro",        # 생략하면 전 티어 대상
        "sort": "total_views",  # "reel_count"면 릴스 게시물 수 순
        "limit": 10,
    },
)
print(resp.json())

const params = new URLSearchParams({
  period: "7d",
  category: "뷰티",
  tier: "Micro",
  sort: "total_views",
  limit: 10,
});

const resp = await fetch(
  `https://partner-api.ugwanggi.com/v1/instagram/category-top?${params}`,
  { headers: { Authorization: "Bearer ug_live_xxxxx" } },
);
const data = await resp.json();
console.log(data);

{
  "platform": "instagram",
  "period": "7d",
  "category": "뷰티",
  "tier": "Micro",
  "sort": "total_views",
  "calculated_at": "2026-07-06",
  "count": 10,
  "data": [
    {
      "rank": 1,
      "user_id": "17841400000000000",
      "username": "creator_handle",
      "category": "뷰티",
      "tier": "Micro",
      "followers": 52000,
      "reel_count": 8,
      "total_views": 1240000
    }
  ]
}

curl -H "Authorization: Bearer ug_live_xxxxx" \
  "https://partner-api.ugwanggi.com/v1/instagram/content/list?period=30d&sort=views&is_ad=true&limit=10"

import requests

resp = requests.get(
    "https://partner-api.ugwanggi.com/v1/instagram/content/list",
    headers={"Authorization": "Bearer ug_live_xxxxx"},
    params={
        "period": "30d",
        "sort": "views",       # views / likes / comments / dm_send_count
        "category": "맛집/푸드",  # 생략하면 전 토픽 대상
        "tier": "Micro",       # 생략하면 전 티어 대상
        "is_ad": "true",       # 생략하면 광고·비광고 전체
        "limit": 10,
    },
)
print(resp.json())

const params = new URLSearchParams({
  period: "30d",
  sort: "views",
  category: "맛집/푸드",
  tier: "Micro",
  is_ad: "true",
  limit: 10,
});

const resp = await fetch(
  `https://partner-api.ugwanggi.com/v1/instagram/content/list?${params}`,
  { headers: { Authorization: "Bearer ug_live_xxxxx" } },
);
const data = await resp.json();
console.log(data);

{
  "platform": "instagram",
  "count": 10,
  "data": [
    {
      "post_id": "3401234567890123456",
      "url": "https://www.instagram.com/p/Cxxxxxxxxxx/",
      "user_id": "1784xxxxxxx",
      "is_reel": true,
      "description": "협찬 받은 신상 립 발색 리뷰 🎁 ...",
      "views": 182000,
      "likes": 9400,
      "comments": 210,
      "dm_send_count": 87,
      "is_ad": true,
      "topic": "뷰티(메이크업/헤어)",
      "publish_date": "2026-07-04T12:30:00"
    }
  ]
}

curl -H "Authorization: Bearer ug_live_xxxxx" \
  "https://partner-api.ugwanggi.com/v1/instagram/dm-trends?topic=맛집/푸드&analysis_date=2026-07-08"

import requests

resp = requests.get(
    "https://partner-api.ugwanggi.com/v1/instagram/dm-trends",
    headers={"Authorization": "Bearer ug_live_xxxxx"},
    params={
        "topic": "맛집/푸드",
        "analysis_date": "2026-07-08",  # 생략하면 최신 스냅샷
    },
)
print(resp.json())

const params = new URLSearchParams({
  topic: "맛집/푸드",
  analysis_date: "2026-07-08",
});

const resp = await fetch(
  `https://partner-api.ugwanggi.com/v1/instagram/dm-trends?${params}`,
  { headers: { Authorization: "Bearer ug_live_xxxxx" } },
);
const data = await resp.json();
console.log(data);

{
  "platform": "instagram",
  "topic": "맛집/푸드",
  "requested_analysis_date": "2026-07-08",
  "selected_analysis_date": "2026-07-06",
  "count": 12,
  "data": [
    {
      "cluster_name": "마라탕후루",
      "cluster_name_reason": "마라탕과 탕후루를 오가는 매운맛-단맛 조합 콘텐츠가 반복 등장",
      "trend_status": "숨은 보석",
      "rank": 1,
      "rank_in_status": 1,
      "post_count": 1234,
      "sub_keywords": ["마라탕후루", "탕후루챌린지", "매운맛챌린지"]
    }
  ]
}

curl -H "Authorization: Bearer ug_live_xxxxx" \
  "https://partner-api.ugwanggi.com/v1/instagram/reels?keyword=제주맛집&limit=20"

import requests

resp = requests.get(
    "https://partner-api.ugwanggi.com/v1/instagram/reels",
    headers={"Authorization": "Bearer ug_live_xxxxx"},
    params={
        "keyword": "제주맛집",
        "limit": 20,  # 생략 시 20
    },
)
print(resp.json())

const params = new URLSearchParams({
  keyword: "제주맛집",
  limit: 20,
});

const resp = await fetch(
  `https://partner-api.ugwanggi.com/v1/instagram/reels?${params}`,
  { headers: { Authorization: "Bearer ug_live_xxxxx" } },
);
const data = await resp.json();
console.log(data);

{
  "platform": "instagram",
  "keyword": "제주맛집",
  "limit": 20,
  "count": 20,
  "total": 350,
  "data": [
    {
      "post_id": "Abc123XyZ",
      "url": "https://www.instagram.com/reels/Abc123XyZ/",
      "publish_date": "2026-07-05T10:00:00",
      "likes": 12000,
      "comments": 120,
      "views": 300000,
      "dm_send_count": 8000,
      "description": "제주에서 꼭 가야 할 맛집 ... #제주맛집 #제주여행",
      "creator": {
        "user_id": "example_creator",
        "username": "제주 맛집 소개",
        "profile_picture_url": "https://storage.googleapis.com/instagram-profile-picture/example_creator-profile-picture.jpg"
      }
    }
  ]
}

curl -H "Authorization: Bearer ug_live_xxxxx" \
  "https://partner-api.ugwanggi.com/v1/instagram/bgm-trends?is_original_audio=true&period=7d&limit=10&topic=패션/룩"

import requests

resp = requests.get(
    "https://partner-api.ugwanggi.com/v1/instagram/bgm-trends",
    headers={"Authorization": "Bearer ug_live_xxxxx"},
    params={
        "is_original_audio": "true",  # 필수: true=오리지널/챌린지, false=라이선스 음원
        "period": "7d",   # 생략 시 7d
        "limit": 10,       # 생략 시 30
        "topic": "패션/룩",  # 생략 시 전체
    },
)
print(resp.json())

const params = new URLSearchParams({
  is_original_audio: "true",
  period: "7d",
  limit: 10,
  topic: "패션/룩",
});

const resp = await fetch(
  `https://partner-api.ugwanggi.com/v1/instagram/bgm-trends?${params}`,
  { headers: { Authorization: "Bearer ug_live_xxxxx" } },
);
const data = await resp.json();
console.log(data);

{
  "platform": "instagram",
  "period": "7d",
  "is_original_audio": true,
  "topic": "패션/룩",
  "count": 10,
  "data": [
    {
      "rank": 1,
      "music_title": "오리지널 오디오",
      "music_artist": "example_creator",
      "challenge_name": null,
      "is_original_audio": true,
      "status": "떡상 중",
      "reels_count": 538,
      "related_reels": [
        {
          "post_id": "Abc123XyZ",
          "url": "https://www.instagram.com/reels/Abc123XyZ/",
          "publish_date": "2026-07-10T21:19:01",
          "likes": 35163,
          "comments": 637,
          "views": 3722343,
          "dm_send_count": 39000,
          "description": "요즘 유행하는 그 챌린지 ... #릴스추천",
          "creator": {
            "user_id": "example_creator",
            "username": "민주",
            "profile_picture_url": "https://storage.googleapis.com/instagram-profile-picture/example_creator-profile-picture.jpg"
          }
        }
      ]
    }
  ]
}

curl -H "Authorization: Bearer ug_live_xxxxx" \
  "https://partner-api.ugwanggi.com/v1/instagram/related-keywords?term=%EC%97%AC%EB%A6%84&top_n=10"

import requests

resp = requests.get(
    "https://partner-api.ugwanggi.com/v1/instagram/related-keywords",
    headers={"Authorization": "Bearer ug_live_xxxxx"},
    params={
        "term": "여름",
        "top_n": 10,      # 10~20, 기본 10
    },
)
print(resp.json())

const params = new URLSearchParams({
  term: "여름",
  top_n: 10,
});

const resp = await fetch(
  `https://partner-api.ugwanggi.com/v1/instagram/related-keywords?${params}`,
  { headers: { Authorization: "Bearer ug_live_xxxxx" } },
);
const data = await resp.json();
console.log(data);

{
  "platform": "instagram",
  "term": "여름",
  "count": 10,
  "data": [
    {
      "keyword": "여름 코디",
      "post_count": 128,
      "total_likes": 452000,
      "posts": [
        {
          "post_id": "Abc123XyZ",
          "url": "https://www.instagram.com/p/Abc123XyZ/",
          "user_id": "example_creator",
          "likes": 32000,
          "views": 210000,
          "description": "여름 코디 추천 3가지 #여름코디 #데일리룩"
        },
        {
          "post_id": "Def456UvW",
          "url": "https://www.instagram.com/p/Def456UvW/",
          "user_id": "another_creator",
          "likes": 28000,
          "views": null,
          "description": "장마철에도 시원한 여름 코디 모음 #여름"
        }
      ]
    }
  ]
}