X / Twitter reference
Profiles, posts, communities, timelines, and media transcripts from public X surfaces.
Each operation below runs through the tool endpoint shown, and is available through REST, MCP, and the Better Fetch workspace.
Profile
AvailableProfile from public X / Twitter surfaces, returned as structured data for agents, research, and monitoring workflows.
curl -sS -X POST "https://betterfetch.co/api/tools/twitter_search/run" \
-H "Authorization: Bearer bf_your_key_here" \
-H "Content-Type: application/json" \
-d '{"input":{"handle":"openai"}}'Tool: twitter_search
User posts
AvailableUser posts from public X / Twitter surfaces, returned as structured data for agents, research, and monitoring workflows.
curl -sS -X POST "https://betterfetch.co/api/tools/twitter_search/run" \
-H "Authorization: Bearer bf_your_key_here" \
-H "Content-Type: application/json" \
-d '{"input":{"mode":"user_posts","handle":"levelsio","max_results":10}}'Tool: twitter_search
Post details
AvailablePost details from public X / Twitter surfaces, returned as structured data for agents, research, and monitoring workflows.
curl -sS -X POST "https://betterfetch.co/api/tools/twitter_search/run" \
-H "Authorization: Bearer bf_your_key_here" \
-H "Content-Type: application/json" \
-d '{"input":{"mode":"post","post_url":"https://x.com/jack/status/20"}}'Tool: twitter_search
Post transcript
AvailablePost transcript from public X / Twitter surfaces, returned as structured data for agents, research, and monitoring workflows.
curl -sS -X POST "https://betterfetch.co/api/tools/twitter_search/run" \
-H "Authorization: Bearer bf_your_key_here" \
-H "Content-Type: application/json" \
-d '{"input":{"mode":"transcript","post_url":"https://x.com/WarnerBrosUK/status/1768322581868744740","language":"en"}}'Tool: twitter_search
Community
AvailableCommunity from public X / Twitter surfaces, returned as structured data for agents, research, and monitoring workflows.
curl -sS -X POST "https://betterfetch.co/api/tools/twitter_search/run" \
-H "Authorization: Bearer bf_your_key_here" \
-H "Content-Type: application/json" \
-d '{"input":{"mode":"community","community_url":"https://x.com/i/communities/1926186499399139650"}}'Tool: twitter_search
Community posts
AvailableCommunity posts from public X / Twitter surfaces, returned as structured data for agents, research, and monitoring workflows.
curl -sS -X POST "https://betterfetch.co/api/tools/twitter_search/run" \
-H "Authorization: Bearer bf_your_key_here" \
-H "Content-Type: application/json" \
-d '{"input":{"mode":"community_posts","community_url":"https://x.com/i/communities/1926186499399139650","max_results":10}}'Tool: twitter_search