Actions7
- Video Actions
- User Actions
- Analytics Actions
Overview
This node integrates with the TikTok API to retrieve user profile information. Specifically, the Get Profile operation fetches selected fields of a TikTok user's profile such as their avatar URL, display name, username, verification status, and unique identifiers.
This node is useful when you want to:
- Display or store TikTok user profile details in your workflow.
- Enrich data by pulling verified user information from TikTok.
- Automate processes that depend on user metadata, e.g., syncing usernames or avatars to other platforms.
Example use case:
A marketing automation workflow that pulls TikTok influencer profiles to personalize outreach emails or update CRM records with the latest profile info.
Properties
| Name | Meaning |
|---|---|
| Profile Fields | Select which user profile fields to retrieve. Options include: |
| - Avatar URL: User avatar image URL | |
| - Bio Description: User bio/description | |
| - Display Name: User display name | |
| - Is Verified: Whether user is verified | |
| - Open ID: Unique user identifier | |
| - Profile Deep Link: Deep link to user profile | |
| - Union ID: Union identifier across TikTok apps | |
| - Username: User handle/username |
The default selected fields are open_id, display_name, username, and avatar_url.
Output
The node outputs JSON objects containing the requested user profile fields as key-value pairs. For example, if you request username and avatar_url, the output JSON will include those properties with their corresponding values from TikTok.
No binary data is output by this operation.
Dependencies
- Requires an API authentication token configured via OAuth2 credentials for TikTok.
- The node makes HTTP requests to the TikTok Open API endpoint at
https://open.tiktokapis.com. - Proper OAuth2 credential setup in n8n is necessary to authenticate requests.
Troubleshooting
Common issues:
- Invalid or expired OAuth2 token causing authentication failures.
- Requesting profile fields not available or restricted by TikTok API permissions.
- Network connectivity issues preventing API calls.
Error messages:
- Authentication errors typically indicate invalid credentials; re-authenticate the OAuth2 token.
- "Field not found" or similar errors suggest unsupported or misspelled profile fields.
- Rate limiting errors may occur if too many requests are made in a short time; implement retry logic or reduce request frequency.
Links and References
- TikTok Open API Documentation
- TikTok User Info API Reference (for detailed field descriptions)
- n8n OAuth2 Credential Setup Guide