Threads

Threads Read And Manage Threads > Read and Manage Threads Replies API

The Threads Reply Moderation API allows you to read and manage replies to users' own Threads.

GitHub OpenAPI

Documentation

📖
Documentation
https://developers.facebook.com/docs/threads/
📖
GettingStarted
https://developers.facebook.com/docs/threads/get-started
📖
Authentication
https://developers.facebook.com/docs/threads/get-started/get-access-tokens-and-permissions

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/threads-api/refs/heads/main/openapi/threads-api-read-and-manage-threads-read-and-manage-threads-replies-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/threads-api/refs/heads/main/json-schema/threads-api-thread-schema.json

Other Resources

🔗
PostmanCollection
https://www.postman.com/meta/threads/collection/dht3nzz/threads-api?action=share&creator=35240
🔗
Webhooks
https://developers.facebook.com/docs/threads/webhooks
🔗
ChangeLog
https://developers.facebook.com/docs/threads/changelog
🔗
PostmanWorkspace
https://www.postman.com/meta/threads/overview

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/threads-api-read-and-manage-threads-read-and-manage-threads-replies-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

threads-api-read-and-manage-threads-read-and-manage-threads-replies-api-openapi.yml Raw ↑ 
openapi: 3.0.0
info:
  title: Threads Authorization Read And Manage Threads > Read and Manage Threads Replies 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 and Manage Threads Replies
  description: The Threads Reply Moderation API allows you to read and manage replies to users' own Threads.
