# SocialCrawl API — threads endpoints
# Base URL: https://www.socialcrawl.dev
# Auth: x-api-key header
# Full docs: https://www.socialcrawl.dev/docs/threads

## GET /v1/threads/profile
Get Threads user profile
Credit cost: 1 (standard)
Parameters:
- handle (required) — Threads username without the @ symbol
curl "https://www.socialcrawl.dev/v1/threads/profile?handle=zuck" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/threads/user/posts
List Threads user posts
Credit cost: 1 (standard)
Parameters:
- handle (required) — Threads username without the @ symbol
- trim (optional, boolean) — Set to true for a trimmed down version of the response
curl "https://www.socialcrawl.dev/v1/threads/user/posts?handle=zuck" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/threads/post
Get Threads post details
Credit cost: 1 (standard)
Parameters:
- url (required) — Full URL of the Threads post
- trim (optional, boolean) — Set to true for a trimmed down version of the response
curl "https://www.socialcrawl.dev/v1/threads/post?url=https://www.threads.net/@zuck/post/CwABCDEFGHI" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/threads/search
Search Threads posts
Credit cost: 1 (standard)
Parameters:
- query (required) — Search keyword or phrase to find Threads posts
- start_date (optional, string) — Start date to search for
- end_date (optional, string) — End date to search for
- trim (optional, boolean) — Set to true for a trimmed down version of the response
curl "https://www.socialcrawl.dev/v1/threads/search?query=artificial intelligence" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/threads/search/users
Search Threads users
Credit cost: 1 (standard)
Parameters:
- query (required) — Search keyword or phrase to find Threads users
curl "https://www.socialcrawl.dev/v1/threads/search/users?query=tech" \
  -H "x-api-key: sc_your_api_key_here"