Web
Web Search
Search the live web with an AI-generated overview and structured sources.
POST/v1/web/search
Run a query against the live web. Returns ranked results with snippets plus an optional AI overview and geo-located results.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
query | string | yes | The natural-language search query. Max 400 chars. |
ai_overview | boolean | no | Include an AI-synthesized overview. Defaults to true. |
safe_search | "strict" | "moderate" | "off" | no | Content filter level. Defaults to moderate. |
spell_check | boolean | no | Auto-correct the query before searching. Defaults to true. |
auto_scrape | boolean | no | Auto-scrape result pages for richer content. Defaults to true. |
country_code | string | no | 3-letter country code to bias results, e.g. DEU, USA. |
byo_urls | string[] | no | Restrict results to the given URLs. |
max_results | number | no | Cap on the number of results returned. |
Request
curl https://api.marob.ai/v1/web/search \
-H "Authorization: Bearer $MAROB_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "top 10 most funded series A companies in the US",
"safe_search": "moderate"
}'Response
{
"success": true,
"_usage": {
"input_tokens": 25,
"output_tokens": 1100,
"inference_time_tokens": 2400,
"total_tokens": 3525
},
"log_id": "log_01JABC...",
"query": "top 10 most funded series A companies in the US",
"ai_overview": "Altos Labs ($3.0B, 2021), Articulate ($1.5B, 2021)…",
"spell_fixed": false,
"is_safe": true,
"results": [
{
"title": "Altos Labs",
"url": "https://altoslabs.com",
"description": "Cellular rejuvenation programming.",
"content": "Founded in 2021…",
"is_safe": true,
"site_name": "altoslabs.com",
"site_long_name": "Altos Labs",
"age": null,
"language": "en",
"favicon": "https://altoslabs.com/favicon.ico",
"snippets": ["$3.0B Series A…"],
"related_index": null
}
],
"image_urls": [],
"links": [],
"geo_results": []
}