스레드 API 2026: 만들 수 있는 것과 없는 것

스레드 API는 2024년 6월 18일 칸 라이언즈에서 공개됐고, 하루 만에 Sprout Social이 고객 3만 명 이상에게 적용했어요. 18개월이 지난 지금 스레드는 월간 활성 사용자 4억 명과 일간 1.5억 명을 넘겼고, API도 단순 게시 엔드포인트에서 나름의 색이 뚜렷한 작은 플랫폼으로 자랐어요. 핵심만 먼저 짚으면 이래요. 인증은 OAuth 2.0, 토큰은 60일, 모든 스코프는 메타 앱 심사를 거쳐야 하고, 키워드 검색은 7일에 500회로 묶여 있어요.

이 글은 마케터가 아니라 개발자를 위한 안내예요. 공식 API가 주는 것과 주지 않는 것, 레이트리밋 계산이 실제로 말하는 것, 그리고 서드파티 API가 대체재가 아니라 보완재로 어울리는 지점까지 짚어요. 형용사가 아니라 바로 쓸 수 있는 숫자로요.

스레드 API란

스레드 API는 스레드 플랫폼을 위한 메타의 공식 개발자 인터페이스예요. 메타 Graph API 인프라 위에 올라가 있고, RESTful 규칙과 JSON 응답을 쓰며, OAuth 2.0으로 인증해요. 페이스북이나 인스타그램 Graph API로 개발해 봤다면 손에 익은 감각이 거의 그대로 옮겨 와요.

주는 것부터 볼게요. 게시(텍스트 최대 500자, 이미지, 동영상, 2~20장짜리 캐러셀), 내 게시물과 답글 읽기, 답글 관리, 계정·미디어 단위 인사이트, 답글과 멘션 이벤트용 웹훅, 공개 키워드 검색(상한 있음, 아래 참고), 게시물 삭제까지 다뤄요. 2024년 10월에 붙은 페디버스 공유 토글 덕분에, 한 번의 호출로 ActivityPub 호환 서버까지 함께 퍼뜨릴 수도 있어요.

지금 이게 왜 중요한지는 과장이 아니라 숫자의 문제예요. 스레드는 출시 직후 닷새 만에 가입 1억(2023년 7월)을 찍은 뒤 2025년 1월 월간 활성 사용자 3.2억까지 올라섰고, 모바일 사용량은 전년 대비 127.8% 늘었어요. Evercore ISI는 2025년 매출 잠재력을 약 80억 달러로 봤고요. 개발자 입장에서는 공개·대화형 콘텐츠에서 X와 같은 급의 유통 채널이 하나 생긴 셈이고, 메타는 거의 분기마다 API 기능을 내놓고 있어요.

여기는 요약본이 아니라 원본 게시물이 흐르는 곳이에요. 취합된 SEO 페이지가 아니라 진짜 대화에 기대는 제품이라면, 이제 스레드는 피할 수 없어요.

인증 방식

인증은 OAuth 2.0이에요. 메타 특유의 토큰 두 단계 절차에, 아무도 미리 일러 주지 않는 함정 몇 개가 얹혀 있어요.

시작은 스레드 use case로 메타 앱을 만드는 거예요(인스타그램 use case도, 범용 비즈니스 use case도 아니에요). 그다음 정해진 메뉴에서 권한 스코프를 붙여요. threads_basic은 모든 엔드포인트에 필수고, threads_content_publish, threads_read_replies, threads_manage_replies, threads_manage_insights, threads_delete, threads_location_tagging, threads_keyword_search, threads_manage_mentions, 그리고 새로 생긴 threads_share_to_instagram(2026년 3월 25일 추가)은 use case마다 선택해서 켜요.

프로덕션 연동이 가장 많이 깨지는 지점이 토큰 수명이에요. 단기 액세스 토큰은 1시간이면 만료돼요. 이걸 60일짜리 장기 토큰으로 교환하고, 발급 후 24시간에서 60일 사이에 갱신할 수 있어요. 이 창을 놓치면 사용자가 다시 권한을 줘야 해요. 연결된 스레드 프로필이 비공개라면, 토큰 상태와 상관없이 90일이 지나면 권한이 만료돼요. 완전히 별개의 시계로 돌아가요.

갱신 스크립트가 아니라 갱신 잡을 만드세요. 토큰 갱신은 예약·모니터링·알림이 붙고 데드레터 큐까지 있는 크론이어야 해요. 실제 현장의 장애 대부분은 코드가 아니라 토큰이에요.

