Search Posts

GET/v1/threads/search1 credit

Searches Threads posts by keyword and returns the matching posts with their author, media and engagement counts.

01Query parameters

Name	Type	Description
queryrequired	string	Search keywords.
start_dateoptional	string	Only posts published on or after this date, as `YYYY-MM-DD`.
end_dateoptional	string	Only posts published on or before this date, as `YYYY-MM-DD`.
trimoptional	boolean	`true` returns a slimmer item with only `id`, `pk`, `caption`, `code`, `like_count`, `taken_at`, `user` and `url`.Default: `false`

02Request

curl "https://api.scrapesocial.ai/v1/threads/search?query=basketball" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Responses

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

GET /v1/threads/search?query=basketball

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "posts": [
    {
      "id": "4015857072844542616_70806950121",
      "logging_info_token": null,
      "pk": "4015857072844542616",
      "user": {
        "pk": "70806950121",
        "profile_pic_url": "https://scontent-ham3-1.cdninstagram.com/v/t51.82787-19/862574990_17943459261366122_7890835591467971996_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-ham3-1.cdninstagram.com&_nc_cat=102&_nc_oc=Q6cZ2gGQdJOzehOizAp7Qo69AXM7QWvW_vLrWi5RZKq5ZrA6OtS1wUbGU6JR2a3xGHUpIL-WamoWVMlb_RmN4YYyMD7M&_nc_ohc=rAzhD4qTzVQQ7kNvwG_vWlE&_nc_gid=YKrBZVsLl…",
        "hd_profile_pic_versions": null,
        "username": "troublewithteri",
        "friendship_status": null,
        "id": "70806950121",
        "full_name": "Teri Cain",
        "transparency_label": null,
        "transparency_product": null,
        "transparency_product_enabled": false,
        "is_verified": false,
        "has_onboarded_to_text_post_app": true,
        "text_post_app_is_private": false
      },
      "text_post_app_info": {
        "show_header_follow": false,
        "id": "XDTTextPostAppMediaInfo:18030389324692412",
        "self_thread_info": null,
        "is_spoiler_media": false,
        "is_markup": false,
        "ghost_post_exp_time_ms": null,
        "ghost_post_approximate_like_count_str": null,
        "ghost_post_reply_type": null,
        "ghost_post_approximate_reply_count_str": null,
        "is_ghost_post": false,
        "direct_reply_count": 0,
        "repost_count": 0,
        "quote_count": 0,
        "reshare_count": null,
        "custom_feed_preview_info": null,
        "platform_podcast_episode_info": null,
        "platform_podcast_info": null,
        "link_preview_attachment": null,
        "link_preview_response": null,
        "linked_inline_media": null,
        "snippet_attachment_info": null,
        "game_score_share_info": null,
        "public_view_count_card_attachment_info": null,
        "special_effects_enabled_str": "",
        "algo_tweaks_info": null,
        "text_fragments": {
          "fragments": [
            {
              "fragment_type": "plaintext",
              "link_fragment": null,
              "mention_fragment": null,
              "plaintext": "Nothing says basketball than KU!",
              "looking_for_recs_fragment": null,
              "inline_sticker_fragment": null,
              "linkified_web_url": null,
              "linkified_in_app_url": null,
              "styling_info": null
            }
          ]
        },
        "share_info": {
          "quoted_attachment_author_attribution_allowed": true,
          "quoted_attachment_post_unavailable": false,
          "quoted_attachment_post": null,
          "quoted_post": null,
          "reposted_post": null
        },
        "is_reply": false,
        "reply_to_author": null,
        "system_status_message": null,
        "reply_control": "everyone",
        "private_reply_partner": null,
        "self_thread_count": 0,
        "tag_header": null,
        "root_post_author": null,
        "is_liked_by_root_author": false,
        "pinned_post_info": {
          "is_pinned_to_parent_post": false,
          "is_pinned_to_profile": false
        },
        "related_trends_info": null,
        "is_post_unavailable": false,
        "post_unavailable_reason": null,
        "post_tombstone_info": null,
        "hush_info": null
      },
      "is_paid_partnership": false,
      "audio": null,
      "caption": {
        "text": "Nothing says basketball than KU!",
        "has_translation": null,
        "pk": "18030389336692412",
        "text_translation": null
      },
      "caption_is_edited": false,
      "transcription_data": null,
      "carousel_media": null,
      "code": "De7MLsXo5KY",
      "image_versions2": {
        "candidates": [
          {
            "height": 4032,
            "url": "https://scontent-ham3-1.cdninstagram.com/v/t51.82787-15/866658519_17943845559366122_5851275639873775991_n.jpg?stp=cp6_dst-jpegr_e35_tt6&_nc_cat=111&ig_cache_key=NDAxNTg1NzA3Mjg0NDU0MjYxNg%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkZFRUQueHBpZHMuMzAyNC5oZHIucmVndWxhcl9waG90by5DMyJ9&_nc_ohc=btHQWU7WpFMQ7kNvwF3OGWN&_nc_oc=AdpRoR_XID5YkyOY6Q69THy19mPedT53plaMkETbWYuFMetjKovr-MP6Ic…",
            "width": 3024
          },
          {
            "height": 1440,
            "url": "https://scontent-ham3-1.cdninstagram.com/v/t51.82787-15/866658519_17943845559366122_5851275639873775991_n.jpg?stp=cp6_dst-jpegr_e35_p1080x1080_tt6&_nc_cat=111&ig_cache_key=NDAxNTg1NzA3Mjg0NDU0MjYxNg%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkZFRUQueHBpZHMuMzAyNC5oZHIucmVndWxhcl9waG90by5DMyJ9&_nc_ohc=btHQWU7WpFMQ7kNvwF3OGWN&_nc_oc=AdpRoR_XID5YkyOY6Q69THy19mPedT53plaMkETbWYuFMet…",
            "width": 1080
          }
        ]
      },
      "original_height": 4032,
      "original_width": 3024,
      "accessibility_caption": null,
      "usertags": null,
      "video_versions": null,
      "has_audio": null,
      "media_type": 1,
      "caption_add_on": null,
      "like_count": 0,
      "giphy_media_info": null,
      "media_overlay_info": null,
      "metaPlace": null,
      "meta_place": null,
      "gen_ai_detection_method": {
        "detection_method": "NONE"
      },
      "taken_at": 1792947490,
      "organic_tracking_token": "eyJ2ZXJzaW9uIjo2LCJwYXlsb2FkIjp7ImlzX2FuYWx5dGljc190cmFja2VkIjp0cnVlLCJ1dWlkIjoiQUZBOFRqcHFxNDVGR0RtVENJLWxpb0E0MDE1ODU3MDcyODQ0NTQyNjE2Iiwic2VydmVyX3Rva2VuIjoiMTc5Mjk0ODQwMDMxMXw0MDE1ODU3MDcyODQ0NTQyNjE2fDcwODA2OTUwMTIxfGE5OTNjMzFmNDhkMGI1OTUyZTFkMmViNmIxYTVkNjJjODE3YWYzNTYzYzc5ZmU3NjQ2ZTFjMGIwNmYxODg5M2MifSwic2lnbmF0dXJlIjoiIn0=",
      "canonical_url": null,
      "like_and_view_counts_disabled": false,
      "url": "https://www.threads.com/@troublewithteri/post/De7MLsXo5KY"
    },
    {
      "id": "3464874471485134661_63948789872",
      "logging_info_token": null,
      "pk": "3464874471485134661",
      "user": {
        "pk": "63948789872",
        "profile_pic_url": "https://scontent-ham3-1.cdninstagram.com/v/t51.2885-19/414153934_762101129295456_1841155951604939466_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-ham3-1.cdninstagram.com&_nc_cat=100&_nc_oc=Q6cZ2gGQdJOzehOizAp7Qo69AXM7QWvW_vLrWi5RZKq5ZrA6OtS1wUbGU6JR2a3xGHUpIL-WamoWVMlb_RmN4YYyMD7M&_nc_ohc=jjLSs-jAysYQ7kNvwE9t8ZL&_nc_gid=YKrBZVsLlYrU…",
        "hd_profile_pic_versions": null,
        "username": "dania_maffezzoli",
        "friendship_status": null,
        "id": "63948789872",
        "full_name": "Dania Maffezzoli",
        "transparency_label": null,
        "transparency_product": null,
        "transparency_product_enabled": false,
        "is_verified": false,
        "has_onboarded_to_text_post_app": true,
        "text_post_app_is_private": false
      },
      "text_post_app_info": {
        "show_header_follow": false,
        "id": "XDTTextPostAppMediaInfo:18063483331630143",
        "self_thread_info": null,
        "is_spoiler_media": false,
        "is_markup": false,
        "ghost_post_exp_time_ms": null,
        "ghost_post_approximate_like_count_str": null,
        "ghost_post_reply_type": null,
        "ghost_post_approximate_reply_count_str": null,
        "is_ghost_post": false,
        "direct_reply_count": 12,
        "repost_count": 3,
        "quote_count": 0,
        "reshare_count": 1,
        "custom_feed_preview_info": null,
        "platform_podcast_episode_info": null,
        "platform_podcast_info": null,
        "link_preview_attachment": null,
        "link_preview_response": null,
        "linked_inline_media": null,
        "snippet_attachment_info": null,
        "game_score_share_info": null,
        "public_view_count_card_attachment_info": null,
        "special_effects_enabled_str": "",
        "algo_tweaks_info": null,
        "text_fragments": {
          "fragments": [
            {
              "fragment_type": "plaintext",
              "link_fragment": null,
              "mention_fragment": null,
              "plaintext": "❤️🏀basketball",
              "looking_for_recs_fragment": null,
              "inline_sticker_fragment": null,
              "linkified_web_url": null,
              "linkified_in_app_url": null,
              "styling_info": null
            }
          ]
        },
        "share_info": {
          "quoted_attachment_author_attribution_allowed": true,
          "quoted_attachment_post_unavailable": false,
          "quoted_attachment_post": null,
          "quoted_post": null,
          "reposted_post": null
        },
        "is_reply": false,
        "reply_to_author": null,
        "system_status_message": null,
        "reply_control": "everyone",
        "private_reply_partner": null,
        "self_thread_count": 0,
        "tag_header": {
          "display_name": "basketball",
          "id": "18398079463034437",
          "is_community": false,
          "tag_cluster_name": "basketball",
          "community_favicon_url": null,
          "community_emoji": null
        },
        "root_post_author": null,
        "is_liked_by_root_author": false,
        "pinned_post_info": {
          "is_pinned_to_parent_post": false,
          "is_pinned_to_profile": false
        },
        "related_trends_info": null,
        "is_post_unavailable": false,
        "post_unavailable_reason": null,
        "post_tombstone_info": null,
        "hush_info": null
      },
      "is_paid_partnership": false,
      "audio": null,
      "caption": {
        "text": "❤️🏀basketball",
        "has_translation": null,
        "pk": "18063483334630143",
        "text_translation": null
      },
      "caption_is_edited": false,
      "transcription_data": null,
      "carousel_media": null,
      "code": "DAVtPlgMNdF",
      "image_versions2": {
        "candidates": [
          {
            "height": 2004,
            "url": "https://scontent-ham3-1.cdninstagram.com/v/t51.82787-15/626828883_18111535171630143_6328745852774205846_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=101&ig_cache_key=MzQ2NDg3NDQ3MTQ4NTEzNDY2MQ%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkZFRUQueHBpZHMuMTQ0MC5zZHIucmVndWxhcl9waG90by5DMyJ9&_nc_ohc=yG3b6y6lJoIQ7kNvwG0V343&_nc_oc=AdryX7dSERH0k7ASkLCwEgQGeKBF8g-mpoOSt7M6xjJ9wkZ-mQHuATkpgGZdH8UU…",
            "width": 1440
          },
          {
            "height": 1503,
            "url": "https://scontent-ham3-1.cdninstagram.com/v/t51.82787-15/626828883_18111535171630143_6328745852774205846_n.jpg?stp=dst-jpg_e35_p1080x1080_tt6&_nc_cat=101&ig_cache_key=MzQ2NDg3NDQ3MTQ4NTEzNDY2MQ%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkZFRUQueHBpZHMuMTQ0MC5zZHIucmVndWxhcl9waG90by5DMyJ9&_nc_ohc=yG3b6y6lJoIQ7kNvwG0V343&_nc_oc=AdryX7dSERH0k7ASkLCwEgQGeKBF8g-mpoOSt7M6xjJ9wkZ-mQHuA…",
            "width": 1080
          }
        ]
      },
      "original_height": 2004,
      "original_width": 1440,
      "accessibility_caption": null,
      "usertags": null,
      "video_versions": null,
      "has_audio": null,
      "media_type": 1,
      "caption_add_on": null,
      "like_count": 573,
      "giphy_media_info": null,
      "media_overlay_info": null,
      "metaPlace": null,
      "meta_place": null,
      "gen_ai_detection_method": {
        "detection_method": "NONE"
      },
      "taken_at": 1727265245,
      "organic_tracking_token": "eyJ2ZXJzaW9uIjo2LCJwYXlsb2FkIjp7ImlzX2FuYWx5dGljc190cmFja2VkIjp0cnVlLCJ1dWlkIjoiQUZBOFRqcHFxNDVGR0RtVENJLWxpb0EzNDY0ODc0NDcxNDg1MTM0NjYxIiwic2VydmVyX3Rva2VuIjoiMTc5Mjk0ODQwMDM0OXwzNDY0ODc0NDcxNDg1MTM0NjYxfDYzOTQ4Nzg5ODcyfGE3YjI5NzQyMjc0ODE5MDYzOTgzOWVkNjhjYzdhNjhhYzYxNmViZmIxM2M0YmIzNjZmNTJjNzg2NmUyN2RkYjYifSwic2lnbmF0dXJlIjoiIn0=",
      "canonical_url": null,
      "like_and_view_counts_disabled": false,
      "url": "https://www.threads.com/@dania_maffezzoli/post/DAVtPlgMNdF"
    }
  ]
}

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

About 15 to 20 posts, in `posts`, each post at most once. There is no paging: one call returns one batch. The dates filter the posts the search finds, which are mostly recent, so a window in the past may return few or no posts. A date not in `YYYY-MM-DD` form is a 400. No matches = an empty list for 0 credits. `user.hd_profile_pic_versions` is always null here.

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.