Name: TikTok Videos API: Profile Videos and Stats as JSON
Brand: benthepythondev
SKU: api-benthepythondev-tiktok-videos
Availability: InStock
Author: API Market

# TikTok Videos API

## Overview

The TikTok Videos API returns public TikTok videos and photo posts as JSON, from profiles or from single video links. Each row has the caption, date, author, music, video details and the play, like, share, comment, save and repost counts, with optional subtitle transcripts and comment rows.

It is built for social media analysts, marketers, agencies and researchers who track creators, competitors and campaigns on TikTok. Filter a profile's videos by date. No TikTok login is needed.

## Features

*   **Profiles and links**: a profile's newest videos, or single video links.
*   **Video stats**: plays, likes, shares, comments, saves and reposts.
*   **Transcripts**: TikTok's own subtitle text with `includeTranscript`.
*   **Comments**: optional comment and reply rows.
*   **Date filters**: `postedAfter` and `postedBefore` for profiles.
*   **Up to 20 rows per call**: fast synchronous responses.
*   **Rate limit**: up to 10 requests per second on every plan.

## Use Cases

*   **Creator analytics**: track a creator's posts and engagement.
*   **Competitor tracking**: follow a brand's TikTok account.
*   **Campaign reports**: collect stats for campaign videos.
*   **Research**: analyse captions and transcripts.

## API Documentation

### Base URL

All requests go through the API.market proxy at this base URL:

```
https://prod.api.market/api/v1/benthepythondev/tiktok-videos
```

### Authentication

Every request must include your API.market key in the `x-api-market-key` header:

```
x-api-market-key: YOUR_API_KEY
```

Replace `YOUR_API_KEY` with your actual API key.

### Endpoints

#### 1. Get videos

Returns videos for each profile or video link.

**Method:** `POST`

