DocumentationWeb Search API
Web Search API
Real-time internet search with structured results
Overview
GET /v1/info/search provides real-time internet search with structured results.
When to Use
- Specific topic / event lookup: "Latest AI industry news", "Tesla autopilot updates"
- Stock-related context: After
/v1/finance/stock, use search to enrich with news sentiment - Beyond LLM training cutoff: AI Agents need information about recent events
- Time-windowed search:
recency=oneWeekfor recent week;oneDayfor today - vs
/v1/info/news: search is keyword-based real-time web search (precise but slower); news is pre-categorized headlines (fast but broad)
Request Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
q | string | Yes | - | Search query |
count | int | No | 10 | Number of results (1-50) |
recency | string | No | noLimit | Time range: oneDay/oneWeek/oneMonth/oneYear/noLimit |
Request Example
curl -H "X-API-Key: sk_gapi_xxxxx" \
"https://api.groundapi.net/v1/info/search?q=semiconductor+industry+news&count=10"Response Fields
| Field | Description |
|---|---|
query | Search query |
result_count | Number of results |
results[].title | Page title |
results[].link | Page URL |
results[].snippet | Content snippet |
results[].source | Source website |
results[].publish_date | Publish date |
Pricing
$0.02/call. First 500 calls/month are free.
Updated 1 month ago