> For the complete documentation index, see [llms.txt](https://docs.smaq.io/documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.smaq.io/documentation/connections/threads.md).

# Threads

Threads is Meta's text-based social platform. SMAQ supports organic Threads analytics.

### What SMAQ pulls

* Post-level metrics: views, replies, reposts, quotes, likes
* Profile-level metrics: follower count, follows
* Engagement rate and reach

### What you'll need

* A Threads account (only available where Threads has rolled out).
* A linked Instagram Business or Creator account.

### Steps to connect

1. **Data Source → Add data source**.
2. Pick **Threads**.
3. Authorize via Meta OAuth.
4. Pick the Threads profile.
5. Name and click **Connect**.

> **\[Screen video needed]** Threads OAuth + profile picker. \~45 seconds.

### Tips

* **API is still maturing.** Some metrics may be unavailable depending on Meta's current Threads API exposure. Watch the SMAQ changelog for new fields.
* **Cross-post detection.** If you cross-post the same content to Instagram and Threads, the two platforms report independently.

### Troubleshooting

* **"Threads not available"** — Threads access requires a linked Instagram Business/Creator account on a region where Threads has rolled out.

### Related

* [Instagram](/documentation/connections/instagram.md)


---

# 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:

```
GET https://docs.smaq.io/documentation/connections/threads.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.