# Social Fetch API - Threads endpoints
# Base URL: https://api.socialfetch.dev
# Auth: x-api-key header (sfk_...)
# Full catalog: https://www.socialfetch.dev/llms-endpoints.txt | JSON: https://www.socialfetch.dev/llms.json
# Docs hub: https://www.socialfetch.dev/docs/api | OpenAPI: https://www.socialfetch.dev/openapi.json

5 documented Threads operations. Do not invent paths - only the routes below (and their linked markdown pages) are supported.

## GET /v1/threads/profiles/{handle}
Get Threads profile
Credit cost: 1 credit per successful request.
Docs: https://www.socialfetch.dev/docs/api/v1/threads/profiles/handle/get.mdx
SDK: client.threads.getProfile({ handle })
Parameters:
- handle (required, string) - Threads handle to look up, with or without a leading @.
Outcome field: `data.lookupStatus` in `found`, `private`, `not_found`
curl "https://api.socialfetch.dev/v1/threads/profiles/charlidamelio" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/threads/profiles/{handle}/posts
List Threads profile posts
Credit cost: 1 credit per successful request.
Docs: https://www.socialfetch.dev/docs/api/v1/threads/profiles/handle/posts/get.mdx
SDK: client.threads.getProfilePosts({ handle, trim? })
Parameters:
- handle (required, string) - Threads handle whose posts should be listed.
- trim (optional, boolean) - When true, returns a smaller response with fewer post fields when available.
Outcome field: `data.lookupStatus` in `found`, `not_found`
Empty results: `lookupStatus: found` means the handle resolved; `data.posts` may still be empty.
curl "https://api.socialfetch.dev/v1/threads/profiles/charlidamelio/posts" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/threads/search
Search Threads posts
Credit cost: 1 credit per successful request.
Docs: https://www.socialfetch.dev/docs/api/v1/threads/search/get.mdx
SDK: client.threads.search({ query })
Parameters:
- query (required, string) - Search query text for public Threads posts.
- startDate (optional, string) - Optional start date filter in YYYY-MM-DD format.
- endDate (optional, string) - Optional end date filter in YYYY-MM-DD format.
- trim (optional) - Whether to request a smaller response shape when available.
curl "https://api.socialfetch.dev/v1/threads/search?query=basketball" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/threads/posts
Get Threads post
Credit cost: 1 credit per successful request.
Docs: https://www.socialfetch.dev/docs/api/v1/threads/posts/get.mdx
SDK: client.threads.getPost({ url })
Parameters:
- url (required, string) - Link to the Threads post.
- trim (optional) - When true, returns a smaller response with fewer fields.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/threads/posts?url=https://www.threads.net/@zuck/post/DK-BydcJHkF" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/threads/users/search
Search Threads users
Credit cost: 1 credit per successful request.
Docs: https://www.socialfetch.dev/docs/api/v1/threads/users/search/get.mdx
SDK: client.threads.searchUsers({ query })
Parameters:
- query (required, string) - Search query text for Threads users.
curl "https://api.socialfetch.dev/v1/threads/users/search?query=shams" \
  -H "x-api-key: YOUR_API_KEY"