9LINK 주요문서
리포트 API 문서
광고주마다 원본 데이터와 연동 방식은 다르지만, 매체에는 아래의 공통 지표와 동일한 의미로 제공합니다. API Key의 조회 범위는 발급 시 지정된 광고주, 매체 또는 매체대행사로 제한됩니다.
인증
X-9LINK-API-KEY: {issued_api_key}API Key가 없거나 올바르지 않으면 401, 허용 범위를 벗어난 조건으로 조회하면 403 응답을 반환합니다.
curl --request GET \
"https://api.9link.co.kr/external/reports/conversions?from=2026-07-01&to=2026-07-20&limit=100" \
--header "X-9LINK-API-KEY: {issued_api_key}"브라우저 주소창에서는 인증 헤더를 보낼 수 없어 401이 정상입니다. 매체 서버, Postman 또는 curl에서 발급받은 API Key를 헤더로 전달해 주세요.
공통 집계 필드
| 필드 | 설명 | 예시 |
|---|---|---|
| from | 조회 시작 일시 | 2026-07-01T00:00:00.000Z |
| to | 조회 종료 일시 | 2026-07-20T23:59:59.999Z |
| totals.impressions | 광고 노출 수 | 1250 |
| totals.clicks | 광고 클릭 및 유입 수 | 320 |
| totals.conversions | 전환 수 | 18 |
| totals.transactionAmount | 발생 거래액 | 450000 |
| totals.canceledTransactionAmount | 취소 거래액 | 30000 |
취소 발생 시 원래 발생 거래액은 유지되며, 취소 거래액은 canceledTransactionAmount에 별도로 합산됩니다. 광고주 과금액과 플랫폼 마진은 외부 리포트 API에서 제공하지 않습니다. 매체 지급액은 총관리자가 해당 광고주·매체 조합의 매체지급액 송출을 선택한 경우에만 상세 행의 payout_amount로 제공합니다.
한 주문에 여러 상품이 있으면 상품별 행이 각각 반영됩니다. 일부 상품만 취소되면 해당 상품 행의 status는 canceled, 같은 주문의 orderStatus는 partially_canceled로 반환되며 나머지 상품은 approved 상태를 유지합니다. 동일한 주문·상품(content_no)이 다시 수신되면 새 행을 만들지 않고 가장 최근 수신 금액과 상태로 갱신하며, 원본 수신 이력은 모두 보존됩니다.
공통 조회 조건
| 파라미터 | 설명 | 예시 |
|---|---|---|
| from | 조회 시작일 | 2026-07-01 |
| to | 조회 종료일 | 2026-07-20 |
| advertiserCode | 광고주 코드 | kurly |
| partnerCode | 매체 코드 | ninez_cp1 |
| agencyCode | 매체대행사 코드 | ninez_agency |
| campaignCode | 캠페인 코드 | cmp_kurly_001 |
| status | 전환 상태 | approved, canceled |
| limit | 상세 조회 개수 | 100 |
| offset | 상세 조회 시작 위치 | 0 |
일별 합산 리포트
GET https://api.9link.co.kr/external/reports/summary?from=2026-07-01&to=2026-07-20&partnerCode=ninez_cp1전환 상세
GET https://api.9link.co.kr/external/reports/conversions?from=2026-07-01&to=2026-07-20&limit=100주요 응답값은 conversionId, advertiserConversionId, clickId, advertiserCode, campaignCode, partnerCode, status, orderStatus, transactionAmount, canceledTransactionAmount, mediaRef, sub1, convertedAt, clickAt입니다. 매체지급액 송출이 설정된 조합에는 payout_amount가 추가되며 승인 건은 양수, 취소 건은 음수입니다. 리워드 대상 매칭은 mediaRef를 기준으로 하며, clickId와 sub1~sub5로 매체 내부 값과 상호 대조할 수 있습니다.
클릭 및 노출 상세
GET https://api.9link.co.kr/external/reports/clicks?from=2026-07-01&to=2026-07-20GET https://api.9link.co.kr/external/reports/impressions?from=2026-07-01&to=2026-07-20응답 코드
| HTTP 상태 | 의미 | 확인 사항 |
|---|---|---|
| 200 | 정상 조회 | rows 또는 totals 확인 |
| 400 | 조회 조건 오류 | 날짜 형식, from/to, limit 확인 |
| 401 | 인증 실패 | X-9LINK-API-KEY 누락 또는 키 값 확인 |
| 403 | 조회 범위 초과 | 발급 키의 광고주·매체·대행사 범위 확인 |
| 404 | 경로 오류 | https://api.9link.co.kr/external/reports/... 경로 확인 |
| 500 | 서버 처리 오류 | 응답 시각과 요청 조건을 9LINK에 전달 |
API Key는 발급된 매체 또는 매체대행사 범위에 자동으로 제한됩니다. 다른 매체가 연동하더라도 같은 URL을 사용하며, 각 매체에는 별도의 API Key를 발급해야 합니다.