협찬 데이터를 위한 인플루언서 API.

API는 이런 용도입니다

Pozto 데이터를 다른 곳, 예를 들어 Airtable 베이스, 데이터 웨어하우스, 대시보드, 사내 툴로 옮기고 싶은 운영 담당자나 개발자를 위한 기능입니다. 반대 방향도 됩니다. 협찬 제품을 발송하는 시스템에서 크리에이터를 바로 추가해 두 번 입력할 필요가 없습니다.

API는 내 크리에이터 목록, 즉 제품을 보낸 크리에이터를 대상으로 동작합니다. 인플루언서를 검색하는 데이터베이스가 아닙니다. 인플루언서 API에서 그런 기능을 찾고 있다면 Pozto는 맞지 않습니다.

키, 기본 URL, 제한

• 기본 URL: https://pozto.co/api/v1
• 키: Brand 요금제에서 팀 소유자가 설정 → API에서 만듭니다. 키는 pz_로 시작하고 한 번만 표시됩니다. Pozto는 지문만 보관하므로 그때 복사해 두세요. 키마다 용도에 맞는 이름을 붙이고 언제든 폐기할 수 있습니다. 설정에서 각 키를 마지막으로 사용한 시점을 볼 수 있습니다.
• 전송 방법: 모든 요청에 Authorization: Bearer pz_… 헤더를 넣습니다.
• 범위: 키 하나로 팀의 모든 브랜드를 읽고 추가할 수 있습니다.
• 요청 제한: 키당 분당 120회.
• 페이지: GET /creators와 GET /posts는 100개씩 돌려주며, &limit=를 쓰면 최대 500개까지 돌려줍니다. 더 있으면 응답에 next_cursor가 들어 있으니, 다음 페이지를 받으려면 이를 &cursor=로 다시 보내세요. 마지막 페이지에서는 null입니다.
• 형식: 요청과 응답 모두 JSON. id는 문자열이고 날짜는 ISO 8601입니다.

엔드포인트

크리에이터와 게시물에 담기는 정보

크리에이터에는 이름, 이메일, 계정(각 핸들을 찾았는지 여부 포함), 할인 코드, 상태, 그리고 협찬별 정보가 담깁니다. 제품과 함께 보낸 구성품, 캠페인, 발송일과 배송 완료일, 일 단위 마감 기한, 송장 번호, 비용, 요청한 게시물 수와 지금까지 게시한 수입니다.

게시물은 영상 하나이며, 올라간 모든 플랫폼별로 링크, 캡션, 게시일, 브랜드 태그 여부가 담깁니다. 이어서 어느 협찬과 제품에 해당하는지, Pozto가 그렇게 판단한 근거가 나옵니다. 그다음 영상 확인 결과: 제품을 찾았는지, 화면에 나온 각 시점(초 단위), 제품명을 말한 각 시점과 그 발언, 짧은 요약입니다. 마지막으로 협찬 표기: 명확함, 불분명, 없음 중 하나와 그 이유입니다.

크리에이터와 게시물 추가하기

POST /creators는 brand_id와 handles를 받습니다. @이름, 프로필 링크, Linktree 같은 링크를 최대 6개까지 넣을 수 있습니다. 그 밖에 platform, name, email, codes, product(id 또는 이름. 새 이름이면 제품이 추가됩니다), shipped_at, delivered_at, due_days(생략하면 21), tracking도 받습니다. 계정이나 이메일 중 하나라도 일치하는 크리에이터가 이미 목록에 있으면 중복으로 만들지 않고 그 크리에이터에게 협찬을 추가합니다. 새 크리에이터면 201, 기존 크리에이터면 200으로 응답하며 크리에이터 id와 협찬 id를 돌려줍니다.

POST /posts는 brand_id와 url을 받고, 선택적으로 creator_id와 product_id를 받습니다. 게시물은 해당 계정의 주인에게 연결되고, 새 크리에이터라면 목록에 추가되며, 영상 확인 대기열에 들어갑니다. 응답에는 새 게시물인지, 핸들, 플랫폼, 브랜드에 관한 게시물로 인정되는지가 담깁니다.

# 한 브랜드에서 기한을 넘긴 크리에이터
curl "https://pozto.co/api/v1/creators?brand_id=BRAND_ID&status=late" \
  -H "Authorization: Bearer pz_…"

# 크리에이터와 보낸 협찬 제품 추가
curl -X POST https://pozto.co/api/v1/creators \
  -H "Authorization: Bearer pz_…" \
  -H "Content-Type: application/json" \
  -d '{"brand_id":"BRAND_ID","handles":["@maya.glows"],"product":"Glow Serum","shipped_at":"2026-10-14"}'

# 10월 1일 이후 게시물, 최신순
curl "https://pozto.co/api/v1/posts?brand_id=BRAND_ID&since=2026-10-01" \
  -H "Authorization: Bearer pz_…"

# 다음 페이지: 직전 응답의 next_cursor
curl "https://pozto.co/api/v1/posts?brand_id=BRAND_ID&since=2026-10-01&cursor=NEXT_CURSOR" \
  -H "Authorization: Bearer pz_…"

오류

오류는 {"error": "…"}처럼 간단한 문장 하나가 담긴 JSON과 4xx 상태 코드로 돌아옵니다.

• 400: 본문이 JSON이 아니거나, 미래의 배송 완료일처럼 필드 값이 올바르지 않습니다.
• 401: 키가 없거나, 틀렸거나, 폐기된 키입니다.
• 403: 팀이 Brand 요금제가 아닙니다.
• 404: 팀에 해당 brand_id의 브랜드가 없습니다.
• 409: 팀이 쓰는 브랜드 수가 요금제 한도보다 많아 브랜드가 잠겨 있습니다.
• 429: 1분에 120회를 넘게 요청했습니다.

API로 할 수 없는 것

• 인플루언서 검색 없음. 내 목록을 읽고 추가할 뿐입니다. 크리에이터 검색은 앱의 크리에이터 찾기에서 합니다.
• 응답에 조회수, 좋아요, EMV 없음. 이 수치는 Starter부터 앱에서, 그리고 주간 리포트에서 볼 수 있습니다. 인플루언서 리포팅을 참고하세요.
• 웹훅 없음. 새 게시물을 가져오려면 since를 붙여 GET /posts를 요청하세요.
• 수정·삭제 없음. API는 읽기와 추가만 합니다. 수정과 삭제는 앱에서 합니다.
• 개인별 키 없음. 키는 팀 소유이며 소유자만 만들 수 있습니다.

게시물 데이터는 앱과 같습니다. Pozto는 영상의 프레임, 오디오, 캡션을 보고 게시물을 찾으므로 태그 없는 게시물도 함께 들어옵니다. 게시물을 찾는 방식은 인플루언서 추적에서 설명합니다.

요금

API는 Brand 요금제에 포함됩니다. 월 $999, 연간 결제 시 월 $799이며 브랜드 10개, 활성 크리에이터 1,000명, 무제한 좌석, 싱글 사인온(SSO)이 제공됩니다. Pozto의 다른 기능은 모두 더 낮은 요금제부터 쓸 수 있고, 무료 요금제로 처음 크리에이터 10명까지 이용할 수 있습니다. 요금제 보기.