2025년 초에 하나 더 생겼어요. 텍스트 전용 게시물은 이제 auto_publish_text 파라미터 하나로 한 번에 올릴 수 있어요. 예전의 두 번 호출(미디어 컨테이너 생성 후 컨테이너 게시)을 단일 POST로 접어 준 거죠. 나머지는 여전히 두 단계 패턴을 써요.

레이트리밋

대표 공식은 단순해요. 24시간당 호출 수 = 4,800 × 계정 노출 수, 최소 노출 하한은 10이에요. 즉 팔로워도 노출도 0인 갓 만든 계정도 24시간 창당 4만 8,000회는 받아요. 하루 노출 10만인 웬만한 계정은 4억 8,000만 회까지 쓸 수 있고요. 겉보기 숫자는 넉넉해요.

그런데 실제로 발목을 잡는 건 호출 예산이 아니라 게시 상한이에요. 프로필당, 24시간 롤링 기준으로 게시물 250개, 답글 1,000개, 삭제 100건, 위치 검색 500회예요. 20장짜리 캐러셀도 250개 상한에는 게시물 하나로 세요. 미디어가 많은 스케줄러를 만든다면 놓치면 안 되는 디테일이에요.

키워드 검색은 그중에서도 가장 빡빡해요. 7일 롤링 기준 500회예요. 고르게 나눠 써도 하루 70회쯤이죠. 리서치나 리스닝 제품이라면 이건 물렁한 상한이 아니라 단단한 천장이에요.

진짜 이야기는 이 비대칭이에요. 게시는 넉넉하고 검색은 배급제라, 실제로 부딪히는 한계는 무엇을 만드느냐에 전적으로 달려 있어요. 게시 봇은 평생 한계 안에서 살고, 모니터링 제품은 화요일이면 키워드 검색 벽에 부딪혀요.

지금 만들 수 있는 것

2026년 스레드 API 제품의 정직한 분류는 단출해요. 크게 네 가지 모양이 있고, 프로덕션 앱 대부분이 그중 하나예요.

스케줄러와 퍼블리셔. 물량으로는 가장 큰 갈래예요. Hootsuite, Sprout Social, Sprinklr, Grabyo, Social News Desk, Techmeme이 첫날부터 베타 파트너였어요. 패턴은 다 똑같아요. 콘텐츠를 큐에 담고, 미디어를 렌더링하고, 두 단계로 게시하고, 돌아온 미디어 ID를 저장하고, 정해진 주기로 인사이트를 폴링해요. n8n 커뮤니티는 출시 이후로 동작하는 설정을 공개적으로 주고받고 있어요.

인박스와 답글 관리. threads_manage_replies와 2024년 10월에 붙은 답글 웹훅이면, 스레드 네이티브 인박스에 가까운 걸 만들 수 있어요. 숨기고, 다시 보이게 하고, 답하고, 라우팅하는 거죠. 실시간 웹훅 덕분에 더는 폴링할 필요가 없어요.

인사이트와 리포팅. 인사이트 엔드포인트는 게시물별 조회, 좋아요, 답글, 리포스트, 인용, 공유를 주고, 계정 단위로는 팔로워 수와 인구통계를 줘요. 데이터는 좋은데 조회 가능한 기간이 짧아서, 직접 창고에 쌓아 두는 게 좋아요.

리서치와 모니터링. 공식 API가 가장 먼저 길이 끊기는 지점이에요. 7일에 500회 키워드 검색은 호기심 대시보드용이지 제품용은 아니에요. 공개 멘션 조회는 내 프로필을 브랜드 모니터링하는 데는 도움이 되지만, 주제 전반을 아우르는 일반 리스닝은 안 돼요. 폭이 필요하면 서드파티 API로 손을 뻗게 돼요.

공식 API로는 못 만드는 것도 분명해요. 크로스 플랫폼 검색 엔진, 대량 추출 파이프라인, 스레드 전역 트렌드 감지기, 남의 콘텐츠를 대규모로 읽어야 하는 무엇이든요. 일부러 범위 밖에 둔 것이고, 메타가 이 조리개를 넓힐 가능성은 낮아요.

공식 API와 서드파티 API 비교

정직하게 나누면 이래요. 공식 API는 쓰기용, 서드파티 API는 대규모 읽기용이에요. 아마 둘 다 필요할 거예요.

메타 API는 달러로는 무료지만 달력으로는 비싸요. 모든 권한 스코프가 메타 앱 심사를 통과해야 하는데, 화면 녹화와 개인정보처리방침이 필요하고 비즈니스 인증까지 요구되는 경우가 잦아요. 1차 반려가 나면 사이클마다 대략 일주일씩 늘고, 대부분의 팀은 스코프당 2~4번의 사이클을 잡아 둬요.

