유튜브 틱톡 인스타그램 스크래핑 API, 호출 한 번에 함께 검색하기
유튜브, 틱톡, 인스타그램, 레딧 검색 결과를 호출 한 번으로 받는 search/multi 사용법이에요. 결과가 나온 플랫폼 몫만 과금되고 플랫폼별 필터도 붙일 수 있어요.
유튜브, 틱톡, 인스타그램을 따로따로 검색하는 코드를 짜고 있다면 GET /v1/search/multi 하나로 줄여 보세요. 키워드 하나와 플랫폼 목록을 보내면 각 플랫폼 검색 결과가 한 응답에 묶여 와요. 결과가 있었던 플랫폼 몫의 크레딧만 나가요.
호출 한 번으로 어떤 플랫폼을 검색하나요?
틱톡, 인스타그램 릴스, 유튜브, 레딧, 스레드, X, 페이스북, 링크드인, 텔레그램까지 아홉 곳이에요. platforms를 비우면 틱톡, 인스타그램, 유튜브, 레딧, 스레드를 검색해요.
curl "https://www.socialcrawl.dev/v1/search/multi?query=뉴진스&platforms=tiktok,instagram,youtube,reddit" \
-H "x-api-key: $SOCIALCRAWL_API_KEY"멀티는 아래 표의 검색 엔드포인트를 플랫폼마다 그대로 불러요. 크레딧도 그 엔드포인트 한 페이지 값과 같아요.
platforms 값 | 실제로 부르는 엔드포인트 | 한 페이지 크레딧 |
|---|---|---|
tiktok | /v1/tiktok/search | 1 |
instagram | /v1/instagram/search/reels | 1 |
youtube | /v1/youtube/search | 1 |
reddit | /v1/reddit/search | 1 |
threads | /v1/threads/search | 1 |
twitter | /v1/twitter/search/tweets | 1 |
facebook | /v1/facebook/search/posts | 1 |
linkedin | /v1/linkedin/search/posts | 5 |
telegram | /v1/telegram/search | 2 |
인스타그램은 릴스만 검색해요. 텔레그램은 게시물 대신 채널이 행으로 와요. 목록에 없는 이름을 넣으면 무료 400이고 쓸 수 있는 값을 알려 줘요. 파라미터 전체는 멀티 플랫폼 검색 문서에 있어요.
응답은 어떻게 생겼나요?
행은 data.items에, 플랫폼별 보고서는 data.sources에 들어와요. 필요한 필드만 남기면 이래요.
{
"data": {
"search_status": "complete",
"total": 129,
"duplicates_removed": 0,
"credits_charged": 4,
"sources": {
"tiktok": {
"endpoint": "/v1/tiktok/search",
"status": "ok",
"rows": 30,
"rows_kept": 30,
"credits": 1,
"next_cursor": "sc.…",
"has_more": true
}
},
"items": [
{ "platform": "tiktok", "post": { "id": "…", "url": "…" }, "computed": {} }
]
},
"credits_used": 4
}| 필드 | 뜻 |
|---|---|
items | 플랫폼 순서대로 묶인 행이에요. 각 행은 그 플랫폼 검색이 주는 모양 그대로이고 platform만 붙어요. |
sources.<플랫폼> | status(ok, empty, failed), 받은 행 수, 기간 필터와 중복 제거 뒤 남은 행 수, 크레딧, 다음 페이지 커서예요. |
duplicates_removed | 같은 게시물 URL이 이미 나와서 뺀 행 수예요. 먼저 나온 행이 남아요. |
search_status | 실패한 플랫폼이 없으면 complete이고 일부만 실패하면 partial이에요. |
credits_charged | 플랫폼별 크레딧의 합이에요. credits_used와 같아요. |
items의 순서는 묶음 순서일 뿐 순위가 아니에요. 인기순이 필요하면 post.engagement로 직접 정렬하세요.
크레딧은 어떻게 계산되나요?
크레딧은 플랫폼마다 한 페이지 값으로 매겨요. 행을 돌려준 플랫폼 몫만 나가요. 호출을 시작할 때 요청한 플랫폼 값의 합을 잡아 두었다가 실패했거나 비어 있던 플랫폼 몫을 돌려줘요.
| 상황 | 크레딧 |
|---|---|
| 기본 다섯 곳 모두 행이 있음 | 5 |
| 틱톡, 인스타그램, 유튜브 중 인스타그램이 비어 있음 | 2 |
| 틱톡과 링크드인 모두 행이 있음 | 6 |
| 모든 플랫폼이 실패 | 0 (전액 환불, 502) |
| 5분 안의 같은 호출 | 0 |
예를 들어 틱톡, 인스타그램, 유튜브, 레딧을 검색하면 4크레딧이에요. 값은 엔드포인트 가격에서 확인하세요.
플랫폼별 필터와 다음 페이지는 어떻게 쓰나요?
필터 이름 앞에 플랫폼을 붙여요. tiktok.region=KR이나 reddit.sort=new처럼요. 이름을 붙인 플랫폼에만 전달돼요. 기간은 모든 플랫폼에 함께 걸려요. since는 그 날짜 이후, until은 그 날짜까지 올라온 글만 남겨요. 둘을 같이 보내면 한 달 단위로 잘라 보기 좋아요. 날짜가 없는 행은 남아요. 자체 날짜 필터가 있는 플랫폼에는 그 필터로도 기간을 보내요. 무엇을 보냈는지는 data.window에 나와요.
curl "https://www.socialcrawl.dev/v1/search/multi?query=뉴진스&platforms=tiktok,reddit&since=2026-09-01&until=2026-09-30&reddit.sort=new" \
-H "x-api-key: $SOCIALCRAWL_API_KEY"region은 그 시장의 결과를 앞쪽으로 끌어올리지만 모든 행이 그 나라라는 보장은 아니에요. 확실히 걸러야 하면 행에 적힌 국가 값으로 한 번 더 걸러요.
멀티는 플랫폼마다 한 페이지만 돌려주고 스스로 페이지를 넘기지 않아요. cursor를 보내면 400이에요. 더 깊이 보려면 sources.<플랫폼>.endpoint에 적힌 엔드포인트를 같은 query로 부르고 next_cursor를 cursor로 넘기세요. 조회수 하한(min_views)이나 기간 제한(max_age_days), 여러 페이지(max_pages) 같은 조건은 /v1/tiktok/search처럼 개별 검색 엔드포인트에서만 써요. 과금 방식은 페이지네이션 문서에 있어요. 멀티가 모르는 파라미터를 보내면 에러 없이 무시되고 _warnings에 이름만 남아요.
멀티 검색이 해 주지 않는 일은 무엇인가요?
- 검색어를 바꾸거나 풀어 쓰지 않아요. 같은 문장이 모든 플랫폼에 그대로 가요.
- 플랫폼 사이의 순위를 매기지 않아요. 순위와 묶음이 필요하면
search/everywhere가 맞아요. 검색 한 번에 20크레딧 고정이에요. 검색어를 알아서 짜고 상위 댓글까지 읽어요. 소셜 검색 엔진 API에 자세히 있어요. - 한 플랫폼의 두 번째 페이지를 대신 걷지 않아요.
자주 묻는 질문
유튜브, 틱톡, 인스타그램을 한 번에 검색할 수 있나요?
네, 돼요. GET /v1/search/multi에 query와 platforms=tiktok,instagram,youtube를 보내면 세 곳의 검색 결과가 한 응답으로 와요. 인스타그램은 릴스 검색이에요.
비용은 얼마나 나오나요?
플랫폼마다 한 페이지 값이 붙어요. 대부분 1크레딧이고 텔레그램은 2, 링크드인은 5예요. 행이 없거나 실패한 플랫폼은 환불돼서 결과가 나온 곳만 나가요.
검색 결과를 플랫폼 사이에서 순위로 줄 세워 주나요?
아니요. 멀티는 플랫폼별 결과를 묶어서 주기만 해요. 순위가 필요하면 search/everywhere를 쓰세요.
한 플랫폼의 다음 페이지는 어떻게 받나요?
data.sources에 있는 next_cursor를 그 플랫폼의 검색 엔드포인트에 cursor로 보내세요. 멀티 자체에는 cursor를 보낼 수 없어요.
기간이나 국가로 걸러도 되나요?
기간은 since와 until이 모든 플랫폼에 적용돼요. 국가나 정렬은 tiktok.region, reddit.sort처럼 플랫폼 이름을 앞에 붙여 그 플랫폼에만 보내요.
함께 읽으면 좋은 글
페이스북 댓글 크롤링, 게시물 25개를 한 번에 읽어요
페이스북, 인스타그램, 틱톡, 유튜브 게시물 25개의 댓글을 API 호출 한 번으로 읽어요. since를 넣으면 새 댓글만 읽고 새 댓글이 없으면 크레딧도 들지 않아요.
인플루언서 검색 API: 팔로워가 아니라 조회수로 크리에이터 고르기
인플루언서 검색 API 한 번으로 주제와 국가, 규모에 맞는 크리에이터를 찾아요. 최근 게시물에서 잰 중간 조회수로 순위를 매기고 드라이런으로 비용도 미리 확인해요.
틱톡과 유튜브 이메일 찾기 API, include=contacts 한 줄로
프로필 호출에 include=contacts를 붙이면 크리에이터가 공개한 비즈니스 이메일과 출처가 와요. 결과 상태 다섯 가지와 재시도, 크레딧 규칙까지 담았어요.
