Threads Profile Search

https://api.sandbase.ai/v1/api/threads/web/search-profiles

Searches Threads user profiles based on a specified text query string. Returns matching user accounts and profile information from the platform.

Price
$0.003USD / callFirst 100 calls per day free (shared per organization)
Method
POST
Response
JSON
Parameters
1 required · 0 optional
Production route

Try the model

Playground

Open playground
Input
Search query, for example: mark
OutputExample
Responseoutputs · 9.0 KB · 131 lines
[
  {
    "data": {
      "xdt_api__v1__users__search_connection": {
        "edges": [
          {
            "node": {
              "full_name": "Mark Zuckerberg",
              "has_onboarded_to_text_post_app": true,
              "id": "63055343223",
              "is_active_on_text_post_app": true,
              "is_verified": true,
              "pk": "63055343223",
              "profile_pic_url": "https://scontent-sea5-1.cdninstagram.com/v/t51.82787-19/825322135_17989325280103224_1252773933700107438_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-sea5-1.cdninstagram.com&_nc_cat=100&_nc_oc=Q6cZ2gEQMP0y65Znw4KFouVQfjknMULifv8cyJbRjNjA9Y9szmUvH1OjUE9mUDANdybnebf0CxiwV2T3ypnb1YHqi0eb&_nc_ohc=ImCtHAPyo70Q7kNvwHQCN8Z&_nc_gid=x6mrrZqbeHq1BYO6eTzHxA&edm=AHhEZX8BAAAA&ccb=7-5&oh=00_AQMkSECZSKU5Lc4XR2fOX6qBPT7GYLwFnPxK5Nn91evYbw&oe=6AC1A16B&_nc_sid=e8efdc",
              "username": "zuck"
            }
          },
          {
            "node": {
              "full_name": "Mark Ruffalo",
              "has_onboarded_to_text_post_app": true,
              "id": "63051734071",
              "is_active_on_text_post_app": true,
              "is_verified": true,
              "pk": "63051734071",
              "profile_pic_url": "https://scontent-sea5-1.cdninstagram.com/v/t51.2885-19/459216473_763220509193309_6737924786677683148_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby45OTkuYzIifQ&_nc_ht=scontent-sea5-1.cdninstagram.com&_nc_cat=105&_nc_oc=Q6cZ2gEQMP0y65Znw4KFouVQfjknMULifv8cyJbRjNjA9Y9szmUvH1OjUE9mUDANdybnebf0CxiwV2T3ypnb1YHqi0eb&_nc_ohc=ilVXpvBe4UkQ7kNvwEJw59O&_nc_gid=x6mrrZqbeHq1BYO6eTzHxA&edm=AHhEZX8BAAAA&ccb=7-5&oh=00_AQPtq-5Zairjy0SEv1XMbveObU2CJmhWbUcm8rggtqJeFA&oe=6AC1B0AB&_nc_sid=e8efdc",
              "username": "markruffalo"
            }
          },
          {
            "node": {
              "full_name": "Mark Tuan",
              "has_onboarded_to_text_post_app": true,
              "id": "63281880367",
              "is_active_on_text_post_app": true,
              "is_verified": true,
              "pk": "63281880367",
              "profile_pic_url": "https://scontent-sea5-1.cdninstagram.com/v/t51.2885-19/358197528_292224636703096_3341699124168942009_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-sea5-1.cdninstagram.com&_nc_cat=104&_nc_oc=Q6cZ2gEQMP0y65Znw4KFouVQfjknMULifv8cyJbRjNjA9Y9szmUvH1OjUE9mUDANdybnebf0CxiwV2T3ypnb1YHqi0eb&_nc_ohc=LFwtOM_6coEQ7kNvwGKrBK1&_nc_gid=x6mrrZqbeHq1BYO6eTzHxA&edm=AHhEZX8BAAAA&ccb=7-5&oh=00_AQMU3L1fRvB2BkGwq__P2lRynPnzaxG3XnIbM9vDapn_zQ&oe=6AC1ABA2&_nc_sid=e8efdc",
              "username": "marktuan"
            }
          },
          {
            "node": {
              "full_name": "Mark Chen",
              "has_onboarded_to_text_post_app": true,
              "id": "65048318235",
              "is_active_on_text_post_app": true,
              "is_verified": false,
              "pk": "65048318235",
              "profile_pic_url": "https://scontent-sea5-1.cdninstagram.com/v/t51.82787-19/736396594_17956911558174236_3580075057358488877_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-sea5-1.cdninstagram.com&_nc_cat=108&_nc_oc=Q6cZ2gEQMP0y65Znw4KFouVQfjknMULifv8cyJbRjNjA9Y9szmUvH1OjUE9mUDANdybnebf0CxiwV2T3ypnb1YHqi0eb&_nc_ohc=7fPLY8hSubMQ7kNvwENuBuo&_nc_gid=x6mrrZqbeHq1BYO6eTzHxA&edm=AHhEZX8BAAAA&ccb=7-5&oh=00_AQPBuLH7h_JHlMfdiagoGyvx5aRyNZPj7k6n_DCpg-147Q&oe=6AC1A706&_nc_sid=e8efdc",
              "username": "mark670101"
            }
          },
          {
            "node": {
              "full_name": "Mark Manson",
              "has_onboarded_to_text_post_app": true,
              "id": "63284171229",
              "is_active_on_text_post_app": true,
              "is_verified": true,
              "pk": "63284171229",
              "profile_pic_url": "https://scontent-sea5-1.cdninstagram.com/v/t51.2885-19/496507341_18503900281001816_4893178276614255340_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby43MjAuYzIifQ&_nc_ht=scontent-sea5-1.cdninstagram.com&_nc_cat=1&_nc_oc=Q6cZ2gEQMP0y65Znw4KFouVQfjknMULifv8cyJbRjNjA9Y9szmUvH1OjUE9mUDANdybnebf0CxiwV2T3ypnb1YHqi0eb&_nc_ohc=XAKk-qPOOEsQ7kNvwFhPTgk&_nc_gid=x6mrrZqbeHq1BYO6eTzHxA&edm=AHhEZX8BAAAA&ccb=7-5&oh=00_AQN3fUh0afDB2b5HF5Q-3X5MvuPPwlDO4ulT6tRLZ9Y6QA&oe=6AC1D5B4&_nc_sid=e8efdc",
              "username": "markmanson"
            }
          },
          {
            "node": {
              "full_name": "Mark",
              "has_onboarded_to_text_post_app": true,
              "id": "41846714351",
              "is_active_on_text_post_app": true,
              "is_verified": false,
              "pk": "41846714351",
              "profile_pic_url": "https://scontent-sea5-1.cdninstagram.com/v/t51.82787-19/777298001_18081551123394352_2622340824211099121_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-sea5-1.cdninstagram.com&_nc_cat=104&_nc_oc=Q6cZ2gEQMP0y65Znw4KFouVQfjknMULifv8cyJbRjNjA9Y9szmUvH1OjUE9mUDANdybnebf0CxiwV2T3ypnb1YHqi0eb&_nc_ohc=yumk2R_0CgYQ7kNvwEU5Wm7&_nc_gid=x6mrrZqbeHq1BYO6eTzHxA&edm=AHhEZX8BAAAA&ccb=7-5&oh=00_AQMmj3QPBZLQt80y2vn0qV5-tyV98jPruuSrTyq2WUJXQw&oe=6AC1B0DD&_nc_sid=e8efdc",
              "username": "mark42836"
            }
          },
          {
            "node": {
              "full_name": "Markas Event Jabodetabek",
              "has_onboarded_to_text_post_app": true,
              "id": "63121109242",
              "is_active_on_text_post_app": true,
              "is_verified": false,
              "pk": "63121109242",
              "profile_pic_url": "https://scontent-sea5-1.cdninstagram.com/v/t51.82787-19/728930016_17970014181109243_8164361249838455295_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby40ODAuYzIifQ&_nc_ht=scontent-sea5-1.cdninstagram.com&_nc_cat=107&_nc_oc=Q6cZ2gEQMP0y65Znw4KFouVQfjknMULifv8cyJbRjNjA9Y9szmUvH1OjUE9mUDANdybnebf0CxiwV2T3ypnb1YHqi0eb&_nc_ohc=rWmrBmN03uIQ7kNvwGzjqGH&_nc_gid=x6mrrZqbeHq1BYO6eTzHxA&edm=AHhEZX8BAAAA&ccb=7-5&oh=00_AQMmTT9JScUBjra4jS7nNjvIQy83_lorLH9wP3MWoFnVfQ&oe=6AC1BF73&_nc_sid=e8efdc",
              "username": "markas_event"
            }
          },
          {
            "node": {
              "full_name": "Mark",
              "has_onboarded_to_text_post_app": true,
              "id": "64714806805",
              "is_active_on_text_post_app": true,
              "is_verified": false,
              "pk": "64714806805",
              "profile_pic_url": "https://scontent-sea5-1.cdninstagram.com/v/t51.82787-19/792595231_17967257154158806_895883443916059610_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-sea5-1.cdninstagram.com&_nc_cat=110&_nc_oc=Q6cZ2gEQMP0y65Znw4KFouVQfjknMULifv8cyJbRjNjA9Y9szmUvH1OjUE9mUDANdybnebf0CxiwV2T3ypnb1YHqi0eb&_nc_ohc=ywhFLQydd8EQ7kNvwHm3pVX&_nc_gid=x6mrrZqbeHq1BYO6eTzHxA&edm=AHhEZX8BAAAA&ccb=7-5&oh=00_AQM96oCBxHti4uN4HuZTuH1AkhZG57dM8XsmvXYcsz_jKA&oe=6AC1C9D1&_nc_sid=e8efdc",
              "username": "mark_lupercal"
            }
          },
          {
            "node": {
              "full_name": "Mark Johnson",
              "has_onboarded_to_text_post_app": true,
              "id": "80424522547",
              "is_active_on_text_post_app": true,
              "is_verified": false,
              "pk": "80424522547",
              "profile_pic_url": "https://scontent-sea5-1.cdninstagram.com/v/t51.82787-19/707809027_17868611490682548_3636981284146854944_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-sea5-1.cdninstagram.com&_nc_cat=100&_nc_oc=Q6cZ2gEQMP0y65Znw4KFouVQfjknMULifv8cyJbRjNjA9Y9szmUvH1OjUE9mUDANdybnebf0CxiwV2T3ypnb1YHqi0eb&_nc_ohc=31O0ybyh_1sQ7kNvwGZxL9p&_nc_gid=x6mrrZqbeHq1BYO6eTzHxA&edm=AHhEZX8BAAAA&ccb=7-5&oh=00_AQPAqh9A0qCNOvd7IgzSKCnmYYY1mgP5Co5Nj8FCcU7-FA&oe=6AC1D3D9&_nc_sid=e8efdc",
              "username": "mark642121"
            }
          },
          {
            "node": {
              "full_name": "Mark",
              "has_onboarded_to_text_post_app": true,
              "id": "63433010180",
              "is_active_on_text_post_app": true,
              "is_verified": false,
              "pk": "63433010180",
              "profile_pic_url": "https://scontent-sea5-1.cdninstagram.com/v/t51.2885-19/358032416_1621017051729183_779350996420810666_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-sea5-1.cdninstagram.com&_nc_cat=103&_nc_oc=Q6cZ2gEQMP0y65Znw4KFouVQfjknMULifv8cyJbRjNjA9Y9szmUvH1OjUE9mUDANdybnebf0CxiwV2T3ypnb1YHqi0eb&_nc_ohc=g4v495Y0EBwQ7kNvwEU9SYg&_nc_gid=x6mrrZqbeHq1BYO6eTzHxA&edm=AHhEZX8BAAAA&ccb=7-5&oh=00_AQMgbolcxUGocV2yvj7k6gAZSjCdaG5n5hm26ty5Bqnl_Q&oe=6AC1AACA&_nc_sid=e8efdc",
              "username": "mark25tw88"
            }
          }
        ],
        "inform_module": null
      }
    }
  }
]

