BuzzSearch

Ask a new question over a completed search's corpus and get a cited answer, without searching again. Uses the account balance for the answer only, no new search. Good for 'what do they say about price', 'summarize the objections', 'which phrases do they use for the problem'. Works on searches started through the API or MCP.

ask

Write ad hooks grounded in a completed search's quotes, using BuzzSearch's hook writer: each hook opens with a callout lifted from real comments and carries a loop or promise. Uses the account balance for the hooks only, no new search. Works on searches started through the API or MCP. Give an `angle` to steer (a product, a persona, a platform).

generate_hooks

Read a search's status, cited answer, coverage counts and top quotes. Pass `turn_id` to read a specific follow-up answer, otherwise the latest turn is returned. Waits up to `wait_seconds` if the search is still running.

get_search

The balance available on the connected BuzzSearch account.

get_balance

Verbatim customer quotes extracted by a search, filtered and paged. Each quote carries a stable id, the source url, a dimension (emotional_painpoints, recurring_painpoints, desired_outcomes, failed_solutions, objections, customer_lingo), an engagement score and an emotional intensity (1 to 5). For ad copy, pull emotional_painpoints and customer_lingo sorted by intensity.

get_quotes

The raw comment bodies behind a completed search, grouped by thread or video, filtered and paged. A search reads hundreds to thousands of comments, so filter by source, a substring, or a minimum score, and page with limit and offset.

get_comments

The threads and videos a search read, with engagement, comment counts and how many quotes each produced. Use it to cite a thread or pick which source's raw comments to pull.

get_sources

Recent searches by the signed-in user, newest first, including ones run in the BuzzSearch app. Reread a past search with get_search or get_quotes instead of running a new one on the same topic.

list_searches

Search the web for user-generated content: what real people say about a product, problem or audience in comments on Reddit, YouTube, TikTok and Facebook groups. Runs a full live search: finds threads and videos across the web, reads their comments, extracts verbatim quotes and writes a cited answer. A query that contains a TikTok video, creator profile or hashtag link, a bare creator @handle (TikTok unless the query says YouTube), a YouTube video or channel link, a Reddit thread or subreddit link, or a Facebook group post link reads that link's own comments directly (add a question after the link to also search the topic). A query that is a pasted list of comments is analyzed directly with no web search. Waits up to `wait_seconds` and returns the answer with the top quotes when done, or the search id to resume with `get_search`. Uses the connected BuzzSearch account's balance; the amount used is reported on completion as `credits_charged`. If the balance does not cover a search, the call says so. Check `list_searches` first: a prior search on the same topic can be reread.

search