social data api

Threads

Profiles, posts, post details, keyword search and user search.

Account profile	`/v1/threads/profile`	1 request
Posts by an account	`/v1/threads/user/posts`	1 request
Post details	`/v1/threads/post`	1 request
Find posts	`/v1/threads/search`	1 request
Find accounts	`/v1/threads/search/users`	1 request

GET/v1/threads/profile

Account profile

1 request

Returns a Threads account's public profile with username, full_name, biography, profile_pic_url, follower_count, is_verified, bio_links and hd_profile_pic_versions. The is_threads_only_user flag tells you whether the account exists on Threads alone.

Query parameters

`handle` stringrequired	Threads username.
`cache_max_age` string	Accept a stored response up to this age. Inside that window the answer is free and comes back with `cached: true` and a `cached_at` time; past it, the request runs live for 1 request. `1d3d7d14d30d`

curl "https://api.pandorlabs.com/v1/threads/profile?handle=trendspider" \  -H "Authorization: Bearer $PANDORLABS_KEY"

Example response

Response

{
  "success": true,
  "credits_charged": 1,
  "pk": "63496592589",
  "text_post_app_is_private": false,
  "has_onboarded_to_text_post_app": true,
  "friendship_status": null,
  "profile_pic_url": "https://scontent-atl3-2.cdninstagram.com/v/t51.2885-19/483433564_655589117415062_7541542786235693538_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_ht=scontent-atl3-2.cdninstagram.com&_nc_cat=1&_nc_oc=Q6cZ2QHDtD3999Ou4pcMMH7DERwg7b_8MUH39VGHj-ZYaqdB2I3…",
  "username": "sportsillustrated",
  "text_post_app_remove_mention_entrypoint": null,
  "show_text_post_app_replies_tab": true,
  "text_app_custom_feeds": null,
  "gating": null,
  "follower_count": 551296,
  "profile_context_facepile_users": null,
  "hd_profile_pic_versions": [
    {
      "height": 320,
      "url": "https://scontent-atl3-2.cdninstagram.com/v/t51.2885-19/483433564_655589117415062_7541542786235693538_n.jpg?stp=dst-jpg_s320x320_tt6&_nc_ht=scontent-atl3-2.cdninstagram.com&_nc_cat=1&_nc_oc=Q6cZ2QHDtD3999Ou4pcMMH7DERwg7b_8MUH39VGHj-ZYaqdB2I3…",
      "width": 320
    }
  ],
  "is_verified": true,
  "biography": "Sports, sports and more sports.",
  "text_app_biography": {
    "text_fragments": {
      "fragments": [
        {
          "fragment_type": "plaintext",
          "link_fragment": null,
          "mention_fragment": null,
          "plaintext": "Sports, sports and more sports.",
          "tag_fragment": null,
          "linkified_web_url": null
        }
      ]
    }
  },
  "full_name": "Sports Illustrated",
  "bio_links": [
    {
      "url": "https://lnk.bio/sportsillustrated",
      "is_verified": false,
      "link_id": "17882982429146262"
    }
  ],
  "transparency_label": null,
  "is_threads_only_user": false,
  "show_text_post_app_badge": true,
  "id": "63496592589"
}

GET/v1/threads/user/posts

Posts by an account

1 request

Returns a Threads account's latest posts with id, caption text, code, like_count, reshare_count, direct_reply_count, repost_count, image_versions2, video_versions and taken_at. Threads shows logged-out visitors only the newest 20 to 30 posts. Set trim for a lighter payload.

Query parameters

`handle` stringrequired	Threads username.
`trim` boolean	When true, the response is reduced to a lighter payload.

curl "https://api.pandorlabs.com/v1/threads/user/posts?handle=trendspider" \  -H "Authorization: Bearer $PANDORLABS_KEY"

Example response

Response

