Compare the access options
Choose an access method around the accounts, dates, and fields your question needs. Check current terms, pricing, and retention rules with the provider.
The official X API
Use documented endpoints to request platform data. Review available history, rate limits, fields, and usage pricing for your workload.
Read the X API documentationA collected dataset
Your own collection workflow
Check the work behind the data
Coverage and gaps
Maintenance
Access and use
Enrichment
What a useful result contains
A result should let you return to the original post and understand how it was selected.
Author and date
Text and labels
Searchable history
Related coverage
Explore Perception’s Bitcoin post search and executive coverage examples.
Get Bitcoin tweets with sentiment in three steps
- 01Choose MCP or REST access
Free MCP access covers all 31 research tools at five calls a day and needs no credit card. Taxonomy discovery is unmetered. Paid plans include authenticated REST API access.
- 02Connect through MCP and ask
Connect Perception to Claude, ChatGPT, or Gemini over the Model Context Protocol. Ask in plain English: "what did tracked crypto accounts post about ETF flows this week, and what was the sentiment split?" The assistant runs the queries.
- 03Use /feed with paid REST access
On a paid plan, run curl "https://api.perception.to/feed?keyword=bitcoin&sentiment=negative" -H "Authorization: Bearer pcp_your_key". Filter by keyword, sentiment, outlet, and date range. Responses are structured JSON with sentiment breakdowns.
Tip