# TikTok Post API Beta Returns a public TikTok video or photo post: caption, hashtags, tagged accounts, author, publish time, a cookie-free video link or every slideshow photo, cover, sound, tagged place, ad and AI labels, and view, like, comment, share and save counts, from a post or share link or a numeric ID. [Get 100 free credits](https://staging.socialtap.dev/signup/?next=%2Fplayground%2F%3Fendpoint%3Dtiktok.post) · [API reference](https://staging.socialtap.dev/docs/reference/tiktok/post/index.md) · [Try it](https://staging.socialtap.dev/playground/?endpoint=tiktok.post) - **Price**: From **1 credit** per request$0.75–$1.45 per 1,000 requests - **Request**: `GET /v1/tiktok/post`One API key, one JSON schema - **Input**: `url`e.g. `https://www.tiktok.com/@niinoclock/video/7673108027645414678` - **Failed requests**: Free: 0 credits Use cases ## What teams build with it. From one request. - Track engagement on creator and brand videos - Monitor competitors' campaigns and ads - Collect captions, hashtags and sounds for trend research What you get ## Posts in one schema. The same on every platform. - **`platform`string**: Platform ID (tiktok, youtube, …). - **`id`string**: Platform-native post ID (string; Instagram shortcode, Reddit without t3_). - **`url`string**: Canonical post URL. - **`type`string**: Normalized content shape. New values may be added; treat unknown values as other. - **`platform_type`string**: The platform's own product label, lowercase (reel, short, story, live, tweet, …). - **`title`string**: Headline (YouTube title, Reddit title); null on caption-only platforms. - **`text`string**: Caption, description or body as plain text. - **`language`string**: BCP-47 language of text, when the platform states it. Every field, its type and when it is `null`: [the response reference](https://staging.socialtap.dev/docs/reference/tiktok/post/index.md#response) and the [post schema](https://staging.socialtap.dev/resources/post/index.md). ## Example request cURL: ```shell curl -G 'https://staging.socialtap.dev/v1/tiktok/post' \ --data-urlencode 'url=https://www.tiktok.com/@scout2015/video/6718335390845095173' \ -H "x-api-key: $SOCIALTAP_API_KEY" ``` Node.js: ```javascript const params = new URLSearchParams({ url: "https://www.tiktok.com/@scout2015/video/6718335390845095173", }); const res = await fetch(`https://staging.socialtap.dev/v1/tiktok/post?${params}`, { headers: { "x-api-key": process.env.SOCIALTAP_API_KEY ?? "" }, }); const body = await res.json(); if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`); const { data, meta } = body; console.log(data, meta.credits_charged); ``` Python: ```python import os import requests res = requests.get( "https://staging.socialtap.dev/v1/tiktok/post", params={"url": "https://www.tiktok.com/@scout2015/video/6718335390845095173"}, headers={"x-api-key": os.environ["SOCIALTAP_API_KEY"]}, ) body = res.json() if not res.ok: raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}") data, meta = body["data"], body["meta"] print(data, meta["credits_charged"]) ``` Go: ```go package main import ( "encoding/json" "fmt" "log" "net/http" "net/url" "os" ) func main() { q := url.Values{} q.Set("url", "https://www.tiktok.com/@scout2015/video/6718335390845095173") req, err := http.NewRequest("GET", "https://staging.socialtap.dev/v1/tiktok/post?"+q.Encode(), nil) if err != nil { log.Fatal(err) } req.Header.Set("x-api-key", os.Getenv("SOCIALTAP_API_KEY")) res, err := http.DefaultClient.Do(req) if err != nil { log.Fatal(err) } defer res.Body.Close() var body struct { Data json.RawMessage `json:"data"` Meta map[string]any `json:"meta"` Error *struct { Code string `json:"code"` Message string `json:"message"` } `json:"error"` } if err := json.NewDecoder(res.Body).Decode(&body); err != nil { log.Fatal(err) } if body.Error != nil { log.Fatalf("%s: %s", body.Error.Code, body.Error.Message) } fmt.Println(string(body.Data), body.Meta["credits_charged"]) } ``` 200 OK: ```json { "data": { "approximate_fields": [ "duration_ms", "media[].duration_ms", "metrics.view_count" ], "author": { "avatar_url": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/4cbe05e194623e3f19aef975d9fdf26c~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=9640&refresh_token=1a7ec680&x-expires=4070908800&x-signature=SCRUBBED&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5", "display_name": "Scout, Suki & Stella", "id": "53279706535428096", "is_verified": true, "url": "https://www.tiktok.com/@scout2015", "username": "scout2015" }, "coauthors": [], "duration_ms": 10000, "hashtags": [ "foryoupage", "petsoftiktok", "aesthetic" ], "id": "6718335390845095173", "is_nsfw": false, "is_pinned": null, "is_sponsored": null, "language": "en", "media": [ { "alt_text": null, "duration_ms": 10000, "expires_at": "2026-10-25T18:00:00Z", "height": 1024, "thumbnail_url": "https://p19-common-sign.tiktokcdn-us.com/tos-maliva-p-0068/2367c7d45cf54a1397abd0e72bf22eac~tplv-tiktokx-origin.image?dr=9636&x-expires=4070908800&x-signature=SCRUBBED&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5", "type": "video", "url": "https://v19.tiktokcdn-us.com/SCRUBBED/f2a52380/video/tos/useast5/tos-useast5-ve-0068c002-tx/15fbafb086324317bf77a649580b1f95/?a=1233&bti=ODszNWYuMDE6&&bt=2389&ft=aEKfuqT0mIoPD12Qd0iI3wUM0_AbMeF~O5&mime_type=video_mp4&rc=ODw1Z2gzZ2Q1ODo4aGdnZUBpM245aWhvZ3U4bjMzZzczM0AzNWA1MWJiNWEx…", "width": 576 } ], "mentions": [], "metrics": { "comment_count": 5716, "like_count": 35200, "quote_count": null, "repost_count": null, "save_count": 649, "share_count": 1518, "view_count": 159700 }, "platform": "tiktok", "platform_specific": { "tiktok": { "author_sec_uid": "MS4wLjABAAAAPZWNdkF_cmVSPCvV0Y6MCsH29mlAOlMOX3ikzGvlfMm3K6OMZv-JrRImpEHxdIMI", "country_code": "US", "is_ad": false, "is_ai_generated": false, "location": null, "music": { "author_name": "tiff", "cover_url": "https://p19-common-sign.tiktokcdn-us.com/tos-maliva-avt-0068/62c59c8c91226b51c36d2338519eb63e~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=9640&refresh_token=ae9b518c&x-expires=4070908800&x-signature=SCRUBBED&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5", "duration_ms": 10000, "id": "6689804660171082501", "is_original": true, "play_url": "https://v19.tiktokcdn-us.com/SCRUBBED/f2a52380/video/tos/useast5/tos-useast5-v-27dcd7-tx/fdec9588d6684e7d97da29739b9d0abf/?a=1233&bti=ODszNWYuMDE6&&bt=125&ft=GSDrKInz7ThMDnRGXq8Zmo&mime_type=audio_mpeg&rc=am48ZmQ6ZnFxNzMzNzU8M0Bpam48ZmQ6ZnFxNzMzNzU8M0BpNWRhcjRfaGBgLS1kMTZzYSNpNWR…", "title": "original sound" } } }, "platform_type": "video", "published_at": "2019-07-27T13:32:38Z", "text": "Scramble up ur name & I’ll try to guess it😍❤️ #foryoupage #petsoftiktok #aesthetic", "thumbnail_url": "https://p19-common-sign.tiktokcdn-us.com/tos-maliva-p-0068/2367c7d45cf54a1397abd0e72bf22eac~tplv-tiktokx-origin.image?dr=9636&x-expires=4070908800&x-signature=SCRUBBED&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5", "title": null, "type": "video", "unknown_fields": [ "coauthors" ], "url": "https://www.tiktok.com/@scout2015/video/6718335390845095173" }, "meta": { "request_id": "req_3f9c2a7d1e8b4c6a9f0e2d4b6a8c0e1f", "platform": "tiktok", "source": "page", "is_cached": false, "credits_charged": 1, "latency_ms": 0, "fetched_at": "2026-10-25T12:00:00Z", "input": { "kind": "video", "id": "6718335390845095173", "url": "https://www.tiktok.com/@scout2015/video/6718335390845095173" }, "credits_remaining": 9999, "client_request_id": null, "warnings": [], "mode": "live" } } ``` Long arrays and strings are shortened for display; real responses are complete. > [!NOTE] > > **Good to know** > > - TikTok rounds large like and view counts (see approximate_fields); comments, shares and saves are exact. > - If the video page fails, the embed page answers without saves, language, location, AI label and sound length (partial_data warning). > - is_sponsored marks TikTok ads only (else null): paid partnerships are not public. Pricing ## Pay per request. Only when it succeeds. | Source | Price per successful request | Per 1,000 requests | | --- | --- | --- | | Public page `page` | 1 credit | $0.75–$1.45 | - Failed requests are free: errors cost 0 credits. - Cache hits are free: responses served from the cache cost 0 credits. - Credits never expire. - One credit balance for every endpoint and platform. [Credit packs](https://staging.socialtap.dev/pricing/index.md) · [How this endpoint is priced](https://staging.socialtap.dev/docs/reference/tiktok/post/index.md#pricing) · [How credits work](https://staging.socialtap.dev/docs/credits/index.md) FAQ ## Questions, answered. **How much does the TikTok Post API cost?** 1 credit for public page results (meta.source = page), charged only for successful requests. SocialTap credits cost $0.75–$1.45 per 1,000 depending on the pack. **Am I charged for failed requests?** No. Requests that return an error cost 0 credits. Responses served from the cache are free too. Same schema, other platforms ## Posts everywhere. One parser. [Instagram Post APIBetaPost`GET /v1/instagram/post`1 credit](https://staging.socialtap.dev/apis/instagram/post/index.md) · [TikTok Posts APIBetaPost`GET /v1/tiktok/posts`1 credit / page](https://staging.socialtap.dev/apis/tiktok/posts/index.md) · [YouTube Video APIBetaPost`GET /v1/youtube/post`1 credit](https://staging.socialtap.dev/apis/youtube/post/index.md) · [YouTube Channel Videos APIBetaPost`GET /v1/youtube/posts`1 credit / page](https://staging.socialtap.dev/apis/youtube/posts/index.md) More TikTok ## TikTok API. 5 endpoints, one key. [TikTok Comments APIBetaComment`GET /v1/tiktok/comments`1 credit / page](https://staging.socialtap.dev/apis/tiktok/comments/index.md) · [TikTok Posts APIBetaPost`GET /v1/tiktok/posts`1 credit / page](https://staging.socialtap.dev/apis/tiktok/posts/index.md) · [TikTok Profile APIBetaProfile`GET /v1/tiktok/profile`1 credit](https://staging.socialtap.dev/apis/tiktok/profile/index.md) · [TikTok Transcript APIBetaTranscript`GET /v1/tiktok/transcript`From 1 credit](https://staging.socialtap.dev/apis/tiktok/transcript/index.md) ## Start with 100 free credits. No card required. Test keys answer every endpoint from recorded responses, free, so you can build before you spend. Failed requests are always free. [Get your API key](https://staging.socialtap.dev/signup/?next=%2Fplayground%2F%3Fendpoint%3Dtiktok.post) · [Read the API reference](https://staging.socialtap.dev/docs/reference/tiktok/post/index.md) --- [HTML version](https://staging.socialtap.dev/apis/tiktok/post/) · [Docs index for AI agents](https://staging.socialtap.dev/llms.txt) · [All docs in one file](https://staging.socialtap.dev/llms-full.txt)