Traceryn Docs | Open-source developer tools and SDKs

TikTok rate-limits endpoints based on IP. If a request returns an empty response or gets throttled after heavy use, switch IP with a proxy.

Configure proxies

Pass proxies when you create the client:

const client = new TikTokClient({
  proxy: ['http://user:pass@host:port', 'http://proxy2:port'],
  proxyRotation: 'round-robin', // or 'random', 'lowest-failures'
});

Or add them at runtime and check their usage:

client.addProxies(['http://user:pass@host:port', 'http://proxy2:port']);
console.log(client.getProxyStats());

The SDK automatically rotates to the next healthy proxy when one fails. The example scripts accept a --proxy flag:

node docs/examples/searchUsers.cjs --session --proxy=http://user:pass@host:port

Free public proxies are often blocked by TikTok. Residential or paid proxies are the most reliable for high-volume use.

Get started

Guides

Reference

IP throttling and proxies

Configure proxies

​Configure proxies

Configure proxies