X Tweet Transcript API
API 한 번의 호출로 X Tweet Transcript 데이터를 받아 가세요. Returns the spoken words from a video attached to a tweet, auto-generated captions included. Costs 10 credits per call, the most expensive endpoint on this platform: `twitter/tweet` returns the media attachment itself for 1 credit, and this returns what is said in it. A tweet with no video, or a video with no speech, is a 404 with `error.details.reason: no_captions` and is not charged, because X answers those two identically. Videos up to 10 minutes (600 seconds) are supported; a longer one returns 400 INVALID_REQUEST with `error.details.reason: video_too_long` and `max_seconds`, also free. Every one of these outcomes is deterministic, so retrying returns the same answer.
2026년 10월 업데이트SocialCrawl 팀이 직접 관리해요
트윗에 붙은 영상의 대본을 돌려줍니다. 자동 생성 자막도 들어갑니다.
트윗에 영상이 있고 무슨 말을 했는지 필요할 때 사용하세요. tweet은 첨부 미디어까지만 주고 발화 내용은 주지 않습니다.
68개 플랫폼을 병렬로 검색합니다
Tweet Transcript API로 무엇을 할 수 있을까요
Tweet Transcript 엔드포인트가 통합 스키마와 계산 필드를 담은 X 데이터를 한 번의 요청으로 보내드려요. 스크래핑 인프라를 직접 만들거나 유지할 필요가 없어요.
요청 예시
curl -H "x-api-key: YOUR_API_KEY" \
"https://www.socialcrawl.dev/v1/twitter/tweet/transcript?url=https%3A%2F%2Fx.com%2FTheoVon%2Fstatus%2F1916982720317821050"import requests
response = requests.get(
"https://www.socialcrawl.dev/v1/twitter/tweet/transcript",
params={
'url': 'https://x.com/TheoVon/status/1916982720317821050',
},
headers={"x-api-key": "YOUR_API_KEY"},
)
data = response.json()const response = await fetch(
"https://www.socialcrawl.dev/v1/twitter/tweet/transcript?url=https%3A%2F%2Fx.com%2FTheoVon%2Fstatus%2F1916982720317821050",
{
headers: { "x-api-key": "YOUR_API_KEY" },
},
);
const data = await response.json();파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
| url | 예 | Full URL of the tweet containing a video |
X Tweet Transcript API는 무엇을 돌려주나요
모든 응답은 하나의 통합 스키마를 따라요. 크레딧을 쓰기 전에 어떤 필드가 돌아오는지, 실제 응답 본문 그대로 확인해 보세요.
응답 예시 보기
{
"success": true,
"platform": "twitter",
"endpoint": "/v1/twitter/tweet/transcript",
"data": {
"transcript": "Since you're kind of like a leader in innovation and technology in our world, you know? Um, do you How do you know that what your convictions are, how do you gauge if what your convictions are are the best for everybody? Kind of like, how do you kind of figure that out, you know? It seems like such a challenge. I mean, look, at the end of the day, um, there's still a lot of options of things that people can do. Just because I build something doesn't mean that people are going to use it. Actually a lot of the things that I build like some some of them work, some of them don't and like, I think part of the reason why the company has been successful is because, you know, maybe we have a slightly higher hit rate of things working than others. But if we do something that doesn't work, then in general, people aren't going to use it and then the future doesn't go in that direction. So, I see, so you're saying it's up to the user more. Yeah, I mean, look, it's always served me well to generally have faith in people and believe that people are smart and can make good decisions for themselves. And whenever we try to like adopt some sort of like attitude of, \"Oh, we must know better than them.\" It's like, we're like, we're the people building technology, that's when you lose. So I I I tend to just think that at the end of the day, yeah, I mean, I think people are smarter than than a lot of people think, and I think ultimately drive the direction that society goes in."
},
"credits_used": 0,
"request_id": "req_example000000",
"cached": true,
"credits_remaining": 9999,
"source": "captured",
"captured_at": "2026-10-02T12:52:23.126Z",
"redacted": true
}통합 응답 구조를 보여 주는 실제 샘플이에요. 필드 값은 조회한 대상에 따라 달라져요.
X Tweet Transcript API는 어떻게 동작하나요
API 키와 함께 GET 요청을 보내면, 통합 스키마와 계산 필드를 담은 깔끔한 JSON이 돌아와요.
메서드
GET
응답 형식
JSON
소셜 미디어 데이터를 몇 초 만에 수집하는 방법
개발자를 위한 가장 빠른 소셜 미디어 스크래핑 API. 월간 활성 사용자 100억 명 이상을 포괄하는 68개 플랫폼에서 프로필, 게시물, 댓글, 분석 데이터를 수집하세요.
모든 플랫폼을 하나의 스키마로
동일한 응답 구조로 68개 플랫폼을 조회하세요. 연동은 한 번이면 충분합니다.
단순 수집을 넘어 계산된 필드 제공
엔드포인트가 해당 지표를 지원하고 계산에 필요한 원본 값이 있을 때, 정규화된 레코드에 engagement_rate, estimated_reach, content_category, language를 함께 담아 바로 활용할 수 있습니다.
코드 한 줄 쓰기 전에, 데이터부터
Visual Data Explorer에 URL만 붙여넣으면 결과 카드와 정형화된 테이블, CSV 내보내기를 바로 사용할 수 있습니다.
import requests
response = requests.get(
'https://www.socialcrawl.dev/v1/tiktok/profile',
params={'handle': 'charlidamelio'},
headers={'x-api-key': 'sc_YOUR_API_KEY'}
)
data = response.json(){
"success": true,
"platform": "tiktok",
"data": {
"author": {
"username": "charlidamelio",
"followers": 152400000
},
"engagement": {
"likes": 12400000000,
"engagement_rate": 0.087
},
"metadata": {
"language": "en",
"content_category": "lifestyle"
}
}
}자주 묻는 질문
API, 요금제, 기능에 대한 질문과 답변입니다.
문의하기트윗 영상 자막은 어떻게 받나요?
어떤 트윗에서 자막을 받을 수 있나요?
트윗 자막 하나에 크레딧은 얼마나 드나요?
자막에 타임코드도 포함되나요?
자막은 어떤 언어로 오나요?
AI에게 SocialCrawl을 물어보세요
X Tweet Transcript 데이터, 가져올 준비 되셨어요?
API 키 받고 60초 안에 X 데이터를 받아 가세요.
