# Social Fetch API - Bluesky 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

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

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

## GET /v1/bluesky/profiles/{handle}/posts
List Bluesky profile posts
Credit cost: 1 credit per successful request.
Docs: https://www.socialfetch.dev/docs/api/v1/bluesky/profiles/handle/posts/get.mdx
SDK: client.bluesky.getProfilePosts({ handle })
Parameters:
- handle (required, string) - Bluesky handle whose posts should be listed.
- cursor (optional, string) - Pagination cursor returned by a previous response.
- userId (optional, string) - Optional Bluesky user id to speed up the request.
Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/bluesky/profiles/espn.com/posts" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/bluesky/posts
Get Bluesky post
Credit cost: 1 credit per successful request.
Docs: https://www.socialfetch.dev/docs/api/v1/bluesky/posts/get.mdx
SDK: client.bluesky.getPost({ url })
Parameters:
- url (required, string) - Link to the Bluesky post.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/bluesky/posts?url=https://bsky.app/profile/espn.com/post/3lqdfq7fkvm2g" \
  -H "x-api-key: YOUR_API_KEY"