> For the complete documentation index, see [llms.txt](https://docs.coupler.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.coupler.io/sources/category/social-media/tiktok-public/faq.md).

# FAQ

<details>

<summary>Do I need a business/verified account to connect?</summary>

Yes, only **Creator and Business accounts** have access to TikTok's analytics API. Personal accounts cannot connect to Coupler. If you have a Creator account, you should already have analytics available in the TikTok app; if not, go to Creator Center and enable analytics.

</details>

<details>

<summary>Why can't I see data older than 60 days?</summary>

TikTok's API only provides 60 days of historical data. However, you can use Coupler to **append new data every day**, which builds your own long-term archive. After 60 days, manually export the oldest data to a separate sheet before it rolls off.

</details>

<details>

<summary>Can I combine TikTok data with my Instagram or YouTube data?</summary>

Yes! Create separate data flows for each platform, then use Coupler's **Append** transformation to merge them into one sheet (if they have the same columns) or use **Join** to correlate them by date. This is great for social media dashboards.

</details>

<details>

<summary>How often does TikTok update its analytics?</summary>

Once per day, usually overnight UTC. Schedule your Coupler data flow to run at 1–2 AM UTC so you capture the latest data without delay.

</details>

<details>

<summary>What's the difference between Profile insights and Video list insights?</summary>

**Profile insights** show overall account metrics (total followers, views, likes, comments). **Video list insights** break down performance by individual video, so you can see which specific videos performed best.

</details>

<details>

<summary>Can I use macros for date ranges?</summary>

Yes, both the **Start date** and **End date** fields support macros like `{{today}}`, `{{30daysago}}`, and `{{firstDayOfMonth}}`. This lets your date range update automatically without manual changes. See Coupler's macro guide for the full list.

</details>

<details>

<summary>What should I do if I see a "Rate limit exceeded" error?</summary>

Wait at least 1 hour before running the data flow again. If you manage multiple TikTok accounts, stagger their scheduled runs so they don't overlap. Avoid running more than one data flow per account simultaneously.

</details>

<details>

<summary>Should I use Replace or Append mode?</summary>

Use **Append** for ongoing daily tracking—it builds your historical archive. Use **Replace** for one-off reports or if you want to overwrite old data. Remember: TikTok only provides 60 days, so appending lets you keep trends beyond that window.

</details>

<details>

<summary>Why is my newly posted video not in the Video list report?</summary>

Newly posted videos take 2–4 hours to appear in TikTok's analytics. Also check that your date range includes today's date. If the video is still not there after 24 hours, it may be in draft or restricted mode.

</details>

<details>

<summary>Can I send TikTok data to Claude, ChatGPT, or other AI tools?</summary>

Yes! Coupler supports AI destinations including Claude, ChatGPT, Cursor, Gemini, Perplexity, and OpenClaw. Create a data flow to one of these destinations and paste your TikTok metrics for instant analysis and content recommendations.

</details>

{% hint style="info" %}
For more details on available metrics and dimensions, see [Data Overview](/sources/category/social-media/tiktok-public/data-overview.md). For troubleshooting connection or permission issues, check [Common Issues](/sources/category/social-media/tiktok-public/common-issues.md).
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.coupler.io/sources/category/social-media/tiktok-public/faq.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.