# Social listening API - Veezee

Social listening means watching what people say about a brand, product, or topic across public discussion, not just tracking official accounts. Most teams want the raw posts and comments so their own pipeline or agent can score sentiment, cluster themes, or spot a spike; a vendor's canned sentiment label just gets in the way.

## How to do it with Veezee

Veezee gives an agent three tools for this. [reddit_search](https://veezee.io/docs/tools/reddit_search) with `type=comments` reaches comment-level mentions inside discussions, not just post titles. [x_search](https://veezee.io/docs/tools/x_search) sweeps X chronologically for a query, following the cursor for as many pages as the sweep needs. [reddit_get_subreddit_posts](https://veezee.io/docs/tools/reddit_get_subreddit_posts) reads one community's feed directly, useful once you know where the conversation happens (a product's own subreddit, a niche community). None of these return a sentiment score: every result carries the raw text, author, upvotes or likes, and timestamp, and your agent runs its own analysis on that.

No signup: your agent mints its own free key in one call, then uses it directly.

```sh
curl -s -X POST https://api.veezee.io/v1/keys/mint | jq -r .key
curl "https://api.veezee.io/v1/reddit/search?query=your-brand&type=comments" -H "Authorization: Bearer $VEEZEE_API_KEY"
```

## FAQ

**Does Veezee score sentiment for me?**

No. Every response carries the raw post or comment text plus upvotes, comment counts, and timestamps; your agent runs its own sentiment analysis on that text.

**Can I get notified the moment someone posts about my brand?**

Not automatically: there's no push mechanism. Poll reddit_search or x_search on your own schedule (`sort=new` for Reddit, `type=recent` for X) and diff against what you've already seen.

**How far back does the search go?**

reddit_search has no server-side time window on comment search, so filter results on `created_at` yourself; x_search takes `since:`/`until:` query operators for time windows directly.

**What's a realistic setup for checking this daily?**

A handful of narrow comment searches plus one subreddit poll and one X sweep, costed out step by step in the recipe below.

## Read next

- Worked recipe with real credit costs: [/use-cases/brand-monitoring](https://veezee.io/use-cases/brand-monitoring)
- Full docs: [/docs](https://veezee.io/docs)
- Credit prices and packs: [/pricing](https://veezee.io/pricing)
- Buy credits: [/upgrade](https://veezee.io/upgrade)