Search Profile by Username

Extract TikTok user profile metadata, follower counts, total likes, and bio description.

Endpoint Technical Specifications

This endpoint provides standardized JSON payload extractions with built-in proxy rotation and automatic rate-limit management. Designed for seamless integration into real-time analytics pipelines.

Authentication Required

Get API Key

All requests to this endpoint must include a valid API Bearer Token in the HTTP Authorization header. You can generate and manage your active secret keys directly from your developer dashboard.

Header:Authorization: Bearer YOUR_API_KEY

Request Parameters & Query Payload

Parameter	Type	Status	Description
username	string	Required	TikTok handle/username

Quick Start Code Snippet

curl -X GET "https://api.socioapi.com/api/v1/tiktok/profile-username?username=creator_account" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response Schema (200 OK)

JSON Payload

{
  "success": true,
  "status_code": 200,
  "message": "Success Retrieve Data..",
  "time": {
    "value": "15.845 ms",
    "setTimeBeforeActions": true
  },
  "meta_info": {
    "billing": {
      "plan_type": "CREDIT",
      "plan_name": "Starter",
      "remaining_credits": 9876,
      "credits_charged": 1
    },
    "log": {
      "ip": "114.124.211.178"
    }
  },
  "data": [
    {
      "id": "tiktok_dq8xcefdatc",
      "platform": "tiktok",
      "endpoint_path": "/api/v1/tiktok/profile-username",
      "type": "GET",
      "author": "creator_sample",
      "text": "Sample real-time data extraction response for Search Profile by Username",
      "created_at": "2026-03-01T19:03:00+07:00",
      "metrics": {
        "views": 450200,
        "likes": 38200,
        "shares": 4120,
        "comments": 1530
      }
    }
  ],
  "pagination": {
    "current_page": 1,
    "page_size": 10,
    "total_items": 45,
    "total_pages": 5
  }
}

Practical Mini Use Case

Real-World Application: Brand Reputation & Market Research

Integrate this specific endpoint into your automated monitoring pipelines to track customer sentiment shifts, detect emerging viral product trends early, and compile comprehensive competitor intelligence reports without manual intervention.

Workflow Continuity

More Related Endpoints in TIKTOK

GET/tiktok/posts-keyword

Search Videos/Posts by Keyword

Search list of TikTok videos based on target keyword within a specified date window.

Explore Endpoint

Endpoint FAQ & Error Handling

Frequently Asked Questions

What are the rate limit restrictions?

Standard keys support up to 60 requests per minute. Exceeding this threshold returns a 429 status response.

How does IP proxy rotation work?

Our gateway automatically routes requests through residential proxy pools to prevent origin server blocks.

How to handle timeout errors?

Implement exponential backoff retry logic in your client code for requests taking longer than 10 seconds.

Ready to integrate this endpoint?

Register your developer account to get your production API key or test queries live right inside our interactive playground console.

View Docs Test in Playground