paths:
  /me/threads:
    post:
      tags:
      - Read And Manage Threads > Read and Manage Threads Replies
      summary: Control Who Can Reply
      description: Use the [reply_control](https://developers.facebook.com/docs/threads/reply-management#control-who-can-reply) parameter to specify who can reply to a post being created for publishing.
      requestBody:
        content: {}
      parameters:
      - name: media_type
        in: query
        schema:
          type: string
        example: '{{media_type}}'
      - name: text
        in: query
        schema:
          type: string
        example: Text
      - name: reply_control
        in: query
        schema:
          type: string
        example: '{{reply_control}}'
      responses:
        undefined:
          content:
            text/plain:
              schema:
                type: string
              example: "{\n    \"id\": \"string\"\n}"
  /{thread_id}/replies:
    get:
      tags:
      - Read And Manage Threads > Read and Manage Threads Replies
      summary: Get Threads Replies
      description: Use `GET` /replies [endpoint](https://developers.facebook.com/docs/threads/reply-management#replies) to fetch a paginated list of all top-level replies.
      parameters:
      - name: fields
        in: query
        schema:
          type: string
        description: 'id (default): The media''s ID.


          text: Represents text for a Threads reply. This is optional on image, video, and carousel replies.


          username: Instagram username who created the post.

          Note: This only works for public users, your own user, and users that you follow.


          permalink: Permanent link to the post. Will be omitted if the media contains copyrighted material or has been flagged for a copyright violation.

          Note: This only works for public users, your own user, and users that you follow.


          timestamp: The publish date and time of the post in ISO 8601 format.


          media_product_type: Surface where the media is published. In the case of Threads, the value is THREADS.


          media_type: The media type for a Threads reply.

          Values: TEXT_POST, IMAGE, VIDEO, CAROUSEL_ALBUM


          media_url: The posts media URL. This only shows for image, video, and carousel replies.


          shortcode: Shortcode of the media.


          thumbnail_url: URL of thumbnail. This only shows for Threads replies with video.


          children: List of child posts. This only shows for carousel replies.


          has_replies: true if the Threads post or reply has replies that you can see.


          root_post: Media ID of the top-level post or original thread in the reply tree.

          Note: This only appears on replies.


          replied_to: Media ID of the immediate parent of the reply.

          Note: This only appears on replies.


          is_reply: true if the Threads media is a reply. false if the Threads media is a top-level post.


          hide_status: Whether or not the reply is hidden.

          Values: NOT_HUSHED, UNHUSHED, HIDDEN'
        example: text
      - name: reverse
        in: query
        schema:
          type: boolean
        example: 'false'
      - name: thread_id
        in: path
        schema:
          type: string
        required: true
      responses:
        undefined:
          headers:
            Content-Type:
              schema:
                type: string
                example: application/json
          content:
            application/json:
              schema:
                type: object
              example:
                data:
                - id: string
                  text: reply
                  timestamp: 2024-09-17T20:54:47+0000
                  media_product_type: THREADS
                  media_type: TEXT_POST
                  permalink: string
                  shortcode: string
                  username: string
                  is_quote_post: false
                  has_replies: false
                  is_reply: true
                  is_reply_owned_by_me: false
                  root_post:
                    id: string
                  replied_to:
                    id: string
                paging:
                  cursors:
                    before: string
                    after: string
  /{thread_id}/conversation:
    get:
      tags:
      - Read And Manage Threads > Read and Manage Threads Replies
      summary: Get Threads Conversations
      description: Use `GET` /conversation [endpoint](https://developers.facebook.com/docs/threads/reply-management#conversations) to fetch a paginated and flattened list of all top-level and nested replies.
      parameters:
      - name: fields
        in: query
        schema:
          type: string
        description: 'id (default): The media''s ID.


          text: Represents text for a Threads reply. This is optional on image, video, and carousel replies.


          username: Instagram username who created the post.

          Note: This only works for public users, your own user, and users that you follow.


          permalink: Permanent link to the post. Will be omitted if the media contains copyrighted material or has been flagged for a copyright violation.

          Note: This only works for public users, your own user, and users that you follow.


          timestamp: The publish date and time of the post in ISO 8601 format.


          media_product_type: Surface where the media is published. In the case of Threads, the value is THREADS.


          media_type: The media type for a Threads reply.Values: TEXT_POST, IMAGE, VIDEO, CAROUSEL_ALBUM


          media_url: The posts media URL. This only shows for image, video, and carousel replies.


          shortcode: Shortcode of the media.


          thumbnail_url: URL of thumbnail. This only shows for Threads replies with video.


          children: List of child posts. This only shows for carousel replies.


          has_replies: true if the Threads post or reply has replies that you can see.


          root_post: Media ID of the top-level post or original thread in the reply tree.

          Note: This only appears on replies.


          replied_to: Media ID of the immediate parent of the reply.

          Note: This only appears on replies.


          is_reply: true if the Threads media is a reply. false if the Threads media is a top-level post.


          hide_status: Whether or not the reply is hidden.

          Values: NOT_HUSHED, UNHUSHED, HIDDEN'
        example: '{{fields_replies}}'
      - name: reverse
        in: query
        schema:
          type: boolean
        example: 'false'
      - name: thread_id
        in: path
        schema:
          type: string
        required: true
      responses:
        undefined:
          headers:
            Content-Type:
              schema:
                type: string
                example: application/json
          content:
            application/json:
              schema:
                type: object
              example:
                data:
                - id: string
                  text: reply
                  timestamp: 2024-09-17T20:54:47+0000
                  media_product_type: THREADS
                  media_type: TEXT_POST
                  permalink: string
                  shortcode: string
                  username: string
                  is_quote_post: false
                  has_replies: false
                  is_reply: true
                  is_reply_owned_by_me: false
                  root_post:
                    id: string
                  replied_to:
                    id: string
                paging:
                  cursors:
                    before: string
                    after: string
  /{reply_thread_id}/manage_reply:
    post:
      tags:
      - Read And Manage Threads > Read and Manage Threads Replies
      summary: Hide Replies
      description: Use `POST` /manage_reply [endpoint](https://developers.facebook.com/docs/threads/reply-management#hide-replies) to hide/unhide any top-level replies.
      requestBody:
        content: {}
      parameters:
      - name: hide
        in: query
        schema:
          type: boolean
        example: 'true'
      - name: reply_thread_id
        in: path
        schema:
          type: string
        required: true
      responses:
        undefined:
          headers:
            Content-Type:
              schema:
                type: string
                example: application/json
          content:
            application/json:
              schema:
                type: object
              example:
                success: true
components:
  securitySchemes:
    noauthAuth:
      type: http
      scheme: noauth
    oauth2Auth:
      type: http
      scheme: oauth2