서드파티 스레드 API는 달러를 내고 시간을 아껴요. EnsembleData는 하루 50유닛 무료 티어에서 시작해 대량 추출용은 월 약 1,400달러까지 올라가요. Data365는 Basic 월 300파운드, Standard 월 850파운드예요. Apify와 Bright Data는 범용 스크래핑 인프라를 주지만 스레드 전용 스키마는 없어요. Zernio는 같은 "통합 소셜 API" 각도를 노리고, Blotato는 메타의 OAuth와 앱 심사를 게시용 단일 엔드포인트 뒤로 감싸 줘요.

SocialCrawl도 이 층에 있지만, 모양이 일부러 달라요. 스레드를 321개 엔드포인트 통합 API가 다루는 43개 플랫폼 중 하나로 보고, 공개 데이터를 읽기 전용으로 줘요. 모든 스레드 응답이 레딧, X, 틱톡, 인스타그램, 유튜브를 비롯한 나머지와 똑같은 봉투로 돌아오고, engagement_rate, estimated_reach, content_category, language가 서버에서 계산돼 담겨요. 앱 심사도 없고, OAuth 저글링도 없고, 100크레딧이 딸린 $0 무료 티어예요. 요약본이 아니라 원본 게시물이고요.

선택은 어떤 API를 고르느냐가 아니에요. 어떤 문제를 어디에 둘 것이냐예요. 게시는 메타 API에, 읽기와 크로스 플랫폼 리스닝은 통합 API에 두는 거죠.

앱 심사 비용

앱 심사는 아무도 로드맵에 원가로 넣지 않는 병목이에요. 문서 페이지 버전 말고, 실제 달력 비용을 짚어 볼게요.

권한 스코프는 저마다 따로 제출해요. 종단 간 사용자 흐름을 보여 주는 화면 녹화, 호스팅된 개인정보처리방침, 이용약관이 필요하고, 게시나 인사이트에 손대는 스코프라면 앱 뒤에 있는 법인의 비즈니스 인증까지 요구돼요. 심사는 보통 스코프당 27 영업일이 걸려요. 1차 반려율은 대략 6070%인데, 대부분 겉치레 이유예요. 화면 녹화에 단계가 빠졌거나, 개인정보처리방침 URL이 404를 뱉거나, 비즈니스 인증 서류 형식이 틀렸거나요.

스코프 네 개짜리 프로덕션 앱(threads_basic, threads_content_publish, threads_read_replies, threads_manage_insights)의 현실적인 예산은 심사에 걸리는 실제 시간으로 3~6주예요. 깔끔하게 병렬로 돌지도 않아요. 심사자가 다음 스코프를 승인하기 전에 앞 스코프가 동작하는 걸 보고 싶어 할 때가 있거든요.

사이클을 줄이는 패턴이 둘 있어요. 초대한 테스터를 상대로 개발 모드에서 최대한 오래 굴리고, 흐름이 프로덕션 모양이 됐을 때만 제출하세요. 각 단계를 문서상 스코프 설명에 그대로 매핑하는 내레이션을 넣어 화면 녹화를 만드세요. 심사자는 지루하고 곧이곧대로인 영상을 좋아해요.

인디 개발자가 가장 자주 걸려 넘어지는 오해는 이거예요. 앱 심사는 만들기 위해 필요한 게 아니라, 출시하기 위해 필요해요. 개발 모드에서는 나와 초대한 테스터가 모든 스코프를 자유롭게 써요. 개인 자동화나 내부 도구라면 그걸로 충분해요. 하지만 공개 제품이라면 안 되고, 그 토글을 켜는 순간이 앱 심사가 시작되는 순간이에요.

앱 심사 없이 대규모로 읽기

공개 스레드 콘텐츠에 글을 올리는 게 아니라 읽는 게 일이라면, 공식 API는 잘못된 출발점이고 서드파티 스크래핑 API가 맞는 출발점이에요.

스레드만 다루는 간단한 선택지는 EnsembleData의 전용 스크래핑 API예요. 프로필, 게시물, 댓글, 검색, 해시태그 엔드포인트를 5초 안쪽 응답 속도로 주고, 메타 계정도 필요 없어요. 신경 쓰는 플랫폼이 스레드뿐이면 괜찮아요.

통합 선택지, 그리고 우리가 편애하는 쪽은, 스레드를 더 넓은 소셜 데이터 그래프 안의 한 플랫폼으로 다루는 거예요. SocialCrawl은 스레드 게시물, 프로필, 답글, 검색 결과를 레딧, X, 틱톡, 인스타그램, 유튜브를 비롯한 나머지 36개 플랫폼과 똑같은 JSON 봉투로 돌려줘요. 모든 응답이 success, platform, 그리고 content, author, engagement, metadata가 담긴 data 객체를 실어 오고, engagement_rate나 estimated_reach 같은 계산 필드까지 붙어요. 하나의 스키마로, 모든 플랫폼을요. 스레드, 레딧, X 사이의 담장이 API 층에서 사라져요.

