카테고리
시작하기
빠른 시작
스니핏 API로 각 플랫폼의 광고와 게시물 소재를 검색할 수 있습니다. 워크스페이스에 저장한 브랜드의 소재와 보드를 다루거나 조회할 수도 있습니다. 이 문서는 결제 수단 등록부터 첫 요청을 보내기까지의 과정을 안내합니다. 시작하기 전에 - API는 Scale 플랜을 사용하는 워크스페이스에서만 이용할 수 있습니다. - 결제 수단 등록과 API 키 발급은 워크스페이스 소유자와 관리자만 할 수 있습니다. 1. 결제 수단 등록 개발자 콘솔의 결제에서 결제 수단을 등록하세요. API 요금은 플랜 요금과 별도로, 미리 충전한 달러 잔액에서 차감됩니다. 자세한 내용은 요금을 참고하세요. 2. API 키 만들기 개발자 콘솔의 API 키에서 키 만들기를 누르고 키 이름을 입력합니다. 키 원문(snp_live_로 시작)은 만들 때 한 번만 표시됩니다. 창을 닫기 전에 안전한 곳에 저장하세요. 키를 다루는 방법은 인증을 참고하세요. 3. 키 확인하기 먼저 GET /v1/usage로 키가 동작하는지 확인인증
스니핏 API는 API 키로 요청을 인증합니다. 모든 요청의 Authorization 헤더에 API 키를 담아 보내세요. Authorization: Bearer snp_live_xxxxxxxxxxxxxxxx API 키는 개발자 콘솔의 API 키에서 만듭니다. 발급 절차는 빠른 시작을 참고하세요. API 키 다루기 - API 키는 snp_live_로 시작합니다. 테스트용 키는 별도로 제공하지 않습니다. - 키 원문은 만들 때 한 번만 표시됩니다. 스니핏은 키 원문을 저장하지 않으므로 다시 보여 드릴 수 없습니다. 키를 잃어버렸다면 API 키에서 키 교체로 새 원문을 받으세요. - API는 서버에서만 호출하세요. 브라우저나 모바일 앱에 포함된 키는 누구나 추출해 사용할 수 있습니다. - 키가 유출된 것 같으면 API 키에서 바로 교체하거나 폐기하세요. 교체한 이전 원문과 폐기한 키는 더 이상 사용할 수 없으며, 최대 1분 안에 해당 키로 보낸 모든 요청이 거절됩니다. 키의 권한 API요금
요금 스니핏 API는 선불 달러 잔액으로 과금합니다. 요청을 보내면 엔드포인트별로 정해진 금액이 워크스페이스 잔액에서 차감됩니다. 잔액은 마이크로달러 정수(1달러 = 1,000,000)로 저장됩니다. API 잔액은 플랜 요금제에 포함된 하루 크레딧과 별도입니다. API는 Scale 요금제를 사용하는 워크스페이스에서만 이용할 수 있습니다. 가격 항목 값 소재 검색·유사 소재 검색 1회 $0.02 영상 검색 1회 $0.05 그 외 호출 1회 $0.01 사용량 확인 (GET /v1/usage) 무료 엔드포인트별 금액과 차감되지 않는 경우는 호출 비용을 참고하세요. 충전 개발자 콘솔의 결제에 등록한 결제 수단으로 충전합니다. 1회 충전 금액은 $50 ~ $1,000입니다. 사업자 정보를 등록하지 않으면 결제 금액에 세금 10%가 추가되고, 등록하면 추가되지 않습니다. 세금은 잔액에 포함되지 않습니다. 예: $50을 충전하고 세금 10%가 붙으면 결제 수단에서 $55가 결제되고, 잔액에는 $호출 한도
호출 한도 호출 한도는 API 키마다 따로 적용됩니다. 같은 워크스페이스라도 키가 다르면 한도도 따로 계산되며, 키 하나의 한도에는 모든 엔드포인트의 호출이 합산됩니다. 항목 한도 API 키 초당 호출 수 5회 이어서 받을 수 있는 결과 소재 검색·영상 검색·유사 소재 검색은 약 1,000건, 브랜드 탐색은 약 400건까지 cursor 유효기간 발급 후 24시간 워크스페이스당 API 키 최대 20개 워크스페이스당 API 키 한도에는 개발자 콘솔에서 직접 만든 키 중 폐기하지 않은 키만 포함됩니다. 한도를 넘었을 때 초당 호출 한도를 넘으면 429 RATE_LIMITED 오류와 함께 Retry-After 헤더가 반환됩니다. 같은 값이 오류 본문의 detail.retry_after_seconds에도 담깁니다. - 안내된 시간(초)만큼 기다린 뒤 다시 요청하세요. - 재시도 횟수에는 상한을 두는 것을 권장합니다. - 한도에 걸린 요청은 금액이 차감되지 않습니다. 잔액 부족과 구분하기 잔액호출 비용
API 키로 호출하면 엔드포인트별로 정해진 금액이 워크스페이스 잔액에서 차감됩니다. 금액은 마이크로달러 정수(1달러 = 1,000,000)로 저장되며, 응답 본문의 usage.cost_micro_usd와 응답 헤더 X-Cost-Micro-Usd로 확인할 수 있습니다. 요약 호출 1회당 비용 소재 검색, 유사 소재 검색 $0.02 영상 검색 $0.05 그 외 호출 $0.01 사용량 확인 무료 cursor로 다음 페이지를 받아도 단가는 같습니다. 엔드포인트별 금액 검색 엔드포인트 기능 금액 차감 조건 GET /v1/search/creatives 소재 검색 $0.02 결과나 다음 페이지가 있을 때 GET /v1/search/similar 유사 소재 검색 $0.02 결과나 다음 페이지가 있을 때 GET /v1/search/videos 영상 검색 $0.05 결과나 다음 페이지가 있을 때 소재 (모두 $0.01) 엔드포인트 기능 차감 조건 GET /v1/creatives/{creative_id