Post
TikTok 영상 하나를 가져옵니다.
GET | POST /v1/tiktok/post파라미터는 GET의 쿼리 문자열로도, POST의 JSON 본문으로도 보낼 수 있습니다. 둘은 같습니다.
넘길 값
| 넘기는 값 | 읽는 것 | 비고 |
|---|---|---|
id | 영상 | 숫자 id, URL 또는 공유 링크 |
호출마다 소스는 하나만 넘기세요. 모든 식별자는 페이지 URL도 받습니다.
파라미터
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
id | string | Numeric video id, or the video URL / share link (vm.tiktok.com/…). |
요청
curl "https://gateway.apinoa.com/v1/tiktok/post?id=7698770783367171359" \
-H "x-api-key: $APINOA_API_KEY"응답
data에 Post를 돌려줍니다. 실제 응답을 줄인 것입니다. 배열은 앞쪽 항목만 남기고 긴 텍스트는 잘랐습니다.
{
"success": true,
"data": {
"platform": "tiktok",
"id": "7698770783367171359",
"url": "https://www.tiktok.com/@tiktok/video/769877078336…",
"author": {
"platform": "tiktok",
"id": "107955",
"handle": "tiktok",
"displayName": "TikTok",
"url": "https://www.tiktok.com/@tiktok",
"avatarUrl": "https://p19-common-sign.tiktokcdn-us.com/tos-usea…",
"verified": true,
"counts": {
"followers": 96400000,
"following": 1,
"posts": 1512
},
"ext": {
"secUid": "MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBS…",
"signature": "Your next discovery is waiting on TikTok.",
"totalLikes": 466000000,
"likesGiven": 4377
}
},
"text": "The throwback sounds we didn’t know we were missi…",
"createdAt": "2026-10-20T15:23:03.000Z",
"lang": "en",
"media": [
{
"type": "video",
"url": "https://www.tiktok.com/aweme/v1/play/?faid=1988&f…",
"width": 720,
"height": 1280,
"thumbnailUrl": "https://p16-common-sign.tiktokcdn-us.com/tos-usea…",
"durationSec": 105,
"variants": [
{
"url": "https://www.tiktok.com/aweme/v1/play/?faid=1988&f…",
"width": 720,
"height": 1280,
"bitrate": 1710350,
"contentType": "video/mp4"
}
],
"ext": {
"playAddr": "https://v16-webapp-prime.us.tiktok.com/video/tos/…",
"downloadAddr": "https://v16-webapp-prime.us.tiktok.com/video/tos/…",
"dynamicCover": "https://p19-common-sign.tiktokcdn-us.com/tos-usea…",
"definition": "720p",
"videoQuality": "normal",
"ratio": "720p",
"codec": "h264",
"format": "mp4",
"bitrate": 1710350,
"sizeBytes": 22592237,
"loudness": -23.6,
"peak": 0.53703,
"hasOriginalAudio": true,
"autoCaption": true,
"bitrateVariants": [
{
"gearName": "normal_720_0",
"fps": 30,
"codec": "h264",
"sizeBytes": 22592237
}
],
"subtitles": [
{
"lang": "eng-US",
"langId": "2",
"url": "https://v16m-webapp.tiktokcdn-us.com/33b86e5d3f3c…",
"format": "webvtt",
"source": "ASR"
}
]
}
}
],
"metrics": {
"likes": 5229,
"comments": 1640,
"shares": 503,
"views": 351700,
"reposts": 0,
"saves": 450
},
"entities": {
"mentions": [
{
"handle": "adambarrera",
"id": "6707847482024723461"
}
]
},
"audio": {
"id": "7698770883132853023",
"title": "original sound",
"artist": "TikTok",
"url": "https://v16m.tiktokcdn-us.com/c8470014c6bdd52cea2…"
},
"ext": {
"music": {
"original": true,
"coverUrl": "https://p19-common-sign.tiktokcdn-us.com/tos-usea…",
"durationSec": 105,
"isCommerceMusic": true
},
"duetEnabled": true,
"stitchEnabled": true,
"diversificationLabels": [
"Music"
],
"locationCreated": "US",
"suggestedWords": [
"nostalgia sounds"
]
}
}
}에러
| 상태 | 코드 | 의미 |
|---|---|---|
| 400 | INVALID_PARAMS | 파라미터가 없거나, 알 수 없거나, 범위를 벗어났습니다. 메시지에 이름이 나옵니다. |
| 401 | UNAUTHORIZED | x-api-key 헤더가 없거나, 폐기되었거나 알 수 없는 키입니다. |
| 402 | INSUFFICIENT_BALANCE | 잔액이 이 호출 비용에 모자랍니다. 대시보드에서 충전하세요. |
| 404 | NOT_FOUND | 계정·게시물·그룹이 없거나, 비공개·삭제·연령 제한 상태입니다. |
| 429 | MARKETPLACE_SATURATED | 동시 호출이 너무 많습니다. Retry-After 초만큼 기다린 뒤 다시 시도하세요. |
| 502 | UPSTREAM_ERROR | 플랫폼이 쓸 수 없는 응답을 보냈습니다. 간격을 두고 다시 시도하세요. |
모든 코드는 Errors에 있습니다. 실패한 호출은 과금되지 않습니다.
가격
가격 호출당 $0.001. 정가 기준이며, 하루 1,000회를 넘으면 단가가 내려갑니다.