TikTok Events API - Server-Side Conversions avatar
TikTok Events API - Server-Side Conversions

Pricing

from $0.01 / 1,000 results

Go to Apify Store
TikTok Events API - Server-Side Conversions

TikTok Events API - Server-Side Conversions

Send offline events and server-side conversions to TikTok Events API. Track purchases, signups, and custom events with automatic PII hashing for campaign attribution.

Pricing

from $0.01 / 1,000 results

Rating

0.0

(0)

Developer

John Rippy

John Rippy

Maintained by Community

Actor stats

0

Bookmarked

2

Total users

1

Monthly active users

a day ago

Last modified

Share

TikTok Events API

Built by John Rippy | johnrippy.link

🏆 2025 Zapier Automation Hero of the YearProject Phoenix: A 95-step AI sales pipeline cutting development time by 50%. Read more →

Server-Side Conversions - Track Purchases & Events on TikTok

Send offline events and server-side conversions to TikTok Events API. Track purchases, signups, and custom events with automatic PII hashing for campaign attribution.

Features

Event Sending

  • send_event - Send a single event
  • send_batch_events - Send multiple events
  • test_event - Send test event for validation

Pixel Management

  • list_pixels - List all pixels in account
  • get_pixel_info - Get pixel details

Standard Events

Event NameDescription
CompletePaymentPurchase completed
PlaceAnOrderOrder placed
InitiateCheckoutCheckout started
AddToCartItem added to cart
ViewContentPage/product viewed
AddToWishlistItem saved
SearchSite search
ContactContact form
SubscribeSubscription signup
SubmitFormForm submission
CompleteRegistrationAccount signup
DownloadApp/content download

Event Data

User Identification

All PII is automatically SHA256 hashed:

  • email - Customer email
  • phone - Customer phone
  • externalId - Your customer ID

Click Tracking

  • ttclid - TikTok click ID from URL
  • ttp - TikTok cookie (_ttp)

Device Info

  • ipAddress - Customer IP
  • userAgent - Browser user agent

Event Properties

  • value - Conversion value
  • currency - ISO 4217 code
  • orderId - Transaction ID
  • contentId - Product ID
  • quantity - Number of items

Example Usage

Single Purchase Event

{
"task": "send_event",
"pixelCode": "CP1234567890",
"eventName": "CompletePayment",
"email": "john@example.com",
"phone": "+15551234567",
"value": 99.99,
"currency": "USD",
"orderId": "ORD-12345"
}

Batch Events

{
"task": "send_batch_events",
"pixelCode": "CP1234567890",
"events": [
{
"eventName": "CompletePayment",
"email": "john@example.com",
"value": 99.99,
"orderId": "ORD-001"
},
{
"eventName": "Subscribe",
"email": "jane@example.com"
}
]
}

Match Quality

For best match rates, include:

  1. ttclid - Click-based (best)
  2. email + phone - Strong match
  3. email + IP + user agent - Good match

Event Deduplication

TikTok deduplicates by:

  • event_id - Your unique event ID
  • orderId - Transaction ID

Include orderId for purchase events.

Testing

Use Events Manager to:

  1. Get test event code
  2. Verify events received
  3. Check match quality
  4. Debug issues

Pricing

$0.01 per query (all tasks)

Rate Limits

  • 1,000 events per batch
  • 50 requests per second
  • Events within 7 days of click