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. Oversized responses are truncated (truncated: true, largest post arrays shortened) — retrieve complete post data with get_keyword_search_posts. A status of results_pending means the search succeeded but results are still being written; fetch them with get_keyword_search.

Get results for a keyword search by ID. Returns search status, analytics summary, and posts. Oversized responses are truncated (truncated: true) — retrieve complete post data with get_keyword_search_posts. results_pending: true means the search succeeded but the backend is still writing results; retry in a few seconds.

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. Oversized responses are truncated (truncated: true) — retrieve complete post data with get_user_search_posts. A status of results_pending means the search succeeded but results are still being written; fetch them with get_user_search.

Get results for a user search by ID. Returns profile info, metrics, and content analysis. Oversized responses are truncated (truncated: true) — retrieve complete post data with get_user_search_posts. results_pending: true means the search succeeded but the backend is still writing results; retry in a few seconds.

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. Oversized responses are truncated (truncated: true) — request one platform at a time for full data on large searches.

Get raw posts from a user search. Returns the actual social media posts from the searched user profile. Oversized responses are truncated (truncated: true).

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, per-user breakdowns, and the current IQ credit balance (credits.credits_remaining, credits.credits_limit, credits.period_reset_date — the latter two are null for one-time credit grants). 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). A status of results_pending means the search succeeded but results are still being written; fetch them with get_expert_search.

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. results_pending: true means the search succeeded but the backend is still writing results; retry in a few seconds.

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. Fails immediately (before starting) if the IQ credit balance is insufficient. Polls inline for up to 2 minutes. If the run finishes in that window, returns the full results; otherwise returns the run ID and a note to fetch the results with get_agent_run (typical run takes 3–5 minutes).

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. Fails immediately if the IQ credit balance is exhausted (a rerun needs at least 1 credit).

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.