TikTok's Lead Generation API type is not explicitly mentioned in the available information. Modern web APIs typically use REST or GraphQL architectures. REST APIs are common for web and mobile applications, while GraphQL is gaining popularity for complex data requirements. Without official documentation from TikTok, it's not possible to definitively state which API type they use for Lead Generation.
The TikTok API supports webhooks, allowing you to subscribe to events and receive notifications when those events occur.
The TikTok API supports several types of webhook events:
video.publish.completed: Fired when a video uploaded from Video Kit has been published by the user on TikTok.
video.upload.failed: Fired when a video uploaded from Video Kit fails to upload on TikTok.
authorization.removed: Fired when a user's account is deauthorized from your application.
New Lead: While not explicitly mentioned in the TikTok API documentation, third-party integrations suggest that there's an event for when a new lead is created in TikTok Lead Generation.
Webhook Configuration: Register a callback URL in your client application on the TikTok Developer Portal.
HTTPS Requirement: The callback URL endpoint must use HTTPS.
Response Handling: Respond with a 200 HTTP status code to acknowledge receipt of the event notification.
Retry Mechanism: TikTok will retry delivery for up to 72 hours using exponential backoff if a 200 HTTP status code is not returned.
Idempotency: Implement idempotent event processing to handle potential duplicate events.
Security: Ensure your webhook endpoint is secure and can handle the expected load.
Error Handling: Implement robust error handling for webhook processing.
Logging: Keep detailed logs of received webhooks for debugging and auditing.
Verification: Implement webhook verification to ensure legitimate requests from TikTok.
Scalability: Design your webhook handling system to scale with the potential volume of events.
Note that specific events related to Lead Generation are not explicitly detailed in the official TikTok API documentation. Information about lead generation events comes from third-party integrations, suggesting such functionality exists but may require additional investigation or could be part of a separate Lead Generation API.
Based on the search results provided, here are the key points regarding the API rate limits of the TikTok Lead Generation API:
TikTok API limits the number of requests that can be sent in a given timeframe. Limits are set and enforced separately for each API.
For the /v2/video/list/ endpoint, the default rate limit is 600 requests per minute.
Request rate calculation is based on a one-minute sliding window.
If the number of requests exceeds the threshold, new requests will be throttled.
A response will be returned with HTTP status 429 and error code rate_limit_exceeded.
If an application needs higher limits, developers can contact TikTok using their Support Page.
TikTok will review the request and may approve increased rate limits if justified.
While not specifically for the Lead Generation API, the Research API has the following limits which may be indicative of TikTok's general approach:
Daily limit of 1000 requests per day, allowing up to 100,000 records per day across APIs.
For Followers and Following lists API, up to 2M records per day with 20,000 calls per day maximum.
Daily quotas reset at 12 AM UTC.
It's important to note that these details are based on general TikTok API information and Research API specifics. The exact rate limits for the Lead Generation API may differ, and it would be best to consult the specific documentation for that API or contact TikTok directly for the most accurate and up-to-date information.
Based on the search results provided, I do not have definitive information about the most recent version of the TikTok Lead Generation API. The search results do not contain specific version numbers or release dates for the TikTok Lead Generation API.
However, I can provide some relevant information about TikTok's advertising and lead generation capabilities:
TikTok offers a Lead Generation ad objective that allows advertisers to collect leads directly through TikTok ads.
TikTok has a Conversion API (also called Events API) that allows advertisers to share marketing data from their servers, websites, apps, or CRMs with TikTok.
The TikTok Conversion API works alongside the TikTok pixel to provide more comprehensive conversion tracking.
TikTok recommends using both the pixel and Conversion API together for optimal ad performance tracking.
When setting up TikTok lead generation or conversion campaigns, use both the TikTok pixel and Conversion API for the most accurate tracking.
Test your conversion tracking setup to ensure it's working properly before launching campaigns.
Consider using third-party integrations like LeadsBridge to automate the process of connecting TikTok lead and conversion data to your other marketing tools.
While I don't have the specific version number you asked for, TikTok regularly updates its advertising products. For the most up-to-date information on the Lead Generation API, I recommend checking TikTok's official developer documentation or contacting their support directly.
Here's how to get a developer account for TikTok Lead Generation to create an API integration:
Based on the search results provided, here are the key data models you can interact with using the TikTok Lead Generation API:
Key points to consider:
The TikTok Lead Generation API provides comprehensive access to lead data, campaign information, and analytics to help businesses effectively generate and manage leads on the platform.
