9LINK 주요문서
리포트 API 문서
외부 시스템에서 9LINK 클릭, 전환, 정산 기준 리포트를 조회하기 위한 API 문서입니다. API Key는 9LINK 총관리자가 발급하며, 키마다 조회 가능한 광고주, 매체, 매체대행사 범위를 제한할 수 있습니다.
공통 인증
X-9LINK-API-KEY: {issued_api_key}API Key가 없거나 올바르지 않으면 401 응답을 반환합니다. 키 범위를 벗어난 광고주/매체 조건으로 조회하면 403 응답을 반환합니다.
API Key 범위
| 범위 | 설명 | 예시 |
|---|---|---|
| all | 전체 광고주/매체 리포트 조회 | 내부 관리자용 |
| advertiser | 특정 광고주 데이터만 조회 | kurly |
| partner | 특정 매체 데이터만 조회 | ninez_cp1 |
| agency | 특정 매체대행사의 하위 매체 데이터 조회 | ninez_agency |
공통 조회 파라미터
| 파라미터 | 설명 | 예시 |
|---|---|---|
| from | 조회 시작일 | 2026-07-01 |
| to | 조회 종료일 | 2026-07-08 |
| advertiserCode | 광고주 코드 | kurly |
| partnerCode | 매체 코드 | ninez_cp1 |
| agencyCode | 매체대행사 코드 | ninez_agency |
| campaignCode | 캠페인 코드 | cmp_kurly_001 |
| status | 전환 상태 | approved, pending, rejected, canceled |
| limit | 상세 목록 조회 개수 | 100 |
| offset | 상세 목록 시작 위치 | 0 |
합산 리포트
GET https://api.9link.co.kr/external/reports/summary?from=2026-07-01&to=2026-07-08&partnerCode=ninez_cp1전환 상세
GET https://api.9link.co.kr/external/reports/conversions?from=2026-07-01&to=2026-07-08&limit=100취소 전환은 status가 canceled로 제공됩니다. 발생 거래액은 보존하고, 광고주 과금액/매체 지급액/플랫폼 마진은 취소 반영 후 값으로 제공합니다.
클릭 상세
GET https://api.9link.co.kr/external/reports/clicks?from=2026-07-01&to=2026-07-08&campaignCode=cmp_kurly_001주의사항
- API Key는 원문 저장하지 않으며, 발급 순간에만 확인할 수 있습니다.
- 매체대행사 키는 하위 매체 전체를 합산 조회할 수 있습니다.
- 매체대행사 키로 특정 partnerCode를 조회할 때는 하위 매체만 허용됩니다.
- 정산 기준 금액은 advertiserChargeAmount, partnerPayoutAmount를 사용합니다.