openapi: 3.0.0
info:
title: Threads Authorization Read And Manage Threads > Read Threads Insights API
description: The Threads API enables developers to build their own unique integrations, and helps creators and brands manage their Threads presence at scale and easily share inspiring content with their communities.
version: 1.0.0
servers:
- url: http://{{api_host}}
security:
- oauth2Auth: []
tags:
- name: Read And Manage Threads > Read Threads Insights
description: This folder will enable you to use the Threads API to retrieve details about posts and accounts.
paths:
/{thread_id}/insights:
get:
tags:
- Read And Manage Threads > Read Threads Insights
summary: Get Post Insights
description: Use the `GET` /{threads-media-id}/insights [endpoint](https://developers.facebook.com/docs/threads/insights#media-insights) to return the insights of a given Threads post.
parameters:
- name: metric
in: query
schema:
type: string
description: 'views: The number of times the post was viewed.
Note: This metric is in development.
likes: The number of likes on the post.
replies: The number of replies on the post.
Note: This number includes only top-level replies.
reposts: The number of times the post was reposted.
quotes: The number of times the post was quoted.'
example: '{{metrics_post}}'
- name: thread_id
in: path
schema:
type: string
required: true
responses:
undefined:
content:
text/plain:
schema:
type: string
example: "{\n \"data\": [\n {\n \"name\": \"views\",\n \"period\": \"lifetime\",\n \"values\": [\n {\n \"value\": 0\n }\n ],\n \"title\": \"Views\",\n \"description\": \"The number of times your post was viewed. This metric is in development (https://www.facebook.com/business/help/metrics-labeling)\",\n \"id\": \"{thread_id}/insights/views/lifetime\"\n },\n {\n \"name\": \"likes\",\n \"period\": \"lifetime\",\n \"values\": [\n {\n \"value\": 0\n }\n ],\n \"title\": \"Likes\",\n \"description\": \"The number of likes on your post.\",\n \"id\": \"{thread_id}/insights/likes/lifetime\"\n },\n {\n \"name\": \"replies\",\n \"period\": \"lifetime\",\n \"values\": [\n {\n \"value\": 0\n }\n ],\n \"title\": \"Replies\",\n \"description\": \"The number of replies on your post.\",\n \"id\": \"{thread_id}/insights/thread_replies/lifetime\"\n },\n {\n \"name\": \"reposts\",\n \"period\": \"lifetime\",\n \"values\": [\n {\n \"value\": 0\n }\n ],\n \"title\": \"Reposts\",\n \"description\": \"The number of times your post was reposted.\",\n \"id\": \"{thread_id}/insights/reposts/lifetime\"\n },\n {\n \"name\": \"quotes\",\n \"period\": \"lifetime\",\n \"values\": [\n {\n \"value\": 0\n }\n ],\n \"title\": \"Quotes\",\n \"description\": \"The number of times your post was quoted.\",\n \"id\": \"{thread_id}/insights/quotes/lifetime\"\n }\n ]\n}"
/me/threads_insights:
get:
tags:
- Read And Manage Threads > Read Threads Insights
summary: Get Account Insights
description: Use the `GET` /{threads-user-id}/threads_insights [endpoint](https://developers.facebook.com/docs/threads/insights#user-insights) to return the insights of a given Threads user.
parameters:
- name: metric
in: query
schema:
type: string
description: 'views: The number of times the post was viewed.
Note: This metric is in development.
likes: The number of likes on the post.
replies: The number of replies on the post.
Note: This number includes only top-level replies.
reposts: The number of times the post was reposted.
quotes: The number of times the post was quoted.
reposts: The number of times your posts were quoted.
followers_count: Your total number of followers on Threads.
follower_demographics: The demographic characteristics of followers, including countries, cities and gender distribution.
Note: Does not support the since and until parameters.'
example: '{{metrics_account}}'
responses:
undefined:
content:
text/plain:
schema:
type: string
example: "{\n \"data\": [\n {\n \"name\": \"views\",\n \"period\": \"day\",\n \"values\": [\n {\n \"value\": 0,\n \"end_time\": \"2024-09-16T07:00:00+0000\"\n },\n {\n \"value\": 0,\n \"end_time\": \"2024-09-17T07:00:00+0000\"\n }\n ],\n \"title\": \"views\",\n \"description\": \"The number of times your profile was viewed.\",\n \"id\": \"{user_id}/insights/views/day\"\n },\n {\n \"name\": \"likes\",\n \"period\": \"day\",\n \"title\": \"likes\",\n \"description\": \"The number of likes on your posts.\",\n \"total_value\": {\n \"value\": 0\n },\n \"id\": \"{user_id}/insights/likes/day\"\n },\n {\n \"name\": \"replies\",\n \"period\": \"day\",\n \"title\": \"replies\",\n \"description\": \"The number of replies on your posts.\",\n \"total_value\": {\n \"value\": 0\n },\n \"id\": \"{user_id}/insights/replies/day\"\n },\n {\n \"name\": \"reposts\",\n \"period\": \"day\",\n \"title\": \"reposts\",\n \"description\": \"The number of times your posts were reposted.\",\n \"total_value\": {\n \"value\": 0\n },\n \"id\": \"{user_id}/insights/reposts/day\"\n },\n {\n \"name\": \"quotes\",\n \"period\": \"day\",\n \"title\": \"quotes\",\n \"description\": \"The number of times your posts were quoted.\",\n \"total_value\": {\n \"value\": 0\n },\n \"id\": \"{user_id}/insights/quotes/day\"\n },\n {\n \"name\": \"followers_count\",\n \"period\": \"day\",\n \"title\": \"followers_count\",\n \"description\": \"This is your total number of followers on Threads.\",\n \"total_value\": {\n \"value\": 0\n },\n \"id\": \"{user_id}/insights/followers_count/day\"\n }\n ],\n \"paging\": {\n \"previous\": \"string\",\n \"next\": \"string\"\n }\n}"
components:
securitySchemes:
noauthAuth:
type: http
scheme: noauth
oauth2Auth:
type: http
scheme: oauth2