Skip to Content
API ReferenceThreads

Threads API

Meta’s text-based social platform.

  • Post IDs: Use the shortcode (e.g. DQt-ox3kdE4) or numeric ID
  • User lookup: Use username for all user endpoints (profile, posts, replies)
  • Pagination: Use the cursor value from the previous response to fetch the next page
  • Fixed result counts: Most list endpoints return ~15 results for search, ~10 for user posts/replies

Posts

GET /threads/posts/:id — 2 credits (4 with mode=full)

Get a single post by shortcode or ID.

ParamTypeRequiredDefaultDescription
idstringYes—Threads post shortcode or numeric ID
modestringNo—full (includes view counts)
curl -H "x-api-key: sk_byc_xxx" \
  https://api.bycrawl.com/threads/posts/DQt-ox3kdE4

Response

{
  "id": "3759936745132642616",
  "mediaId": "18062699315155466",
  "code": "DQt-ox3kdE4",
  "text": "Priscilla and I started CZI almost 10 years ago...",
  "user": {
    "id": "314216",
    "username": "zuck",
    "profilePic": "https://...",
    "isVerified": true
  },
  "media": [],
  "views": null,
  "stats": {
    "likes": 818,
    "replies": 927,
    "quotes": 16,
    "reposts": 112,
    "shares": 119
  },
  "createdAt": "2025-11-06T14:30:09.000Z",
  "replyTo": null,
  "threadChain": [],
  "isReply": false
}

GET /threads/posts?ids=a,b,c — 2 credits per item (4 per item with mode=full)

Batch get multiple posts. Supports same mode query param.

ParamTypeRequiredDefaultDescription
idsstringYes—Comma-separated post IDs or shortcodes
modestringNo—full (includes view counts)
curl -H "x-api-key: sk_byc_xxx" \
  "https://api.bycrawl.com/threads/posts?ids=DQt-ox3kdE4,DQEmdfkkSNE&mode=full"

Response

[
  {
    "id": "3759936745132642616",
    "mediaId": "18062699315155466",
    "code": "DQt-ox3kdE4",
    "text": "Priscilla and I started CZI almost 10 years ago...",
    "user": {
      "id": "314216",
      "username": "zuck",
      "profilePic": "https://...",
      "isVerified": true
    },
    "media": [],
    "views": null,
    "stats": {
      "likes": 818,
      "replies": 927,
      "quotes": 16,
      "reposts": 112,
      "shares": 119
    },
    "createdAt": "2025-11-06T14:30:09.000Z",
    "replyTo": null,
    "threadChain": [],
    "isReply": false
  }
  // ...more items
]

GET /threads/posts/search?q=xxx — 3 credits (flat rate)

Search posts by keyword. Returns ~15 posts per request.

ParamTypeRequiredDefaultDescription
qstringYes—Search keyword
search_typestringNotopSort order: top or recent
cursorstringNo—Pagination cursor
curl -H "x-api-key: sk_byc_xxx" \
  "https://api.bycrawl.com/threads/posts/search?q=threads&search_type=recent"

Response

{
  "posts": [
    {
      "id": "3847614751430661572",
      "mediaId": "17913742854319868",
      "code": "DVleTsbk9XE",
      "text": "Artists! Show me your most recent artwork!...",
      "user": {
        "id": "63436967516",
        "username": "koshino.yoshihiro",
        "profilePic": "https://...",
        "isVerified": true
      },
      "media": [],
      "stats": {
        "likes": 41,
        "replies": 118,
        "quotes": 0,
        "reposts": 0,
        "shares": 0
      },
      "createdAt": "2026-03-07T13:50:42.000Z"
    }
    // ...more items
  ],
  "pageInfo": {
    "hasNextPage": false,
    "endCursor": null
  }
}

Users

GET /threads/users/:username — 2 credits

Get user profile.

ParamTypeRequiredDefaultDescription
usernamestringYes—Threads username
curl -H "x-api-key: sk_byc_xxx" \
  https://api.bycrawl.com/threads/users/zuck

Response

