# Search the web

`GET https://api.crawl4ai.com/search`

Crawl4AI's own web search: results ranked and cleaned for reading, browser-free. Add `rich=1` to also get the on-page extras — follow-up questions, related queries, an entity card and more (see below). For a direct answer, use [/answer](https://crawl4ai.com/docs/answer/).
## Request

curl:

```bash
curl "https://api.crawl4ai.com/search?q=rust+web+crawler" \
  -H "Authorization: Bearer sk_live_..."
```

## Query

| Name | Type | Default | Description |
|---|---|---|---|
| q* | string | - | The search query (max 512 chars). |
| rich | 0 \| 1 | 0 | Default 0 (ranked links only). `1` adds a `rich` block: a direct **answer** when one exists, follow-up questions, related queries, an entity card, videos, news and more. Slightly slower; best for questions. |

## Response

A ranked list in `results`. Each result:

| Name | Type | Default | Description |
|---|---|---|---|
| title | string | - | The page's title. |
| url | string | - | The page itself, not a redirect. |
| snippet | string | - | The text shown for the page; can be empty. |
| source | gg \| gs \| index | - | `gg` and `gs`: a live web result. `index`: from the Crawl4AI index, added after the live results when the web returns fewer than 10, or served alone when the live search fails. Same price either way. |

## Rich response `rich=1`

Every key below is optional — each appears only when that block is on the page. For a direct **answer** to a question, use [/answer](https://crawl4ai.com/docs/answer/).

rich block:

```json
{
  "results": [ … ranked links, same as always … ],
  "rich": {
    "follow_up_questions": [ "Why is the sky blue at sunset?" ],
    "related_queries":    [ "why is the ocean blue" ],
    "entity":  { "title": "Apple Inc", "subtitle": "NASDAQ: AAPL" },
    "videos": [ { "title": "…", "url": "https://…" } ],
    "news":   [ { "title": "…", "url": "https://…" } ],
    "discussions":  [ … ],
    "did_you_mean": "corrected spelling"
  }
}
```



**Try it with your key**

Run this call in the playground and see the real answer, the time and the units.
[Open the playground](https://crawl4ai.com/#playground)



---
Source: https://crawl4ai.com/docs/search/