{
  "success": true,
  "credits_charged": 1,
  "posts": [
    {
      "id": "3656367813102434565_63055343223",
      "pk": "3656367813102434565",
      "caption": {
        "text": "Spoiler alert: We're testing a way for you to hide spoilers in your Threads posts.",
        "pk": "17978979272714446",
        "has_translation": null
      },
      "code": "DK-BydcJHkF",
      "like_count": 96434,
      "taken_at": 1750093031,
      "user": {
        "friendship_status": null,
        "pk": "63055343223",
        "profile_pic_url": "https://scontent-hou1-1.cdninstagram.com/v/t51.2885-19/452737457_1313286386312102_744138929735022550_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_ht=scontent-hou1-1.cdninstagram.com&_nc_cat=1&_nc_oc=Q6cZ2QFGyGWANff-XHjZgOOWs_xNC29qmUTVstyb7y0tS-ajYvJ…",
        "username": "zuck",
        "id": "63055343223",
        "transparency_label": null,
        "transparency_product": null,
        "transparency_product_enabled": false,
        "is_verified": true,
        "text_post_app_is_private": false,
        "has_onboarded_to_text_post_app": true
      },
      "url": "https://www.threads.com/@zuck/post/DK-BydcJHkF"
    }
  ]
}

GET/v1/threads/post

Post details

1 request

Looks up one Threads post from its URL and returns the caption, like_count, view_counts, reshare_count, direct_reply_count, image_versions2 and taken_at, along with comments and related_posts arrays. Set trim for a lighter payload.

Query parameters

`url` stringrequired	Link to the Threads post.
`trim` boolean	When true, the response is reduced to a lighter payload.
`cache_max_age` string	Accept a stored response up to this age. Inside that window the answer is free and comes back with `cached: true` and a `cached_at` time; past it, the request runs live for 1 request. `1d3d7d14d30d`

curl "https://api.pandorlabs.com/v1/threads/post?url=https%3A%2F%2Fwww.threads.com%2F%40trendspider%2Fpost%2FDIU8naHS6q_" \  -H "Authorization: Bearer $PANDORLABS_KEY"

Example response

Response

{
  "success": true,
  "credits_charged": 1,
  "post": {
    "id": "3656367813102434565_63055343223",
    "pk": "3656367813102434565",
    "caption": {
      "text": "Spoiler alert: We're testing a way for you to hide spoilers in your Threads posts.",
      "pk": "17978979272714446",
      "has_translation": null
    },
    "code": "DK-BydcJHkF",
    "like_count": 96439,
    "taken_at": 1750093031,
    "user": {
      "pk": "63055343223",
      "friendship_status": null,
      "profile_pic_url": "https://scontent-hou1-1.cdninstagram.com/v/t51.2885-19/452737457_1313286386312102_744138929735022550_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_ht=scontent-hou1-1.cdninstagram.com&_nc_cat=1&_nc_oc=Q6cZ2QEI0Na315cY5sOYUkhVVibfgPAW-ui7qHsdVtzXBXEOhzW…",
      "username": "zuck",
      "id": "63055343223",
      "full_name": "Mark Zuckerberg",
      "transparency_label": null,
      "transparency_product": null,
      "transparency_product_enabled": false,
      "is_verified": true,
      "text_post_app_is_private": false,
      "has_onboarded_to_text_post_app": true
    }
  },
  "comments": [
    {
      "id": "3658534918151603488_74973899807",
      "pk": "3658534918151603488",
      "caption": {
        "text": "意味分からない",
        "pk": "18306832783208063",
        "has_translation": true
      },
      "code": "DLFuh_SygUg",
      "like_count": 0,
      "taken_at": 1750351370,
      "user": {
        "pk": "74973899807",
        "friendship_status": null,
        "profile_pic_url": "https://scontent-hou1-1.cdninstagram.com/v/t51.2885-19/491446152_17850244230449803_8764028655689505242_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_ht=scontent-hou1-1.cdninstagram.com&_nc_cat=107&_nc_oc=Q6cZ2QEI0Na315cY5sOYUkhVVibfgPAW-ui7qHsdVtzXBXE…",
        "username": "emimimi_0917",
        "id": "74973899807",
        "full_name": "青木恵美",
        "transparency_label": null,
        "transparency_product": null,
        "transparency_product_enabled": false,
        "is_verified": true,
        "text_post_app_is_private": false,
        "has_onboarded_to_text_post_app": true
      }
    }
  ],
  "relatedPosts": [
    {
      "id": "3658572865166656590_63453315755",
      "pk": "3658572865166656590",
      "caption": {
        "text": "Initial findings of investigation into overnight ground explosion of SpaceX Starship rocket in Texas point to failure of a Composite Overwrapped Pressure Vessel (COPV), a lightweight storage tank containing nitrogen under high pressure. 🖥️ …",
        "pk": "18345028147091883",
        "has_translation": null
      },
      "code": "DLF3KMNJERO",
      "like_count": 15,
      "taken_at": 1750355893,
      "user": {
        "pk": "63453315755",
        "friendship_status": null,
        "profile_pic_url": "https://scontent-hou1-1.cdninstagram.com/v/t51.2885-19/402757276_161160320414682_3222955945465557227_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_ht=scontent-hou1-1.cdninstagram.com&_nc_cat=106&_nc_oc=Q6cZ2QGJAk0S-TOHB3ZWl6ci1q6t2XxgndYS-k6upqywpT-gX…",
        "username": "jonathanserrie",
        "id": "63453315755",
        "full_name": "Jonathan Serrie",
        "transparency_label": null,
        "transparency_product": null,
        "transparency_product_enabled": false,
        "is_verified": true,
        "text_post_app_is_private": false,
        "has_onboarded_to_text_post_app": true
      }
    }
  ]
}