{
  "id": "314216",
  "username": "zuck",
  "fullName": "Mark Zuckerberg",
  "profilePic": "https://...",
  "hdProfilePic": [
    { "width": 320, "height": 320, "url": "https://..." },
    { "width": 640, "height": 640, "url": "https://..." }
  ],
  "bio": "I build stuff",
  "isVerified": true,
  "followerCount": 5439848,
  "followingCount": 0
}

GET /threads/users/:username/posts — 2 credits

Get a user’s posts. Use cursor from previous response for pagination.

ParamTypeRequiredDefaultDescription
usernamestringYes—Threads username
countintegerNo10Number of posts to return
cursorstringNo—Pagination cursor
curl -H "x-api-key: sk_byc_xxx" \
  https://api.bycrawl.com/threads/users/zuck/posts

Response

{
  "posts": [
    {
      "id": "3759936745132642616",
      "mediaId": "18062699315155466",
      "code": "DQt-ox3kdE4",
      "text": "Priscilla and I started CZI almost 10 years ago...",
      "user": {
        "id": "314216",
        "username": "zuck",
        "profilePic": "https://...",
        "isVerified": true
      },
      "media": [],
      "stats": {
        "likes": 818,
        "replies": 927,
        "quotes": 16,
        "reposts": 112,
        "shares": 119
      },
      "createdAt": "2025-11-06T14:30:09.000Z",
      "isReply": false
    }
    // ...more items
  ],
  "cursor": "eyJpZCI6IjM3NTk5MzY3NDUxMzI2NDI2MTYifQ==",
  "hasMore": true
}

GET /threads/users/:username/replies — 2 credits

Get a user’s replies.

ParamTypeRequiredDefaultDescription
usernamestringYes—Threads username
countintegerNo10Number of replies to return
cursorstringNo—Pagination cursor

Response

{
  "replies": [
    {
      "id": "3847150142294366101",
      "code": "DVj0qvdDJeV",
      "text": "Reply content from the user...",
      "user": {
        "id": "314216",
        "username": "zuck",
        "profilePic": "https://...",
        "isVerified": true
      },
      "media": [],
      "stats": {
        "likes": 42,
        "replies": 3,
        "quotes": 0,
        "reposts": 2,
        "shares": 0
      },
      "createdAt": "2026-03-06T22:27:36.000Z",
      "isReply": true,
      "replyTo": {
        "id": "3847000000000000000",
        "username": "otheruser"
      }
    }
    // ...more items
  ],
  "cursor": "eyJpZCI6IjM4NDcxNTAxNDIyOTQzNjYxMDEifQ==",
  "hasMore": true
}

GET /threads/users/search?q=xxx — 2 credits

Search users by username or name.

ParamTypeRequiredDefaultDescription
qstringYes—Search query

Response

{
  "users": [
    {
      "id": "314216",
      "username": "zuck",
      "fullName": "Mark Zuckerberg",
      "profilePic": "https://...",
      "isVerified": null
    },
    {
      "id": "43015418666",
      "username": "zuckubus",
      "fullName": "Memes | Comedy | Entertainment",
      "profilePic": "https://...",
      "isVerified": null
    }
    // ...more items
  ]
}

Feed

GET /threads/feed/public — 2 credits

Get public For You feed.

ParamTypeRequiredDefaultDescription
cursorstringNo—Pagination cursor
countrystringNoTWCountry code

Response

{
  "posts": [
    {
      "id": "3847150142294366101",
      "code": "DVj0qvdDJeV",
      "text": "Why they ain't got on no white gloves touching...",
      "user": {
        "id": "63446067958",
        "username": "candicebenbow",
        "fullName": "Candice Marie Benbow",
        "profilePic": "https://...",
        "isVerified": true
      },
      "stats": {
        "likes": 42,
        "replies": 3,
        "reposts": 2,
        "quotes": 0
      },
      "createdAt": "2026-03-06T22:27:36.000Z",
      "media": [
        {
          "type": "image",
          "url": "https://..."
        }
      ]
    }
    // ...more items
  ],
  "pageInfo": {
    "hasNextPage": true,
    "endCursor": "GvYXhISXmf2v0-NqjpamyfuGoORq..."
  }
}

GET /threads/feed — 2 credits

Get personalized feed. Requires authentication headers.

ParamTypeRequiredDefaultDescription
cursorstringNo—Pagination cursor
countintegerNo10Number of results
OverviewFacebook