POST /search/grounded
Get an AI-generated answer to a question, grounded in web sources. Every claim is backed by a citation with a URL.
Costs 1 utility call per request.
{
"query": "What are common complaints about Salesforce pricing?",
"sources": ["reddit.com", "news.ycombinator.com"]
}
| Field | Type | Required | Description |
|---|---|---|---|
query | string | yes | The question to answer |
sources | string[] | no | Restrict to specific domains |
{
"answer": "Users frequently cite three main pricing complaints about Salesforce: per-seat costs that escalate rapidly as teams grow, expensive add-ons for features that competitors include by default, and opaque enterprise pricing that requires negotiation...",
"citations": [
{
"title": "Salesforce pricing is out of control",
"url": "https://www.reddit.com/r/salesforce/...",
"snippet": "We went from $50/user to $150/user after they bundled..."
},
{
"title": "Ask HN: Affordable Salesforce alternatives?",
"url": "https://news.ycombinator.com/item?id=...",
"snippet": "The enterprise tier pricing is intentionally opaque..."
}
]
}
| Field | Type | Description |
|---|---|---|
answer | string | AI-generated answer grounded in web sources |
citations | array | Sources backing the answer |
citations[].title | string | Source page title |
citations[].url | string | Source URL |
citations[].snippet | string | Relevant excerpt from the source |
Grounded search is for quick, factual questions where you need a direct answer with citations. It returns in seconds.
Research runs are for open-ended research where you want deep analysis — themes, quotes, sentiment. They take minutes but return much richer data.