# Socify API — X endpoints
# Base URL: https://trysocify.com
# API host: https://api.trysocify.com
# Auth: Authorization: Bearer <SOCIFY_KEY>
# Full catalog: https://trysocify.com/llms-endpoints.txt | JSON: https://trysocify.com/llms.json
# Agents map: https://trysocify.com/agents.txt | Index: https://trysocify.com/llms.txt
# Docs hub: https://trysocify.com/docs/api/twitter | OpenAPI: https://trysocify.com/openapi.json

3 documented X operations. Public X profiles, tweets, and post stats.
Do not invent paths — only the routes below (and their linked markdown pages) are supported.

## GET /api/v1/twitter/profile
Profile
Fetch a public X profile by username: bio, followers, and verification.
Credit cost: 2 credits per request. Failed requests are free.
Auth: Authorization: Bearer <SOCIFY_KEY>
Docs: https://trysocify.com/docs/api/twitter/profile.md
HTML: https://trysocify.com/docs/api/twitter/profile
SEO: https://trysocify.com/twitter/profile
Parameters:
- username (required, string) - Username without @. Example: `elonmusk`.
curl:
curl -sS "https://trysocify.com/api/v1/twitter/profile?username=elonmusk" \
  -H "Authorization: Bearer $SOCIFY_KEY"

## GET /api/v1/twitter/tweets
X User Tweets
Fetch recent public tweets for a user id (from User Info). Best coverage on verified accounts. Response is a compact tweet list (not raw GraphQL).
Credit cost: 4 credits per request. Failed requests are free.
Auth: Authorization: Bearer <SOCIFY_KEY>
Docs: https://trysocify.com/docs/api/twitter/tweets.md
HTML: https://trysocify.com/docs/api/twitter/tweets
SEO: https://trysocify.com/twitter/tweets
Parameters:
- id (required, string) - Numeric user id from User Info (id). Example: `44196397`.
curl:
curl -sS "https://trysocify.com/api/v1/twitter/tweets?id=44196397" \
  -H "Authorization: Bearer $SOCIFY_KEY"

## GET /api/v1/twitter/post
X Post Info
Fetch public details and stats for a tweet by id.
Credit cost: 2 credits per request. Failed requests are free.
Auth: Authorization: Bearer <SOCIFY_KEY>
Docs: https://trysocify.com/docs/api/twitter/post.md
HTML: https://trysocify.com/docs/api/twitter/post
SEO: https://trysocify.com/twitter/post
Parameters:
- id (required, string) - Tweet id. Example: `1694791112567967849`.
curl:
curl -sS "https://trysocify.com/api/v1/twitter/post?id=1694791112567967849" \
  -H "Authorization: Bearer $SOCIFY_KEY"