Web result request example
POST /v1/search
{
"query": "web extraction for AI agents",
"channel": "page",
"results_per_page": 10
}Illustrative request. Select another channel to get a different result type.
API Overview / Search
Choose a search API by the results you need.
Search for web pages, images, news stories, videos, or academic sources through one endpoint. Select a channel for the result type you need, then decide whether to read the linked pages.
Search channels
Compare the five result types
All channels use the same endpoint. Choose by what a result contains and what your application still needs to do.
| Channel | Returns | Representative fields | Common task | Does not include |
|---|---|---|---|---|
| Web | Public page results | Title, link, snippet | Finding source URLs | Page Markdown |
| Images | Image candidates | Image URL, thumbnail, source link when available | Visual research | Reverse image search or usage rights |
| News | Story links | Publisher, snippet, date when available | Monitoring inputs | Full articles or built-in alerts |
| Videos | Video links | Title, source, optional duration or snippet | Demos and talks | Downloads or transcripts |
| Scholar | Scholarly source candidates | Title, link, snippet | Literature discovery | Verified references or full paper text |
One request shape
Choose a channel for your query
Set channel to page, images, news,videos, or scholar. The response envelope is shared, while the primary result collection depends on the channel. Fields from a source may be absent.
Search costs
Pay for results returned
Search uses 2 credits per primary result actually returned. A response with 10 primary results uses 20 credits. A later page extraction request is billed separately.See full pricing.