N8N Tools - TikTok Enhanced icon

N8N Tools - TikTok Enhanced

Comprehensive TikTok API integration for N8N workflows

Actions46

Users → Search Users

AI-generated

Overview

The "Search Users" operation of the TikTok Enhanced node allows you to search for TikTok users based on a query string. This is useful when you want to find user profiles matching specific keywords or names within your n8n workflow. For example, you could use this node to:

  • Find influencers or content creators related to a niche by searching their usernames or display names.
  • Automate gathering user data for marketing campaigns or social listening.
  • Build lists of users for further processing, such as fetching their followers or videos.

This operation supports pagination and limiting the number of results returned, making it practical for handling large datasets incrementally.

Properties

Name Meaning
Query The search query string used to find users matching the input text.
Count Number of user items to return (maximum 100). Defaults to 20 if not specified.
Cursor Pagination cursor token to retrieve the next page of results. Optional for paginated use.

Output

The output is an array of JSON objects representing TikTok users that match the search query. Each item corresponds to one user profile with details as provided by the TikTok API via the integrated service. The exact structure depends on the TikTok API response but typically includes user identifiers, usernames, display names, profile pictures, and other metadata.

No binary data output is produced by this operation.

Dependencies

  • Requires an active subscription and valid API key credential for the external TikTok API service accessed through the "N8N Tools API".
  • The node uses HTTP requests to communicate with the TikTok API via the N8N Tools API proxy.
  • Proper configuration of the API key credential in n8n is necessary for authentication.
  • The node internally uses a TikTok API client library bundled with the node code.

Troubleshooting

  • Invalid subscription or API key error: If you receive an error indicating invalid subscription or API key, verify that your API credentials are correctly configured and have the required permissions.
  • Rate limits or quota exceeded: The external TikTok API may enforce rate limits; consider reducing the Count parameter or adding delays between executions.
  • Empty results: Ensure the Query parameter is correctly set and not empty; also check that the query matches existing TikTok users.
  • Pagination issues: When using the Cursor parameter, ensure you pass the correct cursor token from previous responses to paginate properly.
  • Network or connectivity errors: Confirm that your n8n instance can reach the external API endpoints and that no firewall or proxy blocks exist.

Links and References

Discussion