# Scrapier — Threads API > Scrapier endpoints for Threads: Threads Profile Info, Threads Search, Threads Search Users, Threads Single Post and 1 more. Base URL: https://api.scrapier.io/api/v2 · Auth: header `X-API-Key: ` · Synchronous: HTTP 200 returns {"success": true, "data": {...}} · Paginate by sending data.next_cursor back as `cursor` until it is null · Paths keep the trailing slash. Live parameter source (no auth): https://api.scrapier.io/api/v2/endpoints · Docs: https://docs.scrapier.io/api-reference/threads.md ## GET /threads-profile-info/ Threads Profile Info: Structured Threads data: send `usernames`. Single lookup, 1 credit per successful call. Cost: 1 credit per successful call · Pagination: single lookup · Results: data.result Parameters: - usernames (required, string, example trendspider): A Threads username, @handle, profile/post URL or id: (user_id takes bare digits). Single record; next_cursor is always null. - cursor (optional, string): Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page. - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Example: curl "https://api.scrapier.io/api/v2/threads-profile-info/?usernames=trendspider" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/threads/threads-profile-info.md ## GET /threads-search/ Threads Search: Structured Threads data: send `queries`. Cursor-paginated, 1 credit per successful call. Cost: 1 credit per successful call · Pagination: cursor · Results: data.posts Parameters: - queries (required, string, example AI): Threads search term / hashtag / phrase. Required first call. Aliases: search_query, q. - cursor (optional, string): Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page. - sort (optional, string, one of: top|recent, default top, locked in cursor): top | recent. - from (optional, string, locked in cursor): Only keep posts from this username (client-side). - before (optional, string, locked in cursor): Only keep posts before this date (YYYY-MM-DD). - after (optional, string, locked in cursor): Only keep posts after this date (YYYY-MM-DD). - session_id (optional, string): Optional Threads sessionid cookie, resolved fresh on every call (not locked into the cursor). Anonymous still works, capped at one page. - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Example: curl "https://api.scrapier.io/api/v2/threads-search/?queries=AI" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/threads/threads-search.md ## GET /threads-search-users/ Threads Search Users: Structured Threads data: send `queries`. Cursor-paginated, 1 credit per successful call. Cost: 1 credit per successful call · Pagination: cursor · Results: data.engines Parameters: - queries (required, string, example shams): Search text (a handle, a name or a topic) -> the matching Threads accounts as a guest, 12 verified accounts per call in rank order. Required first call, ignored when `cursor` is supplied. - cursor (optional, string): Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page. - include (optional, string, one of: |profile, locked in cursor): 'profile' fills bio / followers / private / ext.bio_link on every row of the page from its profile page. - include_details (optional, boolean, default false, locked in cursor): Older spelling of include=profile (true = the same join). - engines (optional, string, default brave,ddg, locked in cursor): Handle-discovery engines, any of brave / ddg; "" = Threads-only. - engine_pages (optional, integer, default 5, locked in cursor): Brave result pages walked at most per call. - candidate_pool (optional, integer, locked in cursor): Candidates ranked before selection (default max(40, 36 x page)). - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Example: curl "https://api.scrapier.io/api/v2/threads-search-users/?queries=shams" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/threads/threads-search-users.md ## GET /threads-single-post/ Threads Single Post: Structured Threads data: send `urls`. Single lookup, 1 credit per successful call. Cost: 1 credit per successful call · Pagination: single lookup · Results: data.result Parameters: - urls (required, string, example https://www.threads.com/@zuck/post/DdZ7sQvkTFn): A Threads post URL. Single record; next_cursor is always null. - max_comments (optional, integer, default 20): Comments to include (0-50 on v2). - include_nested_replies (optional, boolean, default true): Also fetch replies to comments. - include_related_posts (optional, boolean, default true): Include related posts. - trim (optional, boolean, default true): Compact post object; false = full raw post node. - cursor (optional, string): Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page. - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Example: curl "https://api.scrapier.io/api/v2/threads-single-post/?urls=https%3A%2F%2Fwww.threads.com%2F%40zuck%2Fpost%2FDdZ7sQvkTFn" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/threads/threads-single-post.md ## GET /threads-user-posts/ Threads User Posts: Structured Threads data: send `usernames`. Cursor-paginated, 1 credit per successful call. Cost: 1 credit per successful call · Pagination: cursor · Results: data.posts Parameters: - usernames (required, string, example zuck): Threads username. Required first call; ignored when `cursor` is supplied. - cursor (optional, string): Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page. - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Example: curl "https://api.scrapier.io/api/v2/threads-user-posts/?usernames=zuck" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/threads/threads-user-posts.md