뒷광고 찾기 API, 협찬 확률과 광고 표시 여부까지
TikTok, X, 유튜브, 레딧 검색 결과에서 협찬 게시물과 뒷광고 의심 글을 골라내세요. 협찬 확률, 광고 표시 여부, 홍보 계정이 게시물마다 와요.
뒷광고 의심 게시물은 검색 결과에서 바로 가려내면 돼요. SocialCrawl의 TikTok, X, 유튜브, 레딧 검색에 label=sponsored,intent,niche를 붙이면 게시물마다 협찬일 확률 p, 광고 표시를 찾았는지 여부, 홍보 대상 계정이 같이 와요.
답은 확률이고 위반 판정은 아니에요. 사람이 확인할 후보를 좁혀 주는 값이에요. 영상은 보지 못하고 캡션(유튜브는 제목)만 읽어요. AI가 쓴 글인지 매기는 점수도 같은 label 파라미터로 받아요. 방법은 AI 글 탐지 API에 있어요.
게시물 목록에서 뒷광고를 바로 찾는 법
검색 한 번이면 돼요. 라벨 이름을 직접 적으면 모든 행이 그 응답 안에서 판정돼요. 이름을 적지 않아도 기본으로 붙지만 일부 행은 다음 호출에서야 채워져요. 이름을 적는다고 요금이 더 나오지는 않아요.
curl -G -H "x-api-key: $SOCIALCRAWL_API_KEY" \
"https://www.socialcrawl.dev/v1/tiktok/search" \
--data-urlencode "query=협찬 스킨케어" \
--data-urlencode "label=sponsored,intent,niche" \
--data-urlencode "label_evidence=1"게시물 하나는 이런 모양으로 와요(필요한 필드만 남겼어요).
{
"post": {
"content": { "text": "세안 후 피부 당길 때 찾는 미스트 … #협찬 #미스트 #수분미스트" }
},
"computed": {
"labels": {
"sponsored": { "p": 0.97, "disclosed": true, "undisclosed": false, "brand": null }
},
"labels_evidence": {
"sponsored": { "quote": "… #협찬 #미스트 #수분미스트", "sentence_index": 0 }
}
}
}sponsored: true 같은 불리언은 없어요. 대신 값 네 개가 와요.
| 필드 | 뜻 |
|---|---|
p | 협찬이거나 제품을 받은 홍보일 확률(0~1)이에요 |
disclosed | 캡션에서 #광고나 #협찬 같은 표시를 규칙으로 찾으면 true예요 |
undisclosed | p가 0.7 이상인데 표시를 못 찾으면 true예요 |
brand | 캡션 속 @멘션 중 홍보 대상으로 보이는 계정이에요. 없으면 null이에요 |
label_evidence=1을 붙이면 점수의 근거가 된 문장이 computed.labels_evidence에 원문 그대로 와요. 한 문장으로 짚을 수 없으면 null이에요. 검색 엔드포인트 자체는 TikTok 영상 검색 API 글에서 다뤄요.
뒷광고는 불법인가요? 표시광고법과 공정위 심사지침
뒷광고는 광고 대가를 받고도 광고라는 걸 밝히지 않은 게시물을 부르는 말이에요. 법률 용어는 아니에요. 공정거래위원회는 「추천·보증 등에 관한 표시·광고 심사지침」 개정안을 2020년 9월 1일부터 시행했어요. 광고주와 경제적 이해관계가 있으면 공개하라는 내용이에요(정책브리핑). 표시 문구로는 '광고', '유료광고', '협찬' 같은 표현이 예로 나와요. 동영상은 제목이나 영상 안에, 글 중심 매체는 제목이나 첫 부분에 넣어요(생활법령정보). 제재 수위는 현행 법령에서 직접 확인해 주세요.
공정위가 점검한 결과를 보면 의심 게시물의 상당수가 인스타그램과 네이버 블로그에 있었어요.
| 발표 | 의심 게시물 | 상위 매체 | 문제 유형 |
|---|---|---|---|
| 2022년 2월 | 17,020건 | 인스타그램 9,538 / 네이버 블로그 7,383 | 위치 부적절 38.8%, 미표시 35.3%, 표현 부적절 14.7% |
| 2025년 3월 (2024년분) | 22,011건 | 인스타그램 10,195 / 네이버 블로그 9,423 | 위치 부적절 39.4%, 미표시 26.5%, 표현 부적절 17.3% |
출처는 공정위 보도자료, ZDNet, 한경비즈니스, 파이낸셜뉴스예요. 두 발표의 점검 방식이 같은지 알 수 없어서 이 표를 추세로 읽지는 않아요.
협찬 표기를 읽을 때 어디서 어긋나나요?
disclosed와 undisclosed는 표시 문구를 찾는 규칙에서 나와요. p는 모델이 판단한 값이라 둘이 어긋나는 행이 생겨요. 항상 같이 보세요.
- 협찬 표시가 있는데
p가 낮은 행이 있어요. 협찬받는 방법을 알려 주는 글처럼 '협찬'이라는 단어만 들어간 경우예요. undisclosed: true는 규칙이 아는 표시를 못 찾았을 뿐 위반 판정은 아니에요.disclosed: true도 표시가 있다는 것까지만 알려 줘요. 공정위 기준에 맞게 적었는지는 알려 주지 않아요.brand는 캡션의 @멘션에서 가져와요. 멘션 없이 이름만 적으면null이에요.- 영상 속 말로만 밝힌 협찬이나 플랫폼의 유료광고 포함 토글은 이 데이터에 보이지 않아요.
게시물마다 분야와 작성 의도까지 읽을 수 있나요?
네. computed.labels.niche는 공개된 sc-niche-v1 분류의 주제 33개와 personal_no_niche, other 중 하나예요. 캡션이 너무 짧으면 null이에요. 이 분류는 공정위의 업종 분류와 달라요.
computed.labels.intent.label은 글쓴이가 주로 무엇을 하는지 알려 줘요. 값은 asking_for_recommendation, comparing_options, switching_away, complaining, promoting, news_or_discussion, other이고 확신이 없으면 null이에요. buyer는 잠재 구매자처럼 읽히는지를, seller는 판매자처럼 읽히는 정도를 알려 줘요.
협찬을 추적하는 작업이라면 niche.label로 분야를 좁히고 sponsored.p가 기준 이상인 글만 남기면 돼요. 구매 후보를 찾을 때는 intent.buyer가 true인 글만 보면 돼요. 같은 필드가 TikTok, X, 유튜브, 레딧 검색에서 같은 이름으로 와요.
어그로와 레이지베이트 게시물은 어떻게 거르나요?
label=quality를 더하면 computed.labels.quality에 값 다섯 개가 붙어요.
fact_density는 확인할 수 있는 구체 정보의 양(0~3 정수)이에요.engagement_bait는 좋아요, 댓글, 팔로우, 친구 태그를 요구하는 참여 유도 점수(0~1)예요.rage_bait는 분노를 일으키려고 쓴 글의 점수(0~1)예요. 글의 쓰임새를 볼 뿐 어느 편을 드는지는 보지 않아요.secondhand는 남의 소식이나 의견을 그대로 옮긴 정도,post_aim은 글의 주된 목적이에요.
engagement_bait는 우리말 '어그로'와 꼭 같지는 않아요. 경품 이벤트 글처럼 참여를 요구하는 글이 대표적이에요.
curl -G -H "x-api-key: $SOCIALCRAWL_API_KEY" \
"https://www.socialcrawl.dev/v1/twitter/search/tweets" \
--data-urlencode "query=giveaway RT follow tag a friend to win" \
--data-urlencode "sort=top" \
--data-urlencode "label=sponsored,intent,niche,quality" \
--data-urlencode "exclude=engagement_bait"exclude=engagement_bait는 engagement_bait가 0.8 이상인 글을 빼요. label=quality와 같은 호출에서만 쓸 수 있어요. 빠진 글의 id는 data.labels.dropped_ids에, 개수는 data.labels.dropped에 있어요. 최상위 data.dropped와 헷갈리지 마세요. 기준을 직접 정하고 싶으면 exclude 없이 quality.engagement_bait 점수로 걸러요.
exclude가 받는 값은 engagement_bait 하나뿐이에요. 레이지베이트는 rage_bait 점수를 보고 코드에서 직접 걸러요.
어떻게 시작하고 비용은 얼마나 드나요?
API 키 하나로 TikTok, X, 유튜브, 레딧을 비롯한 게시물 목록 엔드포인트에서 같은 라벨을 써요. 전체 목록은 라벨 문서에 있어요. 기본 라벨 sponsored, intent, niche는 무료이고 quality만 유료예요. 호출할 때 크레딧을 몇 개 잡아 두었다가 새로 판정한 25행마다 1크레딧만 남기고 돌려줘요. 이미 판정된 행과 캐시된 페이지는 무료예요.
비용 상한부터 보고 싶으면 dry_run=1을 붙이세요. 데이터는 가져오지 않고 크레딧도 들지 않아요.
curl -G -H "x-api-key: $SOCIALCRAWL_API_KEY" \
"https://www.socialcrawl.dev/v1/tiktok/search" \
--data-urlencode "query=협찬 스킨케어" \
--data-urlencode "label=quality" \
--data-urlencode "dry_run=1"응답의 estimate에 기본 크레딧과 라벨 크레딧의 최소와 최대가 와요. 코드를 쓰기 전에 비주얼 익스플로러에서 같은 경로를 열어 보는 방법도 있어요. 소셜 리스닝 전체를 한곳에 모으는 방법은 소셜 리스닝 글에 있어요.
자주 묻는 질문
뒷광고는 어떻게 구별하나요?
최종 판단은 사람이 공정위 지침(경제적 이해관계 공개, 표시 위치)을 기준으로 해요. API는 p, disclosed, undisclosed, 근거 문장으로 살펴볼 후보를 좁혀 줘요. undisclosed: true도 위반 판정은 아니에요.
협찬 게시물을 한꺼번에 찾을 수 있나요?
검색 결과 한 페이지 단위로 찾아요. 행마다 확률이 오지만 플랫폼 전체를 전수 조사하지는 않아요.
유료광고 포함 표시가 없어도 협찬으로 잡히나요?
네, 내용만 보고 p가 올라가는 행이 있어요. 표시를 못 찾았는데 p가 0.7 이상이면 undisclosed: true로 와요. 플랫폼의 유료광고 포함 토글은 이 데이터에 보이지 않아요.
어그로와 레이지베이트 게시물을 빼려면 어떻게 하나요?
label=quality와 exclude=engagement_bait를 같이 보내요. engagement_bait가 0.8 이상인 행이 빠져요. 레이지베이트는 rage_bait 점수를 보고 직접 걸러요.
협찬 여부 확인에 크레딧이 드나요?
기본 라벨 세 개는 무료예요. label=quality는 유료이고 새로 판정한 25행마다 1크레딧이 들어요. dry_run=1은 0크레딧으로 상한을 알려 줘요.
함께 읽으면 좋은 글
페이스북 댓글 크롤링, 게시물 25개를 한 번에 읽어요
페이스북, 인스타그램, 틱톡, 유튜브 게시물 25개의 댓글을 API 호출 한 번으로 읽어요. since를 넣으면 새 댓글만 읽고 새 댓글이 없으면 크레딧도 들지 않아요.
인플루언서 검색 API: 팔로워가 아니라 조회수로 크리에이터 고르기
인플루언서 검색 API 한 번으로 주제와 국가, 규모에 맞는 크리에이터를 찾아요. 최근 게시물에서 잰 중간 조회수로 순위를 매기고 드라이런으로 비용도 미리 확인해요.
틱톡과 유튜브 이메일 찾기 API, include=contacts 한 줄로
프로필 호출에 include=contacts를 붙이면 크리에이터가 공개한 비즈니스 이메일과 출처가 와요. 결과 상태 다섯 가지와 재시도, 크레딧 규칙까지 담았어요.
