X / Twitter

Plushcap exposes normalized, read-only X account and post evidence. Provider payloads and provider names are never returned.

GET /api/v1/companies/<company_slug>/x/accounts/

Lists canonical company and employee profiles. Use account_scope=company, employee, or all. Collection status and follower metadata are included.

GET /api/v1/companies/<company_slug>/x/posts/

Lists canonical posts with standard page and page_size pagination. Filters include RFC 3339 start_at and end_at, lookback_days, account_scope, username, post_type, and ordering.

GET /api/v1/companies/<company_slug>/x/posts/<x_post_id>/

Returns a complete sanitized post with text, media, hashtags, engagement, and nested quote/repost details. raw_payload is never exposed.

GET /api/v1/companies/<company_slug>/x/summary/

Returns post and account counts, engagement totals and averages, per-metric coverage, the effective date range, and latest collection time.

GET /api/v1/companies/<company_slug>/x/high-engagement/

Returns separate likes and repost rankings for competitive-space peers, similar-stage peers, and all-company leaders. The target company is excluded; ties share a rank; repeated posts are returned once in a shared post map.

GET /api/v1/companies/<company_slug>/x/research/

Returns one composite evidence bundle containing up to 100 newest target posts, the target summary, peer cohorts, 30 days of global Hacker News evidence, and 12 complete weeks of normalized global and competitive-space trends. The API does not generate recommendations.

All endpoints require at least Free access and retain the existing Free per-endpoint quota. Free X post access has a hard rolling 14-day boundary. An explicit older request returns 403 with code x_history_paid_access_required. Accelerate, Lead, active Trial, staff, and internal access can query all stored history.