List all keyword searches. Returns a paginated list filtered by status.

Create a keyword/hashtag search across social media platforms (X, Reddit, YouTube, Facebook, Instagram, Threads, Bluesky, and more). Polls until the search is complete and returns the full results.

Get results for a keyword search by ID. Returns search status, analytics summary, and posts.

List all user searches. Returns a paginated list filtered by status.

Create a user profile search on a social media platform. Polls until the search is complete and returns the full results.

Get results for a user search by ID. Returns profile info, metrics, and content analysis.

Get the conversation topic tree for a keyword search. Shows how topics and subtopics are distributed across the search results.

Get raw posts from a keyword search. Returns the actual social media posts matching the search query.

Get raw posts from a user search. Returns the actual social media posts from the searched user profile.

Get the current integration settings (webhook return URL and integration name).

Update integration configuration. Set the webhook URL that receives notifications when a search completes.

Get API usage data. Returns search counts and per-user breakdowns. Optionally filter by month.

List all expert searches. Returns a paginated list filtered by status.

Find experts matching a natural-language query using Rolli's AI-driven recommendation engine. Polls until the search is complete and returns the full list of recommended experts (name, professional title, location, contact info, expertise keywords, and an AI-generated summary explaining why each expert matches).

Get results for an expert search by ID. Returns search status and, once complete, the array of recommended experts with their profiles and AI-generated match summaries.

List Rolli Agent runs (AI-driven social intelligence investigations). Returns a paginated summary list. Discarded runs are excluded.

Start a Rolli Agent investigation. Submit a plain-English question; the agent plans a search strategy, queries Rolli IQ across platforms, analyzes posts, and produces a markdown intelligence report with signals, evidence links, and a confidence rating. Polls until the run is complete and returns the full results.

Get a Rolli Agent run by ID. While running, returns progress (percentage, phase, current tool). Once complete, returns the full markdown report, signals, evidence links, and usage metrics.

Cancel a pending or running Rolli Agent run. Marks the run as failed.

Rerun a failed, waiting, or stuck Rolli Agent run. Resets the run to pending and re-enqueues it. Running runs are force-cancelled first. Returns 422 if the run is already completed.

Update a Rolli Agent run's metadata (rename or pin). At least one of pinned or label is required.

Soft-delete a Rolli Agent run. The record remains in the database for audit purposes but is hidden from listings. Only works on completed or failed runs — cancel the run first if it is still running.

List Rolli Agent scheduled reports. Schedules execute on a daily/weekly/monthly/once cadence and produce a new agent run each time.

Create a recurring Rolli Agent report that runs on a cron-like cadence (daily, weekly, monthly, or one-time) with optional email and Slack notifications.

Get a Rolli Agent schedule's full configuration plus its 10 most recent execution records.

Partially update a Rolli Agent schedule. Unspecified fields are left unchanged. next_run_at is recalculated if any recurrence parameter changes.

Permanently delete a Rolli Agent schedule and its execution history. This is irreversible. Use pause_agent_schedule to temporarily stop a schedule without losing history.

Pause a Rolli Agent schedule so it stops executing. The schedule and its history are preserved — resume it later with resume_agent_schedule.

Resume a paused Rolli Agent schedule. next_run_at is recalculated based on the recurrence parameters.

List the full execution history of a Rolli Agent schedule, including a preview of each linked agent run.