Threads Analytics

Threads analytics endpoints provide insights for your connected Threads accounts.

1. GET /api/threads/overview

Returns account-level metrics with current vs. previous period comparison.

Sample Request

curl --location --request GET \
"https://analyze.oneupapp.io/api/threads/overview?apiKey=YOUR_API_KEY&social_network_id=123&preset=last_30_days"

Sample Response

{
  "success": true,
  "data": {
    "metrics": [
      {
        "key": "posts",
        "name": "Posts",
        "value_current_period": 45,
        "value_last_period": 38,
        "percentage_change": "+18.4%",
        "description": "Total number of posts in this period"
      },
      {
        "key": "views",
        "name": "Views",
        "value_current_period": 12500,
        "value_last_period": 10200,
        "percentage_change": "+22.5%",
        "description": "The number of times your posts were viewed"
      },
      {
        "key": "likes",
        "name": "Likes",
        "value_current_period": 890,
        "value_last_period": 750,
        "percentage_change": "+18.7%",
        "description": "The number of likes on your posts"
      },
      {
        "key": "comments",
        "name": "Comments",
        "value_current_period": 120,
        "value_last_period": 95,
        "percentage_change": "+26.3%",
        "description": "The number of comments on your posts"
      },
      {
        "key": "replies",
        "name": "Replies",
        "value_current_period": 85,
        "value_last_period": 70,
        "percentage_change": "+21.4%",
        "description": "The number of replies to your posts"
      },
      {
        "key": "reposts",
        "name": "Reposts",
        "value_current_period": 45,
        "value_last_period": 38,
        "percentage_change": "+18.4%",
        "description": "The number of reposts of your posts"
      },
      {
        "key": "quotes",
        "name": "Quotes",
        "value_current_period": 25,
        "value_last_period": 20,
        "percentage_change": "+25.0%",
        "description": "The number of quotes of your posts"
      }
    ],
    "total_followers": 5200,
    "post_performance": {
      "most_engaging": [
        {
          "id": "1234567890",
          "text": "Great content!",
          "permalink": "https://threads.net/t/1234567890",
          "media_url": "https://example.com/image.jpg",
          "engagement": 250,
          "engagement_rate": "8.5%",
          "engagement_rate_raw": 8.5,
          "views": 2941,
          "likes": 150,
          "reposts": 50,
          "quotes": 50
        }
      ],
      "least_engaging": [],
      "most_views": [],
      "least_views": [],
      "most_reposted": [],
      "least_reposted": []
    }
  }
}

Metrics

Key	Name	Description
posts	Posts	Total posts published
views	Views	Total number of times your posts were viewed
likes	Likes	Total likes on your posts
comments	Comments	Total comments on your posts
replies	Replies	Total replies to your posts
reposts	Reposts	Total reposts of your posts
quotes	Quotes	Total quotes of your posts

---

2. GET /api/threads/posts

Returns analytics for individual posts.

Sample Request

curl --location --request GET \
"https://analyze.oneupapp.io/api/threads/posts?apiKey=YOUR_API_KEY&social_network_id=123&preset=last_30_days"

Sample Response

{
  "success": true,
  "data": {
    "stats": [
      {
        "key": "posts",
        "name": "Posts",
        "value_current_period": 45,
        "value_last_period": 38,
        "percentage_change": "+18.4%",
        "description": "Total number of posts in this period"
      },
      {
        "key": "views",
        "name": "Views",
        "value_current_period": 12500,
        "value_last_period": 10200,
        "percentage_change": "+22.5%",
        "description": "Total number of times your posts were viewed"
      },
      {
        "key": "likes",
        "name": "Likes",
        "value_current_period": 890,
        "value_last_period": 750,
        "percentage_change": "+18.7%",
        "description": "The number of likes on your posts"
      },
      {
        "key": "comments",
        "name": "Comments",
        "value_current_period": 120,
        "value_last_period": 95,
        "percentage_change": "+26.3%",
        "description": "The number of comments on your posts"
      },
      {
        "key": "replies",
        "name": "Replies",
        "value_current_period": 85,
        "value_last_period": 70,
        "percentage_change": "+21.4%",
        "description": "The number of replies to your posts"
      },
      {
        "key": "reposts",
        "name": "Reposts",
        "value_current_period": 45,
        "value_last_period": 38,
        "percentage_change": "+18.4%",
        "description": "The number of reposts of your posts"
      },
      {
        "key": "quotes",
        "name": "Quotes",
        "value_current_period": 25,
        "value_last_period": 20,
        "percentage_change": "+25.0%",
        "description": "The number of quotes of your posts"
      }
    ],
    "posts": [
      {
        "id": "1234567890",
        "page_id": "threads_account_123",
        "format": "image",
        "text": "Great content!",
        "permalink": "https://threads.net/t/1234567890",
        "media_type": "IMAGE",
        "media_url": "https://example.com/image.jpg",
        "stats": {
          "views": 2941,
          "likes": 150,
          "comments": 15,
          "replies": 10,
          "reposts": 50,
          "quotes": 25
        },
        "timestamp": "2025-05-01 10:30:00"
      }
    ]
  }
}

Post Stats

Field	Description
views	Number of views
likes	Number of likes
comments	Number of comments
replies	Number of replies
reposts	Number of reposts
quotes	Number of quotes

✅ Result: You have successfully retrieved Threads analytics data!