Profile

GET/v1/threads/profile1 credit

Returns a Threads account's public profile: name, biography, follower count, verification, profile pictures, bio links and profile tags.

01Query parameters

Name	Type	Description
handlerequired	string	Threads username, with or without the leading `@` (e.g. `zuck`).
cache_max_ageoptional	string	Accepted for compatibility; every call is fetched fresh, so the value does not change the answer.Accepted values:`1d3d7d14d30d`

02Request

curl "https://api.scrapesocial.ai/v1/threads/profile?handle=zuck" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Responses

Real answers from the API. Lists are shortened to 2 items.

GET /v1/threads/profile?handle=zuck

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "profile_pic_url": "https://scontent.cdninstagram.com/v/t51.82787-19/825322135_17989325280103224_1252773933700107438_n.jpg?stp=dst-jpg_s206x206_tt6&_nc_cat=107&ccb=7-5&_nc_sid=30ff31&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy4xMDgwLkMzIn0%3D&_nc_ohc=FTm6hrIlPgYQ7kNvwFRhpNP&_nc_oc=Ado1_kueOuJIQey3Ea6Qfr8Gh_dIzN9HQ3R2PvG5ji845TY7GnPJDDBxCZKP5BURPfw&_nc_zt=24&_nc_ht=scontent.cdninstagram.com&_nc_gid=FErfRovB62v9ua9f…",
  "friendship_status": null,
  "has_onboarded_to_text_post_app": true,
  "pk": "63055343223",
  "text_post_app_is_private": false,
  "username": "zuck",
  "text_post_app_remove_mention_entrypoint": null,
  "text_app_custom_feeds": null,
  "platform_newsletter_info": null,
  "platform_podcast_info": null,
  "platform_podcast_episode_info": null,
  "follower_count": 5752817,
  "profile_context_facepile_users": null,
  "text_post_app_public_views": null,
  "hd_profile_pic_versions": [
    {
      "height": 320,
      "url": "https://scontent.cdninstagram.com/v/t51.82787-19/825322135_17989325280103224_1252773933700107438_n.jpg?stp=dst-jpg_s320x320_tt6&_nc_cat=107&ccb=7-5&_nc_sid=30ff31&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy4xMDgwLkMzIn0%3D&_nc_ohc=FTm6hrIlPgYQ7kNvwFRhpNP&_nc_oc=Ado1_kueOuJIQey3Ea6Qfr8Gh_dIzN9HQ3R2PvG5ji845TY7GnPJDDBxCZKP5BURPfw&_nc_zt=24&_nc_ht=scontent.cdninstagram.com&_nc_gid=FErfRovB62v9ua9f…",
      "width": 320
    },
    {
      "height": 640,
      "url": "https://scontent.cdninstagram.com/v/t51.82787-19/825322135_17989325280103224_1252773933700107438_n.jpg?stp=dst-jpg_s640x640_tt6&_nc_cat=107&ccb=7-5&_nc_sid=30ff31&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy4xMDgwLkMzIn0%3D&_nc_ohc=FTm6hrIlPgYQ7kNvwFRhpNP&_nc_oc=Ado1_kueOuJIQey3Ea6Qfr8Gh_dIzN9HQ3R2PvG5ji845TY7GnPJDDBxCZKP5BURPfw&_nc_zt=24&_nc_ht=scontent.cdninstagram.com&_nc_gid=FErfRovB62v9ua9f…",
      "width": 640
    }
  ],
  "is_verified": true,
  "biography": "Mostly superintelligence and MMA takes",
  "text_app_biography": {
    "text_fragments": {
      "fragments": [
        {
          "fragment_type": "plaintext",
          "link_fragment": null,
          "mention_fragment": null,
          "plaintext": "Mostly superintelligence and MMA takes",
          "inline_sticker_fragment": null,
          "linkified_web_url": null,
          "linkified_in_app_url": null,
          "styling_info": null
        }
      ]
    }
  },
  "full_name": "Mark Zuckerberg",
  "bio_links": [],
  "profile_tags": {
    "edges": [
      {
        "node": {
          "display_name": "AI Threads",
          "name": "aithreads",
          "id": "18399895213044171",
          "is_community": false,
          "tag_cluster_name": "aithreads",
          "community_favicon_url": "https://scontent.xx.fbcdn.net/v/t1.6435-9/722635384_18590137618044171_7444848202374067606_n.png?_nc_cat=1&ccb=1-7&_nc_sid=b55947&_nc_ohc=dbl2DEsEibYQ7kNvwH5c6ul&_nc_oc=AdonmrPoBdVoO1ojrjC1S55vK2dYH6h3EJSr-xokjwbKbq4FArrvmX7sjwazf6OUXM0&_nc_zt=23&_nc_ht=scontent.xx&_nc_gid=FErfRovB62v9ua9fMWmExw&_nc_ss=7b289&oh=00_AQPqyGDiKGkpr2mJjghGZV4vUYU6gnTmhwvXjo_v8zjSQg&oe=6B05989D"
        }
      },
      {
        "node": {
          "display_name": "UFC Threads",
          "name": "ufcthreads",
          "id": "18398478472015746",
          "is_community": false,
          "tag_cluster_name": "UFCThreads",
          "community_favicon_url": "https://scontent.xx.fbcdn.net/v/t1.6435-9/720341113_18592035976015746_2347788163008503955_n.png?_nc_cat=1&ccb=1-7&_nc_sid=b55947&_nc_ohc=KiwU9KA-B94Q7kNvwGIgsLz&_nc_oc=AdopzzHBs1RKXS-N7yv05Eok_O3qMUi8SveW1qN9pOKFM70dDEycZ8dx__5omxKikW8&_nc_zt=23&_nc_ht=scontent.xx&_nc_gid=FErfRovB62v9ua9fMWmExw&_nc_ss=7b289&oh=00_AQNi4sEcN8J3dVe4e6_S1FOomXR6VxUYfl9zi-ijoXMgag&oe=6B059A1C"
        }
      }
    ]
  },
  "transparency_label": null,
  "show_text_post_app_badge": true,
  "gating": null,
  "id": "63055343223"
}

Common to every endpoint

Any route can answer these: a missing or wrong key, no credits left, the platform not answering, or a failure on our side. None of them costs credits.

GET /v1/cosmos/profile?handle=design

{
  "success": false,
  "message": "Invalid API key"
}

04Notes

`pk` and `id` are the account's numeric id as a string. `friendship_status` is always null. An unknown or private account answers 404, free.

05Errors & credits

Every error has success: false, a real HTTP status and costs no credits.

400missing_parameter
A required parameter is missing or invalid.
403private_account
The account is private or age-restricted.
404not_found
No such account.
503upstream_error
The platform did not answer; retry shortly.