Get TikTok User Info by TikTok User ID

When you already hold a numeric TikTok user ID, this endpoint fetches the matching account without a handle lookup first. It returns the same profile record as the username version, covering display name, avatar, bio, verification status, region and the follower, following and like counts. That makes it the right call for stored IDs, which stay resolvable even after a creator renames their account.

Try on Playground

PrimeApi Endpoints > User Endpoints > User Info by ID

Endpoint Info

Request Method

GET

Request URL

https://api.primeapi.co/userinfo-by-id?userid={userid}

Required Parameters

userid

Request Examples

Request Flow

User Info by ID is a single GET call to /userinfo-by-id, and userid has to travel with it in the query string. Swap YOUR_API_KEY for your own key and both snippets below run as they are.

Authentication

Header based. Send X-PrimeAPI-Key with every request — there is no OAuth handshake and no token to refresh.

Credits

One User Info by ID call costs 1 credit. Your remaining balance comes back on every response in the X-PrimeAPI-Balance header, so you can watch usage without a second lookup.

cURL

curl -X GET "https://api.primeapi.co/userinfo-by-id?userid=107955" \
  -H "X-PrimeAPI-Key: YOUR_API_KEY"

Python - Requests

import requests

url = "https://api.primeapi.co/userinfo-by-id?userid=107955"
headers = {"X-PrimeAPI-Key": "YOUR_API_KEY"}

response = requests.get(url, headers=headers)

print(response.json())
print("Credits left:", response.headers.get("X-PrimeAPI-Balance"))

Endpoint Response

Example URL

https://api.primeapi.co/userinfo-by-id?userid=107955

Content Type

JSON

Example Response

{
    "extra": {
        "fatal_item_ids": [],
        "logid": "202501170029453A54DCCA1CCEB217462D",
        "now": 1737073786000
    },
    "log_pb": {
        "impr_id": "202501170029453A54DCCA1CCEB217462D"
    },
    "status_code": 0,
    "status_msg": "",
    "user": {
        "account_type": 3,
        "avatar_300x300": {
            "uri": "tos-useast5-avt-0068-tx/ba67b11de451691939223e9d978e613a",
            "url_list": [
                "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a~c5_300x300.webp?lk3s=a5d48078&nonce=38419&refresh_token=16e48632d7819386f29c4ae0a851093d&x-expires=1737244800&x-signature=HaHsfG20RSg6IRDBZLCLIvWauTM%3D&shp=a5d48078&shcp=74c58a1a",
                "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a~c5_300x300.jpeg?lk3s=a5d48078&nonce=32236&refresh_token=2d48e6b9288a4d83589cadc754fd44d6&x-expires=1737244800&x-signature=KYPLhoQ7eD%2BeOjhncnoXAy0QM7M%3D&shp=a5d48078&shcp=74c58a1a"
            ],
            "url_prefix": null
        },
        "avatar_larger": {
            "uri": "tos-useast5-avt-0068-tx/ba67b11de451691939223e9d978e613a",
            "url_list": [
                "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a~c5_1080x1080.webp?lk3s=a5d48078&nonce=3326&refresh_token=2c2283256920f5e2bfc8174503fa7480&x-expires=1737244800&x-signature=YRucKMUlomUP3bOhE2vRc6qLBio%3D&shp=a5d48078&shcp=74c58a1a",
                "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a~c5_1080x1080.jpeg?lk3s=a5d48078&nonce=73954&refresh_token=c1844493c53a39c3db03b22060808944&x-expires=1737244800&x-signature=otY%2BV8QldcDUnhYrthyFzgxzy48%3D&shp=a5d48078&shcp=74c58a1a"
            ],
            "url_prefix": null
        },
        "avatar_medium": {
            "uri": "tos-useast5-avt-0068-tx/ba67b11de451691939223e9d978e613a",
            "url_list": [
                "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a~c5_720x720.webp?lk3s=a5d48078&nonce=51401&refresh_token=de437a848769fcc09b966381d71423d6&x-expires=1737244800&x-signature=MNhHY3GnwRYubn%2Faz8ht91TGN88%3D&shp=a5d48078&shcp=74c58a1a",
  ... (truncated)

Show full response

Related Endpoints

More TikTok User Endpoints

Get TikTok User Info by Username Get TikTok User Followers Get TikTok User Following Get TikTok User Posts Get TikTok User Liked Posts Get TikTok User Playlist Get TikTok User Repost Get TikTok User Popular Posts Get TikTok User Oldest Posts

View all User Endpoints

Contact

You can contact us via Telegram or Gmail

@primeapi_co

Gmail

primeapico@gmail