**Endpoint:** `/`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| profiles | body | Usernames, @handles or profile links (https://www.tiktok.com/@nasa). Each profile's videos and photo posts are read from the newest back, up to the maximum below; every row carries the account's bio, bio link and exact follower count. Hashtags and search terms cannot be read here. | array of strings | No | - | - |
| videoUrls | body | Links of single videos or photo posts (https://www.tiktok.com/@nasa/video/7692161454694206733), share links (vm.tiktok.com/…, tiktok.com/t/…) or bare video ids. Every link gives one row with the same columns as a profile's videos. Links of hashtag, search and music pages cannot be read here. | array of strings | No | - | - |
| maxResults | body | Videos to save for each profile, newest first. A request returns 20 rows at most. | integer | No | 20 | 20 |
| postedAfter | body | Only a profile's videos from this UTC day on (YYYY-MM-DD), or from a period back from now (7 days, 2 months). Not applied to video links. | string | No | - | - |
| postedBefore | body | Upper end of a date range (YYYY-MM-DD) for a profile's videos. Not applied to video links. | string | No | - | - |
| includeTranscript | body | Puts the text of TikTok's own subtitle track into the column transcript, for every video that has one. A video without a track (music, no speech, or not captioned by TikTok) keeps an empty column. This is TikTok's text, not speech recognition by the API. | boolean | No | false | - |
| commentsPerVideo | body | Comments to save for each video, as rows of their own after the video rows: text, author, likes, reply count, time. 0 reads no comments. The number counts comments and replies together. | integer | No | 0 | 100000 |
| maxRepliesPerComment | body | Replies to read under each comment that has some; they follow their comment and count towards the comments per video. 0 keeps to top-level comments. | integer | No | 0 | 5000 |

**Example Request:**

```bash
curl -X POST 'https://prod.api.market/api/v1/benthepythondev/tiktok-videos/' \
  -H 'x-api-market-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "profiles": [
    "nasa"
  ],
  "maxResults": 2
}'
```

**Example Response (200 OK):**

```json
[
  {
    "id": "7702504724049743117",
    "text": "Another week of building, flying, and looking ahead at NASA 🚀 🌔 Artemis III core stage integrated       🛰️ New solar array installed on the ISS       🪐 Send your name to Ti...",
    "textLanguage": "en",
    "createTime": 1793379164,
    "createTimeISO": "2026-10-30T16:52:44.000Z",
    "isAd": false,
    "locationCreated": null,
    "authorMeta": {
      "id": "7664638705177150477",
      "name": "nasa",
      "profileUrl": "https://www.tiktok.com/@nasa",
      "nickName": "NASA",
      "verified": true,
      "signature": "Making the seemingly impossible, possible.✨",
      "bioLink": "science.nasa.gov/feature/artemis-ii-preliminary-lunar-science-report",
      "avatar": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/e5143212a59c09a008bf50f487d54d1f~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=9640&refresh_token=b...",
      "privateAccount": false,
      "following": 23,
      "friends": 17,
      "fans": 2163404,
      "heart": 11558331,
      "video": 62,
      "digg": 0
    },
    "musicMeta": {
      "musicName": "original sound - NASA",
      "musicAuthor": "NASA",
      "musicOriginal": false,
      "coverMediumUrl": "https://p16-common.tiktokcdn-us.com/tos-useast5-avt-0068-tx/e5143212a59c09a008bf50f487d54d1f~tplv-tiktokx-cropcenter:200:200.jpeg?dr=9584&t=4d5b0474&ps=933b5bde...",
      "musicId": "7702504816472640270"
    },
    "webVideoUrl": "https://www.tiktok.com/@nasa/video/7702504724049743117",
    "videoMeta": {
      "height": 1280,
      "width": 720,
      "duration": 108,
      "coverUrl": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/o8e3EAJERS9f6tHYlgAMTQA5IAHqg8Dy6arDFC~tplv-tiktokx-origin.image?dr=9636&x-expires=1794250800&x-s...",
      "originalCoverUrl": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/ow1E1fMkSg2RDEcIA9wEAUBSyD5FIuJ5qTnenb~tplv-tiktokx-origin.image?dr=9636&x-expires=1794250800&x-s...",
      "definition": "720p",
      "format": "mp4",
      "subtitleLinks": [
        {
          "language": "eng-US",
          "tiktokLink": "https://v16m-webapp.tiktokcdn-us.com/52c55fca3b6aa329b5280e5655f8077a/6af2262d/video/tos/useast5/tos-useast5-v-0068-tx/9aedcabecf2441eebd37b2aa9e99dfc9/?a=1988&...",
          "source": "MT"
        }
      ]
    },
    "diggCount": 18100,
    "shareCount": 692,
    "playCount": 215200,
    "collectCount": 2084,
    "commentCount": 392,
    "repostCount": 0,
    "mentions": [],
    "hashtags": [],
    "isSlideshow": false,
    "slideshowImageLinks": [],
    "location": null,
    "transcript": null,
    "transcriptLanguage": null,
    "input": "nasa",
    "scrapedAt": "2026-11-07T19:57:53.705929+00:00"
  }
]
```

## Status Codes

| Code | Status | Description |
|---|---|---|
| 200 | OK | The request succeeded and the response body holds the result. |
| 400 | Bad Request | A required parameter is missing or a value is invalid. Check the parameter table for the endpoint. |
| 401 | Unauthorized | The `x-api-market-key` header is missing or the key is not valid. |
| 403 | Forbidden | Your key is valid but your subscription does not allow this request, for example an endpoint outside your plan. |
| 404 | Not Found | The path does not exist, or the resource you asked for was not found. |
| 429 | Too Many Requests | You sent more than 10 requests per second. Slow down and retry, honouring the `Retry-After` header. |
| 500 | Internal Server Error | Something went wrong while processing the request. Retry after a short wait. |
| 503 | Service Unavailable | The service or its upstream data source is temporarily unavailable. Retry with backoff. |

## Rate Limits

Every plan allows up to 10 requests per second. Subscription plans also have a monthly call quota shown on the pricing page. Sending more than 10 requests per second returns `429 Too Many Requests`. Throttle your client to stay under 10 requests per second, back off and retry when you get a 429, and honour the `Retry-After` header when it is present.

## FAQ

*   **Which inputs can I send?**

    Usernames, `@handles`, profile links, video links, share links or bare video IDs.

*   **Do I need a TikTok account?**

    No. It reads public videos only.

*   **How many results does one call return?**

    Up to 20 rows per call. Send another call with other input for more.

*   **How long does a call take?**

    Usually 3 to 15 seconds, and at most 60 seconds.

## Contact Us

If you have any questions or need assistance, you can reach out to us through the embedded chat on the bottom right corner of the page or send an email to hello@magicapi.com.


Get public TikTok videos by username or link as JSON, with captions, plays, likes, shares, comments, transcripts and dates.

TikTok Videos API: Profile Videos and Stats as JSON

Free trial