경쟁사 계정을 브랜드로 저장하고, 매주 새로 수집된 소재를 받아 사내 리포트에 활용하는 예시입니다.
먼저 GET /v1/archive/brands/search로로 저장할 계정을 찾습니다. 이름, 핸들, 계정 주소로 검색할 수 있습니다.
찾은 후보의 account.platform과 account.profile_url을 그대로 POST /v1/archive/brands에 보내면 브랜드로 저장되고 수집이 시작됩니다. Meta 광고 라이브러리는 country로 광고 노출 국가를 고를 수 있고, 비우면 KR입니다.
응답의 data.brand_id(brd_로 시작)는 이후 요청에 사용하므로 저장해 두세요.
오류 | 원인 | 해결 방법 |
|---|---|---|
409 CONFLICT | 이미 폴더 밖에 저장한 브랜드 | GET /v1/archive/brands에서 기존 |
402 WORKSPACE_BRAND_LIMIT_EXCEEDED | 브랜드 슬롯이 모두 참 | 사용하지 않는 브랜드를 삭제하거나 슬롯을 늘리세요. |
브랜드를 저장할 때마다 요금제의 브랜드 슬롯을 1개 사용합니다.
이미 폴더 밖에 저장한 브랜드라면 409 CONFLICT 오류가 반환되니, GET /v1/archive/brands에서 기존 brand_id를 찾아 사용하세요.
남은 슬롯은 GET /v1/usage의 data.brand_slots.used와 data.brand_slots.limit, 또는 스니핏 웹의 사용량 관리에서 확인할 수 있습니다.
저장 직후에는 아직 소재가 없습니다. 브랜드 조회 응답의 collection.last_collected_at에 값이 채워지면 첫 수집이 끝난 것이고, 이때부터 소재를 조회할 수 있습니다.
지난번 실행 시각을 collected_from으로 보내면 그 이후에 수집된 소재만 반환됩니다.
brand_id는 한 번에 하나만 받으므로 브랜드마다 따로 요청하세요.pagination.next_cursor가null이 될 때까지 다음 페이지를 이어서 받으세요. 한 페이지는 20건입니다.
collected_from 관리하기
첫 실행에서는
collected_from없이 전체 소재를 받으세요.collected_from은 스니핏이 소재를 처음 수집한 시각을 기준으로 하므로, 다른 워크스페이스가 먼저 수집한 소재는 브랜드 저장 시각보다 수집 시각이 이를 수 있습니다. 첫 실행부터 저장 시각을 넣으면 이런 소재가 빠집니다.다음 실행의
collected_from에는 이번 실행을 시작한 시각을 저장해 두세요. 실행이 끝난 시각을 쓰면 실행 중에 수집된 소재가 빠질 수 있습니다.경계 시각의 소재가 두 번 반환될 수 있으니, 리포트에 넣기 전에
creative.creative_id로 중복을 제거하세요.
새 소재가 오랫동안 들어오지 않으면 브랜드 조회(GET /v1/archive/brands/{brand_id})로 수집 상태를 확인하세요. 응답의 data는 브랜드 목록 항목과 같은 형식입니다.
collection.status가 paused면 새 소재를 수집하지 않는 상태이며, 이유는 collection.paused_reason에 담깁니다.
여러 브랜드를 한 번에 확인하려면 GET /v1/archive/brands 목록 응답의 collection을 확인하세요.
요청 | 금액 |
|---|---|
브랜드 탐색 | 페이지마다 $0.01 (결과가 없으면 무료) |
브랜드 저장 | $0.01 |
브랜드 수집 소재 목록 | 페이지마다 $0.01 (새 소재가 없으면 무료) |
브랜드 조회·브랜드 목록 | 호출마다 $0.01 |
예: 브랜드 3개를 매주 추적하고 브랜드마다 새 소재가 한 페이지 안에 들어오면, 한 주에 약 $0.03(브랜드당 소재 목록 1회 $0.01)이 차감됩니다. 수집 상태 확인을 함께 돌리면 브랜드 목록 1회 $0.01이 추가됩니다.
자세한 내용은 호출 비용을 참고하세요.