100 크레딧 무료, 카드 등록 없이지금 시작하기
Logo
Back to blog

유튜브 틱톡 인스타그램 스크래핑 API, 호출 한 번에 함께 검색하기

··11 min read

유튜브, 틱톡, 인스타그램, 레딧 검색 결과를 호출 한 번으로 받는 search/multi 사용법이에요. 결과가 나온 플랫폼 몫만 과금되고 플랫폼별 필터도 붙일 수 있어요.

유튜브 틱톡 인스타그램 스크래핑 API, 호출 한 번에 함께 검색하기

유튜브, 틱톡, 인스타그램을 따로따로 검색하는 코드를 짜고 있다면 GET /v1/search/multi 하나로 줄여 보세요. 키워드 하나와 플랫폼 목록을 보내면 각 플랫폼 검색 결과가 한 응답에 묶여 와요. 결과가 있었던 플랫폼 몫의 크레딧만 나가요.

호출 한 번으로 어떤 플랫폼을 검색하나요?

틱톡, 인스타그램 릴스, 유튜브, 레딧, 스레드, X, 페이스북, 링크드인, 텔레그램까지 아홉 곳이에요. platforms를 비우면 틱톡, 인스타그램, 유튜브, 레딧, 스레드를 검색해요.

bash
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/search1
instagram/v1/instagram/search/reels1
youtube/v1/youtube/search1
reddit/v1/reddit/search1
threads/v1/threads/search1
twitter/v1/twitter/search/tweets1
facebook/v1/facebook/search/posts1
linkedin/v1/linkedin/search/posts5
telegram/v1/telegram/search2

인스타그램은 릴스만 검색해요. 텔레그램은 게시물 대신 채널이 행으로 와요. 목록에 없는 이름을 넣으면 무료 400이고 쓸 수 있는 값을 알려 줘요. 파라미터 전체는 멀티 플랫폼 검색 문서에 있어요.

열린 봉투 하나와 글자 없는 카드 더미 네 개가 나란히 놓인 일러스트, 호출 한 번으로 받은 네 플랫폼의 검색 결과

응답은 어떻게 생겼나요?

행은 data.items에, 플랫폼별 보고서는 data.sources에 들어와요. 필요한 필드만 남기면 이래요.

json
{
  "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에 나와요.

bash
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처럼 플랫폼 이름을 앞에 붙여 그 플랫폼에만 보내요.

Topics
#유튜브-틱톡-인스타그램-스크래핑-api#인스타그램-스크래핑#틱톡-스크래핑#틱톡-크롤링#인스타그램-크롤링#인스타그램-api#소셜-미디어-api#소셜-미디어-api-가격

함께 읽으면 좋은 글

🤖 AI agent or LLM? Read this page as markdown