OGQ DEVELOPERS

Build on OGQ.
Stickers, music, IP — all via one API.

OGQ Partner API로 전 세계 크리에이터의 글로벌 IP를 당신의 앱, 툴, 웹사이트에 통합하세요. 무료 티어, 5분 퀵스타트, 완전한 OpenAPI 3.1 스펙.

Quickstart OpenAPI Spec

Quickstart (5분)

첫 API 호출까지 5분.

1
API 키 발급
OGQ 어드민에서 무료 티어 키를 발급하거나, 엔터프라이즈 상담을 요청하세요.
→ 키 발급 페이지

IP 검색 API 호출

curl -H "Authorization: Bearer ogq_live_xxxxx" \
  "https://ogq.itshin.com/api/v1/ip/search?q=cat&type=sticker&limit=10"

결과 파싱

{
  "items": [
    {
      "id": "abc123",
      "title": "고양이 귀여워",
      "type": "sticker",
      "price": 3000,
      "currency": "KRW",
      "creatorName": "냥냥이",
      "thumbnailUrl": "https://...",
      "purchaseCount": 1523
    }
  ],
  "nextCursor": "abc123",
  "count": 10
}

임베드 생성

curl -X POST \
  -H "Authorization: Bearer ogq_live_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{"width":400,"height":300,"theme":"light"}' \
  "https://ogq.itshin.com/api/v1/ip/abc123/embed"

API Reference

OpenAPI 3.1 표준. 모든 엔드포인트가 자동 문서화됩니다.

GET/v1/ip/search

IP 카탈로그 검색 (키워드, 타입, 페이지네이션)

GET/v1/ip/:id

IP 상세 (DCAT-AP JSON-LD)

POST/v1/ip/:id/purchase

구매 (Idempotency-Key 필수)

GET/v1/ip/:id/download

Signed download URL (15분 만료)

POST/v1/ip/:id/embed

임베드 URL + iframe 스니펫 생성

POST/v1/webhook/register

웹훅 구독 (HMAC 서명)

GET/v1/health

헬스 체크 (auth 불필요)

GET/v1/openapi.json

OpenAPI 3.1 스펙 다운로드

OpenAPI JSON 다운로드

SDK & Code Samples

TypeScript / Node.js

import { OGQClient } from '@ogq/sdk'

const ogq = new OGQClient({
  apiKey: process.env.OGQ_API_KEY,
})

const { items } = await ogq.ip.search({
  q: 'cat',
  type: 'sticker',
  limit: 10,
})

for (const ip of items) {
  console.log(`${ip.title} — ${ip.price}원`)
}

Python

import ogq

client = ogq.Client(api_key="ogq_live_xxxxx")

results = client.ip.search(
    q="cat",
    type="sticker",
    limit=10,
)

for ip in results.items:
    print(f"{ip.title} — {ip.price}원")

Widget & Embed

한 줄 스크립트로 OGQ 콘텐츠를 당신의 사이트에 삽입.

iframe 임베드

<iframe
  src="https://ogq.itshin.com/embed/abc123?w=400&h=300&t=light"
  width="400"
  height="300"
  frameborder="0"
  allow="clipboard-write"
  loading="lazy">
</iframe>

무료/Standard 위젯에는 "Powered by OGQ" 배지가 표시됩니다. Enterprise 키는 배지 제거 가능.

Use Cases

채팅 앱

스티커 피커 통합 — 사용자가 OGQ 스티커를 메시지에 바로 삽입.

디자인 툴

Canva/Figma 플러그인으로 에셋 검색 + 드래그 삽입.

블로그 플랫폼

게시물에 라이선스된 이미지/음악 임베드.

AI 학습

라이선스된 IP를 학습 데이터로 사용 (Compute-to-Data 지원).

Pricing

Free 티어부터 시작. 결제 없이 1,000 req/day.

Free

₩0

10/min · 1K/day

✓검색 API
✓IP 상세
✓커뮤니티 지원

Basic

₩49,000/mo

60/min · 10K/day

✓Free 전체
✓다운로드 API
✓이메일 지원

Pro

₩199,000/mo

300/min · 100K/day

✓Basic 전체
✓구매 API
✓웹훅
✓우선 지원

Enterprise

별도 협의

1K/min · 1M/day

✓Pro 전체
✓SLA
✓배지 제거
✓전담 매니저

Community & Support

dev@ogq.me llms.txt OpenAPI 3.1

Build on OGQ.Stickers, music, IP — all via one API.