GET/v1/threads/search

Find posts

1 request

Finds Threads posts for a keyword. Each hit has caption text, like_count, reshare_count, direct_reply_count, author details and image_versions2. Threads' public search caps every request at 10 results. You can narrow by start_date and end_date and set trim for a lighter payload.

Query parameters

`query` stringrequired	Keyword to look for.
`start_date` string	Earliest post date to include.
`end_date` string	Latest post date to include.
`trim` boolean	When true, the response is reduced to a lighter payload.

curl "https://api.pandorlabs.com/v1/threads/search?query=basketball" \  -H "Authorization: Bearer $PANDORLABS_KEY"

Example response

Response

{
  "success": true,
  "credits_charged": 1,
  "posts": [
    {
      "id": "3658605407757558624_71259204903",
      "pk": "3658605407757558624",
      "caption": {
        "text": "This woman selling mini umbrellas shows love to stray cats & dogs & introduces them. She may not have money but is richer than many.🥹🥹",
        "pk": "18077403781726333",
        "has_translation": null
      },
      "code": "DLF-jv2tmNg",
      "like_count": 5419,
      "taken_at": 1750359780,
      "user": {
        "pk": "71259204903",
        "friendship_status": null,
        "profile_pic_url": "https://scontent-dfw5-2.cdninstagram.com/v/t51.2885-19/501402907_17869607802372904_1939177145792832486_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=1&_nc_oc=Q6cZ2QHQ6tqymzxxWWnD3Y69dUStiwPULqhvwrOx1_1jXHmGE…",
        "username": "mahtabuddinit",
        "id": "71259204903",
        "full_name": "Mahtab Uddin",
        "transparency_label": null,
        "transparency_product": null,
        "transparency_product_enabled": false,
        "is_verified": false,
        "text_post_app_is_private": false,
        "has_onboarded_to_text_post_app": true
      }
    }
  ]
}

GET/v1/threads/search/users

Find accounts

1 request

Looks up Threads accounts by username and returns matches with username, full_name, profile_pic_url, is_verified and pk. Use it to resolve an account before calling the profile or posts endpoints.

Query parameters

query

stringrequired

Username, or part of one, to match.

curl "https://api.pandorlabs.com/v1/threads/search/users?query=shams" \  -H "Authorization: Bearer $PANDORLABS_KEY"

Example response

Response

{
  "success": true,
  "credits_charged": 1,
  "users": [
    {
      "username": "shams",
      "pk": "5951152863",
      "is_active_on_text_post_app": true,
      "full_name": "Shams Charania",
      "profile_pic_url": "https://instagram.flas1-2.fna.fbcdn.net/v/t51.2885-19/482795192_3376548399146227_6340123271493467395_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_ht=instagram.flas1-2.fna.fbcdn.net&_nc_cat=1&_nc_oc=Q6cZ2QGGqXP9vnbg6p9G1kF4lrIwvuvWx0OeJ6C8nPcAyo-_4m8X…",
      "is_verified": true,
      "has_onboarded_to_text_post_app": true,
      "id": "5951152863"
    }
  ]
}