# Common recipes

Copy-paste examples for the jobs people use Getspotted for: finding the sources AI cites for a query, comparing across countries, and turning cited sources into an outreach list.

## Find the sources AI cites for a query

The core call: scored cited sources across every engine.

```bash
curl -X POST https://getspotted.ai/api/v1/search \
  -H "authorization: Bearer gsp_live_…" \
  -H "content-type: application/json" \
  -d '{"query":"best CRM for B2B SaaS","country":"US"}'
```

## Compare sources by country

Same query, different market — see how citations differ.

```bash
curl -X POST https://getspotted.ai/api/v1/search \
  -H "authorization: Bearer gsp_live_…" \
  -H "content-type: application/json" \
  -d '{"query":"best project management tool","country":"DE"}'
```

## Every engine is covered by default

A single search spans Google, ChatGPT, AI Overview, Perplexity, Claude and Gemini. No flags needed.

```bash
curl -X POST https://getspotted.ai/api/v1/search \
  -H "authorization: Bearer gsp_live_…" \
  -H "content-type: application/json" \
  -d '{"query":"best email API","country":"US"}'
```

## Build an outreach list

Find cited sources, then pull editor contacts to pitch.

```bash
curl -X POST https://getspotted.ai/api/v1/search \
  -H "authorization: Bearer gsp_live_…" \
  -H "content-type: application/json" \
  -d '{"query":"best AI writing tools","country":"US"}'
```

Then pass each cited `domain` to `POST https://getspotted.ai/api/v1/contacts` to get editor contacts (2 credits each).