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.
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.
Rate limits
Last updated
Was this helpful?