SOCIAL MEDIA

TikTok Get User Profile API

Get full user profile (bio, stats, verified status) via SSR scraping. No auth needed.

tiktokuserprofilescrapingsocial

How to call it

Send one POST to api.upapi.io/tiktok-get-user-profile.post with your key in the X-Api-Key header and the parameters below as a JSON body. Each call spends 15 weighted units of your monthly quota. The operation times out after 30 seconds. Identical requests are served from cache for 600 seconds, unbilled.

endpoint

POST https://api.upapi.io/tiktok-get-user-profile.post

TikTok Get User Profile API reference

Request parameters

proxyUrl: string — Optional proxy URL
username: stringrequired — TikTok username (without @)

Response fields

bio: stringrequired
likes: integerrequired
secUid: stringrequired
success: booleanrequired
nickname: stringrequired
username: stringrequired
verified: booleanrequired
avatarUrl: string
elapsedMs: integerrequired
fetchedAt: stringrequired
followers: integerrequired
following: integerrequired
videoCount: integerrequired
privateAccount: booleanrequired

Example request and response

The example response is generated from this operation’s published output schema — it shows the shape and field names, not values from a recorded call.

json — example request body

{
  "username": "torvalds"
}

json — example response shape

{
  "bio": "example",
  "likes": 1,
  "secUid": "example",
  "success": false,
  "nickname": "example",
  "username": "torvalds",
  "verified": false,
  "avatarUrl": "example",
  "elapsedMs": 1,
  "fetchedAt": "example",
  "followers": 1,
  "following": 1,
  "videoCount": 1,
  "privateAccount": false
}

Code snippets

cURL

curl

curl -X POST https://api.upapi.io/tiktok-get-user-profile.post \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{ "username": "torvalds" }'

JavaScript

javascript

const response = await fetch('https://api.upapi.io/tiktok-get-user-profile.post', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': 'YOUR_API_KEY',
  },
  body: JSON.stringify({
  "username": "torvalds"
}),
});

const data = await response.json();
console.log(data);

Python

python

import requests

response = requests.post(
    'https://api.upapi.io/tiktok-get-user-profile.post',
    headers={
        'Content-Type': 'application/json',
        'x-api-key': 'YOUR_API_KEY',
    },
    json={
  "username": "torvalds"
},
)

print(response.json())

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"io"
	"net/http"
)

func main() {
	payload := []byte(`{ "username": "torvalds" }`)

	req, _ := http.NewRequest("POST", "https://api.upapi.io/tiktok-get-user-profile.post", bytes.NewBuffer(payload))
	req.Header.Set("Content-Type", "application/json")
	req.Header.Set("x-api-key", "YOUR_API_KEY")

	client := &http.Client{}
	resp, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	body, _ := io.ReadAll(resp.Body)
	var result map[string]any
	json.Unmarshal(body, &result)
	fmt.Println(result)
}

PHP

php

<?php

$payload = json_encode([
    'username' => 'torvalds',
]);

$ch = curl_init('https://api.upapi.io/tiktok-get-user-profile.post');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => $payload,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        'Content-Type: application/json',
        'x-api-key: YOUR_API_KEY',
    ],
]);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
var_dump($data);

Ruby

ruby

require 'net/http'
require 'uri'
require 'json'

uri = URI('https://api.upapi.io/tiktok-get-user-profile.post')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == 'https'

request = Net::HTTP::Post.new(uri.path)
request['Content-Type'] = 'application/json'
request['x-api-key'] = 'YOUR_API_KEY'
request.body = { "username": "torvalds" }.to_json

response = http.request(request)
puts JSON.parse(response.body)

Java

java

import okhttp3.*;
import com.fasterxml.jackson.databind.ObjectMapper;
import java.util.Map;

OkHttpClient client = new OkHttpClient();
ObjectMapper mapper = new ObjectMapper();

String json = "{ \"username\": \"torvalds\" }";

RequestBody body = RequestBody.create(json, MediaType.get("application/json"));
Request request = new Request.Builder()
    .url("https://api.upapi.io/tiktok-get-user-profile.post")
    .post(body)
    .addHeader("Content-Type", "application/json")
    .addHeader("x-api-key", "YOUR_API_KEY")
    .build();

try (Response response = client.newCall(request).execute()) {
    Map<?, ?> result = mapper.readValue(response.body().string(), Map.class);
    System.out.println(result);
}

csharp

using System.Net.Http;
using System.Net.Http.Json;
using System.Text.Json;

using var client = new HttpClient();
client.DefaultRequestHeaders.Add("x-api-key", "YOUR_API_KEY");

var payload = JsonSerializer.Deserialize<object>("{ \"username\": \"torvalds\" }");
var response = await client.PostAsJsonAsync("https://api.upapi.io/tiktok-get-user-profile.post", payload);

var result = await response.Content.ReadFromJsonAsync<JsonElement>();
Console.WriteLine(result);

Frequently asked questions

How much does the TikTok Get User Profile API cost per call?

Each call spends 15 weighted units of your plan's monthly quota. Full pricing is at https://upapi.io/pricing.

How do I authenticate to the TikTok Get User Profile API?

Send your key in the X-Api-Key header. A free guest key is available without creating an account.

Are TikTok Get User Profile API responses cached?

Yes — identical requests are served from cache for 600 seconds, and a cache hit is not billed.

More Social Media APIs

TikTok Get Video By Id TikTok Get Video Detail TikTok Get Comment Replies TikTok Get Comments TikTok oEmbed Lookup TikTok Discover Users from Comments TikTok Check Account Health Instagram Get User By Id

Browse every Social Media API →