> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appeeky.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Organic Posts

> See the reach of each social post next to the clicks, installs and revenue from the smart link in it

The **Organic** view in the app's **Attribution** tab lists your social posts with their reach (views, likes, comments, shares) next to what the smart link in each post brought in: clicks, installs and revenue.

***

## Which Posts Appear

* Posts you published from Appeeky (**Social**) in the last 90 days, newest first. Their metrics come from the platform and refresh a few times a day.
* Smart links with an organic channel (TikTok, Instagram, Facebook, YouTube, X or Reddit) whose post was published outside Appeeky. These rows show the link's results without post metrics.

Clicks, installs and revenue follow the range at the top (Today, 7d, 30d).

***

## Link a Post

A smart link belongs to a post when:

* its **channel** is the post's platform (`tiktok`, `instagram`, `facebook`, `youtube`, `x` or `reddit`), and
* its **external id** is the post URL or the platform's post id.

URLs are compared without `https://`, `www.`, query string or trailing slash, so `https://www.tiktok.com/@me/video/7300?lang=en` matches `tiktok.com/@me/video/7300`.

To link a post that has none yet, click **Create link** on its row. Appeeky creates a smart link with the post's channel and URL and your App Store and Google Play pages. Put the link in the post's caption or your bio.

You can also create the link from **Smart links** or the API by setting `channel` and `externalId`:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -X POST "https://api.appeeky.com/v1/analytics/apps/YOUR_APP_ID/links" \
  -H "X-API-Key: YOUR_APPEEKY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "TikTok launch video",
    "campaign": "tiktok-launch",
    "channel": "tiktok",
    "externalId": "https://www.tiktok.com/@me/video/7300",
    "iosUrl": "https://apps.apple.com/app/id123456789"
  }'
```

***

## API

| Method | Path | Returns |
| - | - | - |
| `GET` | `/v1/analytics/apps/:appId/organic?range=30d` | `{ range, posts, accounts, totals }` |

Each post has `channel`, `url`, `externalId`, `text`, `publishedAt`, `metrics` (`views`, `likes`, `comments`, `shares`, or `null`), `link` (`id`, `slug`, `name`, `url`, or `null`), `clicks`, `installs`, `revenueUsd`, and `accountId`, `handle` and `thumbnailUrl` (the post's first image) when known.

`accounts` sums the posts published in the selected period per connected social account, most views first: `accountId`, `platform`, `handle`, `name`, `avatarUrl`, `followers` (or `null`), `posts`, `views`, `likes`, `comments` and `shares`. `totals` has the `views` and `posts` of all posts published in the period. Views are each post's latest measured count, so a post's views count in the period it was published.

***

## Related Docs

* [Smart Links](https://docs.appeeky.com/docs/analytics-smart-links.md)
* [Attribution](https://docs.appeeky.com/docs/analytics-attribution.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.