Common Issues

Connection issues

"Unauthorized" or "Permission denied" during OAuth sign-in

This usually means you're signed into a personal TikTok account. You must use a Creator or Business account to access analytics. Check which account you're logged into and switch if needed, then restart the OAuth flow.

"Invalid redirect URI" error after clicking authorize

Clear your browser cache and cookies, then try the OAuth flow again. If the error persists, open the TikTok authorization page in an incognito/private browser window.

Data flow gets stuck at "Connecting..."

Wait 30 seconds, then refresh the page. If it still hangs, click Disconnect in the source settings, then re-authenticate using the OAuth flow. TikTok sometimes times out during initial connection.

Missing data

No data appears in the destination after running the flow

Check that your date range is within the last 60 days. TikTok does not provide historical data beyond 60 days. If your start date is older than 60 days ago, move it forward and run the flow again.

Profile insights show 0 for all metrics

Wait 24–48 hours after posting new videos. Profile insights update daily, and newly uploaded content may not appear immediately in the data.

Video list is empty even though I've posted videos

Newly posted videos take a few hours to appear in the Video list reports. Also, only videos posted in the selected date range will appear. Expand your date range to include recent posts.

Audience gender/country data is incomplete

TikTok only includes viewers who have a public profile with complete demographic info. Private accounts and users who haven't filled in their country/gender are excluded from these breakdowns.

Data incompleteness

Reference from TikTok API docs:

Q1: When I set the start_date to a certain date (for instance a date in July) in /business/get/, why do I only see profile data from some time later (for instance August) onwards?

A: It might be due to the following reason:

The data you can get from /business/get/ depends on the availability of corresponding TikTok Analytics data in the app and at https://www.tiktok.com/analytics. In this case, it's likely that the TikTok account enabled TikTok Analytics only some time after the start_date you set. Therefore, any profile data prior to the actual date when TikTok Analytics is enabled won't be available through the API.

Permission errors

"You don't have permission to access analytics" message

Ensure you have Admin or Editor role on the TikTok account. If you're a Viewer-only, ask your account admin to upgrade your access, then reconnect the data flow.

Data flow works, but only shows partial data for some videos

Private or restricted videos may not appear in reports. Check your TikTok settings and make sure videos are public.

Data discrepancies

Follower count in the data doesn't match TikTok app

The TikTok app shows real-time follower count; the analytics API reports the count at the end of each day in UTC. Refresh the app or check the data timestamp to confirm.

Video view counts differ between TikTok and Coupler

Small differences (1–5%) can occur due to real-time vs. API reporting delays. Larger gaps usually mean the date range is off. Verify your start and end dates in the data flow settings.

Duplicate rows when using Append mode

If you're running the same report twice on the same date, you'll get duplicates. Use Replace mode if you want to overwrite old data, or filter duplicates in your destination after appending.

likes and audience_countries data latency

Offline data (such as likes , and audience_countries ) usually have a delay of 24-48 hours (UTC Time).

Reference from TikTok API docs:

Latencies for data fields of /business/get/ and /business/video/list/ fall into two categories: no latency, and day-level latency.

- No latency: Real-time data (such as username , and share_url ) usually have no latency.

- Day-level data latency: Offline data (such as likes , and audience_countries ) usually have a delay of 24-48 hours (UTC Time)

Data discrepancy on shares field

Reference from TikTok API docs:

Q1: Why does the shares in /business/video/list/ show more shares than the share count displayed on the TikTok web UI?

A: It might be due to the following reason:

The share count displayed in the shares field from /business/video/list/ corresponds to the number of shares shown in the For You feed on the TikTok mobile app. It includes both external shares and internal shares sent to friends using the "Send to friends" button. In contrast, the share count displayed on the TikTok web UI only includes external shares. For example, if a video is shared externally 30 times and shared with friends within the TikTok app 20 times, the value of shares from the API will be 50, but the share count displayed on the TikTok web UI will be 30.

Rate limits

"Rate limit exceeded" error

TikTok's API has strict rate limits. If you see this, wait 1 hour before running the data flow again. Avoid scheduling multiple data flows to run simultaneously on the same TikTok account.