Examples

Select an example to load its inputs and result into the playground.

Model card

Specifications

Pricing

Base price
$0.003 / run
Daily free calls
First 100 calls per day free (shared per organization)

Request & response

Method
POST
Request body
application/json
Response
application/json
Execution
sync

Parameters

query
string · required

Access

Provider
Threads
API
Platform API
Base URL
https://api.sandbase.ai
Endpoint
/v1/api/threads/web/search-profiles
Authentication
Bearer API key

API README

Threads Profile Search API

Look up Threads user profiles by supplying a text search term via the query parameter.

Use cases

  • Find relevant Threads accounts matching brand or organization names.
  • Discover user profiles based on specific keywords or handles.
  • Locate public figures and creators across the Threads network.

Request

curl -X POST "https://api.sandbase.ai/v1/api/threads/web/search-profiles" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "OpenAI"}'

Parameters

NameTypeRequiredDescription
querystringYesSearch query, for example: mark

Notes

  • The query parameter specifies the text search term, such as a name or handle.

Related APIs

Start building

Send your first request

Platform API endpoint with unified authentication and usage tracking.

Production API
Platform API endpoint
https://api.sandbase.ai/v1/api/threads/web/search-profiles
Authorization header
Authorization: Bearer $SANDBASE_API_KEY
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
  -X POST "https://api.sandbase.ai/v1/api/threads/web/search-profiles" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "query": "mark"
}
SANDBASE_JSON
)
printf '%s\n' "$result"

Explore more

Related APIs

All APIs
APIPriceResponseReleased
Threads$0.003 per callJSONJul 31, 2026
Threads$0.003 per callJSONJul 31, 2026
Threads$0.003 per callJSONJul 31, 2026
Threads$0.003 per callJSONJul 31, 2026
Threads$0.003 per callJSONJul 31, 2026
Threads$0.003 per callJSONJul 31, 2026

Questions

FAQ

How do I use the Threads Profile Search API?

Send a POST request to https://api.sandbase.ai/v1/api/threads/web/search-profiles with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

How much does the Threads Profile Search API cost?

$0.003 per call. Every organization gets 100 free calls per UTC day, shared across eligible SandBase APIs including this one; after that each call is billed at this price from your SandBase balance. There is no subscription.

What parameters does the Threads Profile Search API accept?

Required: query (string). The Parameters table and the Playground on this page list every field.

What does the Threads Profile Search API return?

A JSON response returned in the same HTTP request (synchronous).

Do I need a Threads developer account or API key?

No. Threads Profile Search runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for Threads API access separately.