[01] / B2B API// 매체 조회 · 가용성 · 예약 연동 REST v1

싱커드 매체 DB를 당신의 툴에 연결하세요

대행사·미디어매체 툴에서 매체 조회·가용성 확인·예약 플로우를 자동화할 수 있는 공개 REST API입니다.

API 키 발급 엔드포인트

Bearer 인증

Authorization: Bearer {apiKey} 헤더

플랜별 한도

Free 1k · Pro 10k · Enterprise 무제한 / 월

DB 동기화

운영 DB 기준 실시간 매체 데이터

인증

모든 v1 요청에 API 키를 Bearer 토큰으로 전달합니다. 키는 /my/api-keys 에서 발급하며, 평문은 최초 1회만 표시됩니다.

Authorization: Bearer tkad_sk_your_secret_key_here

FREE 월 1,000회
PRO 월 10,000회
ENTERPRISE 무제한

월 한도 초과 시 HTTP 429 · 잘못된 키는 401

엔드포인트

Base URL: https://tkad.co.kr

GET/api/v1/media

매체 목록

활성 매체 카탈로그를 필터·페이지네이션으로 조회합니다.

쿼리 파라미터

region (string) — 지역 (서울, 부산 등)
type (string) — digital | static | mobile
minPrice (number) — 최소 월 가격(원)
maxPrice (number) — 최대 월 가격(원)
available (boolean) — true 시 가용 매체만
page (number) — 페이지 (기본 1)
limit (number) — 페이지 크기 (최대 100, 기본 20)

응답 예시

{
  "data": [
    {
      "id": "clx…",
      "name": "강남역 LED 전광판",
      "type": "digital",
      "region": "서울",
      "price": 15000000,
      "impressions": 1200000,
      "lat": 37.4979,
      "lng": 127.0276,
      "thumbnailUrl": "https://res.cloudinary.com/…",
      "isAvailable": true
    }
  ],
  "pagination": { "total": 142, "page": 1, "limit": 20 }
}

cURL

curl -s "https://tkad.co.kr/api/v1/media?region=서울&limit=10" \
  -H "Authorization: Bearer tkad_sk_your_secret_key_here"

GET/api/v1/media/{id}

매체 상세

단일 매체의 상세 정보를 반환합니다.

응답 예시

{
  "data": {
    "id": "clx…",
    "name": "강남역 LED 전광판",
    "type": "digital",
    "region": "서울",
    "location": "서울 강남구 …",
    "price": 15000000,
    "impressions": 1200000,
    "lat": 37.4979,
    "lng": 127.0276,
    "thumbnailUrl": "https://…",
    "isAvailable": true,
    "dailyFootTraffic": 85000,
    "visibilityScore": 92
  }
}

cURL

curl -s "https://tkad.co.kr/api/v1/media/{mediaId}" \
  -H "Authorization: Bearer tkad_sk_your_secret_key_here"

GET/api/v1/media/{id}/availability

가용 캘린더

예약 불가(차단) 기간을 조회합니다. PII는 포함하지 않습니다.

쿼리 파라미터

from (YYYY-MM-DD) — 시작일 (기본: 오늘)
to (YYYY-MM-DD) — 종료일 (기본: +90일, 최대 +180일)

응답 예시

{
  "data": {
    "mediaId": "clx…",
    "from": "2026-05-20",
    "to": "2026-08-18",
    "blockedRanges": [
      {
        "start": "2026-06-01T00:00:00.000Z",
        "end": "2026-06-15T00:00:00.000Z",
        "status": "blocked"
      }
    ]
  }
}

cURL

curl -s "https://tkad.co.kr/api/v1/media/{mediaId}/availability?from=2026-06-01&to=2026-07-01" \
  -H "Authorization: Bearer tkad_sk_your_secret_key_here"

지금 API 키를 발급하세요

로그인 후 마이페이지에서 키를 생성하고 바로 연동을 시작할 수 있습니다.

API 키 발급

매체검색 플래너 견적문의