# glim.sh Web Search

> glim.sh Web Search is a paid API for AI agents from glim.sh, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Searches the open web, Twitter, Reddit, GitHub, and more in real time, returning ranked results with titles, snippets, authors, and publish dates.

## Facts

- Endpoint: POST https://glim.sh/api/v1/web/search
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/glim-sh-web-search-f12d336f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ucrLmYqUedZrf028GqTbX

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability glim-sh-web-search-f12d336f -d '<json body>'
```

Example prompt: Search the web for 'open source LLM fine-tuning benchmarks', restrict results to arxiv.org, and only show things published in the last 30 days.

## When to prefer this

Choose this endpoint when you need real-time, multi-source search across the open web and social platforms (Twitter, Reddit, GitHub) in a single API call, without managing API keys or a scraping stack. It is especially useful when you want to filter by recency or restrict/exclude specific domains. Prefer this over platform-specific sibling endpoints when you want broad web coverage, not just tweets or Reddit posts.

## Known failure modes

- Query returns 0 results if published_within_days is too narrow for the topic or pages lack publish-date metadata
- Domain filter (include_domains) may return sparse results if the domain has limited indexable content
- Noisy SEO-farm results may appear if exclude_domains is not used proactively
- Payment failure (402) if USDC balance is insufficient
- Malformed query may return irrelevant results

## How this service works

Web search powered by Exa

## Output

A JSON array of ranked results, each containing a URL, relevance score (0–1), title, snippet, author name, and published date. The response also includes a total count of results returned.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "query": {
   "type": "string",
   "maxLength": 1000,
   "minLength": 1,
   "description": "Search query"
  },
  "exclude_domains": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "Exclude results from these domains. Useful for filtering noisy aggregators or SEO farms when you've seen them dominate results (e.g. ['pinterest.com', 'quora.com'])."
  },
  "include_domains": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "Restrict results to these domains (e.g. ['arxiv.org'])"
  },
  "published_within_days": {
   "type": "integer",
   "maximum": 3650,
   "minimum": 1,
   "description": "Restrict to results published within the last N days. Skip this for broad queries - it excludes pages without publish-date metadata. Common values: 1, 7, 30, 365."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "results": [
   {
    "url": "https://example.com",
    "score": 0.95,
    "title": "Example",
    "author": "Author Name",
    "snippet": "...",
    "published_date": "2026-01-15"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/glim-sh-web-search-f12d336f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from glim.sh](https://www.zero.xyz/host/glim.sh/llms.txt)