You inherit a TikTok shortlist containing usernames in some rows and secUid values in others. Supplying every value together may obscure which account the lookup actually targets. Understand the precedence before updating records.

Choose the identity basis deliberately

The contract requires at least one identifier and prioritizes the username from the profile URL. Providing both does not establish that the service checks whether they match. Preserve each original source, use a clear lookup basis, and investigate conflicting references separately.

Record only available personal information

Inspect the actual profile response before selecting fields. A biography's language does not establish nationality, and a display name is not verified legal identity. Date observations and retain differences from older records so later reviewers can understand changes.

Move to content review as a separate task

After matching the account, inspect public work for relevance to the planned collaboration and audience. Personal information does not supply reliable pricing, conversion rates, or willingness to participate. Keep confirmed identity, content still to read, and terms still to discuss in separate parts of the card. An unsuccessful lookup should remain unresolved rather than becoming a claim that the creator has no influence or stopped publishing.

Request URL and parameters

GET https://api.trmesh.com/openapi/api/v1/tiktok/web/fetch_user_profile

Parameter Type Required Meaning
uniqueId string No User uniqueId
secUid string No User secUid

Run the Python example

Install requests and set TRMESH_API_TOKEN in your environment. Replace the sample identifiers with the public object you intend to inspect. Example IDs may no longer be available.

import os
import requests

# Read your own developer key from the server environment.
url = "https://api.trmesh.com/openapi/api/v1/tiktok/web/fetch_user_profile"
params = {
    "uniqueId": "tiktok"
}
response = requests.get(
    url, params=params, timeout=30,
    headers={"Authorization": f"Bearer {os.environ['TRMESH_API_TOKEN']}"},
)
response.raise_for_status()
payload = response.json()
print(payload)  # Inspect the actual response before mapping fields

Endpoint documentation · Free profile tool

API calls use your TRMesh account allowance. Check the endpoint price before running a script.