TikTok profile picture downloader API
Download a TikTok profile picture with one POST. The response returns a permanent image download URL and full profile metadata.
- One POST, One Image
- Permanent Download URLs
- Flexible Username Input
- Full Profile Metadata
- Idempotency Key Support
- Server-Side Key Required
Request examples
curl -X POST "https://api.agentbody.io/v1/tiktok/profile/picture/download" \
-H "Authorization: Bearer <YOUR_AGENTBODY_API_KEY>" \
-H "Content-Type: application/json" \
-d '{"username":"YOUR_USERNAME"}'Response examples
Documented responses from the OpenAPI specification.
Direct TikTok profile picture link and normalized public profile metadata.
{
"bio": "Example bio",
"display_name": "Example Creator",
"followers": 151200000,
"following": 1537,
"likes": 11300000000,
"profile_picture_url": "https://p16-sign-va.tiktokcdn.com/example.jpeg",
"profile_url": "https://www.tiktok.com/@example",
"username": "example",
"videos": 2346
}Features
The tiktok.profile_picture_download operation fetches the avatar from one public TikTok profile. Your server holds the API key; the endpoint returns a permanent download URL plus full profile metadata in a single call.
One POST, One Image
Send POST /v1/tiktok/profile/picture/download with a TikTok username, @handle, or profile URL. A successful 200 returns username, display_name, bio, followers, following, likes, videos, profile_url, and profile_picture_url — everything a contact or research pipeline needs in one response.
Permanent Download URLs
The profile_picture_url points to a fully saved image file, not an expiring CDN redirect. It downloads from any server, any IP, at any time, so you can hand it to a queue worker, a CRM, or straight to your end user without re-running the lookup.
Flexible Username Input
The username parameter accepts a bare username, an @handle, or a full profile URL (tiktok.com/@username). The API normalizes all three formats to the same public profile; private, deleted, or nonexistent accounts return a 400 or 502 error.
Full Profile Metadata
Every response includes the complete public profile: username, display name, bio text, follower count, following count, total likes, video count, and profile URL — consistent across all accounts regardless of how the user configured their privacy settings.
Idempotency Key Support
Pass an Idempotency-Key header to safely retry failed requests without duplicate charges. The gateway deduplicates by key, so a network retry never triggers a second lookup for the same profile.
Server-Side Key Required
The endpoint requires an AgentBody API key held on your server. Never expose the key in client-side code; route all calls through your backend to keep the key secure and your usage tracked.
How to use
Integrate TikTok profile picture downloads in three steps with the API.
Get Your API Key
Create a free AgentBody account and generate an API key from the dashboard. The key authenticates every request and tracks usage against your balance.
POST The Username
Send a POST request to /v1/tiktok/profile/picture/download with the TikTok username, @handle, or profile URL in the request body. Include an Idempotency-Key header for safe retries.
Receive The Download Link
A successful 200 response returns the permanent profile_picture_url plus full profile metadata. Download the image directly from the link, or hand it to your media pipeline for storage and distribution.
Frequently asked questions
How does the TikTok profile picture downloader API work?
Send a POST request to /v1/tiktok/profile/picture/download with a TikTok username, @handle, or profile URL. The API fetches the profile, saves the avatar image, and returns a permanent download URL along with the full public profile metadata.
What username formats are supported?
The API accepts a bare username (charlidamelio), an @handle (@charlidamelio), or a full profile URL (https://www.tiktok.com/@charlidamelio). All three formats resolve to the same public profile.
What is the response format?
A successful 200 response returns a JSON object with: username, display_name, bio, followers, following, likes, videos, profile_url, and profile_picture_url (permanent image download link).
Are there rate limits or usage caps?
Each successful download draws a fixed amount from your AgentBody balance at the gateway-governed price. There is no separate rate limit beyond your account balance; failed requests (400, 502, etc.) are not billed. Use the Idempotency-Key header to prevent duplicate charges on retries.
Can I download profile pictures from private TikTok accounts?
No. The API can only process publicly available profiles. Private accounts, deleted accounts, and restricted profiles are rejected by TikTok's platform and return a 400 or 502 error.
Is it legal to use this API for downloading TikTok profile pictures?
Use the API only for publicly available profile pictures for legitimate purposes such as research, verification, or design reference. Respect privacy rights and TikTok's terms of service. Do not use downloaded images to impersonate others or violate their rights.