Documentation

Research public social content

Turn a focused question into a bounded sample of public posts and comments with traceable sources.

View as Markdown
On this page

Start with a specific question

Prompt · replace the brackets
Use Purrkey to research public discussion of [topic] on [platform] during [date range]. Start with a small sample. Inspect the tool's price and supported filters before running it. Keep total spend under [budget]. Return source links, collection dates, recurring themes and sampling limitations.

Follow the evidence

  1. Discover a tool for the requested platform and content type. Do not assume a platform supports every search or date filter.
  2. Inspect the selected tool. Resolve required post, creator or account identifiers before execution.
  3. Run the smallest useful batch with an explicit spending cap. Keep its Run ID and source URLs.
  4. Separate what the sample shows from your interpretation. Expand only when the question needs more evidence.
Shell · discovery only
purrkey discover --query 'public social posts and comments' --limit 5

Report coverage, not just conclusions

IncludeWhy it matters
Platform, query and collection dateMakes the evidence reproducible and its time window clear.
Sample size and source linksShows which observations support the summary.
Missing fields and unavailable filtersPrevents a limited sample from appearing comprehensive.
Run IDs and actual chargesAllows you to recover the results and account for costs.