경험칙은 이래요. 리서치 질문을 주당 키워드 500회로 답할 수 있으면 메타 API를 쓰세요. 주제, 지역, 언어, 경쟁사를 가로질러 들어야 하면 통합 API를 쓰세요. 둘 다 필요하면 둘 다 쓰면 돼요.

레딧, X, 틱톡과의 관계

쓸 만한 멘탈 모델은 스레드를 독립된 표면이 아니라 담장 두른 정원들을 잇는 다리의 한 노드로 보는 거예요. 플랫폼마다 저마다의 인증, 스키마, 레이트리밋을 가진 요새죠. 스레드, 레딧, X, 틱톡, 인스타그램, 유튜브와 나머지는 서로 대화하지 않아요. 그런데 여러분의 제품은 아마 그래야 하죠.

실전 패턴은 하나의 키워드나 대상에 대한 크로스 플랫폼 병렬 질의예요. 회의 직전 브리핑은 어떤 회사에 관한 참여도 상위 게시물을 스레드에서, 추천 1,500개짜리 r/webdev 레딧 스레드에서, 360만 조회 틱톡 영상에서, HN 최상단 댓글에서, 가장 많이 인용된 X 게시물에서 한 번의 API 호출로, 하나의 스키마로 끌어와요. 속보 모니터는 제품 출시의 첫 언급을 같은 다섯 표면에서 지켜보고요. AI 에이전트는 이 전부를 단일 MCP 도구로, 플랫폼마다 OAuth나 API 키를 저글링할 필요 없이 가져와요. npx -y socialcrawl-mcp 덕분이죠.

바로 이게 공식 API가 채우려 하지 않는 빈틈이에요. 메타는 스레드를 줘요. 나머지 34개 담장 두른 정원으로 이어지는 다리는 여전히 따로 필요하고요. 질문은 스레드 API를 쓸 것이냐가 아니에요. 그 둘레에 무엇을 둘 것이냐예요.

메타만 할 수 있는 일(게시, 계정 인사이트, 답글 관리)에는 메타 API를 쓰세요. 그 밖의 모든 것(읽기, 검색, 리스닝, 비교)에는 통합 멀티 플랫폼 API를 쓰세요. 둘 중 하나가 아니라, 둘 다요.

자주 묻는 질문

스레드 API는 무료인가요? 메타의 공식 스레드 API에는 공개된 유료 티어나 호출당 요금이 없어요. 진짜 비용은 달력 시간이에요. 모든 권한 스코프가 메타 앱 심사를 거쳐야 하고, 보통 스코프당 2~7 영업일에 1차 반려율도 높아요. 서드파티 스레드 API는 달러를 받는 대신 앱 심사를 건너뛰어요. EnsembleData는 무료(하루 50유닛)에서 월 약 1,400달러까지, Data365는 월 300파운드부터, SocialCrawl은 100크레딧이 딸린 $0부터예요.

페이스북이나 인스타그램 계정 없이 스레드 API를 쓸 수 있나요? 메타 개발자 계정은 필요한데, 아무 페이스북 로그인으로도 만들 수 있어요. 인스타그램 비즈니스 계정이나 연결된 페이스북 페이지는 없어도 돼요. 다만 게시하거나 읽으려는 사용자에 연결된 스레드 프로필은 있어야 해요.

스레드 API 액세스 토큰은 얼마나 오래 가나요? 단기 토큰은 1시간이면 만료돼요. 장기 토큰은 60일이고, 발급 후 24시간에서 60일 사이에 갱신할 수 있어요. 비공개 스레드 프로필 사용자가 준 권한은 토큰 상태와 상관없이 90일이 지나면 별개의 시계로 만료돼요.

키워드로 공개 스레드 게시물을 검색할 수 있나요? 네, threads_keyword_search 스코프가 있으면요. 다만 7일 롤링 기준 500회(하루 70회쯤)가 한계예요. 물량이 더 필요하면 서드파티 API는 메타의 이 상한에 배급받지 않아요.

스레드 API는 웹훅을 지원하나요? 네. 답글 이벤트용 실시간 웹훅이 2024년 10월에 추가됐고, 공개 멘션용 웹훅은 threads_manage_mentions 스코프와 함께 들어왔어요. 둘 다 폴링할 필요를 없애 주고, 둘 다 프로덕션 트래픽 전에 해당 스코프가 앱 심사를 통과해야 해요.