# Search

> Free engines first, merged by rank, three results a query on the playground, each with the engine that found it. Domain, time, country and language filters are optional.

Canonical page: https://clawifi.dev/docs/search

## Recorded response

**Response (recorded 20 Oct 2026, trimmed)**

```json
{
  "query": "what is the Model Context Protocol",
  "result_count": 3,
  "results": [
    {
      "title": "What is the Model Context Protocol (MCP)?",
      "url": "https://modelcontextprotocol.io/docs/2026-07-28/getting-started/intro",
      "engines": [
        "bing",
        "yahoo",
        "google cse"
      ]
    },
    {
      "title": "Model Context Protocol - Wikipedia",
      "url": "https://en.wikipedia.org/wiki/Model_Context_Protocol",
      "engines": [
        "bing",
        "yahoo",
        "google cse"
      ]
    }
  ]
}
```

## POST /search/free

Search Free. Full parameters on the [endpoint page](https://clawifi.dev/docs/api/post-search-free).

**cURL**

```sh
curl -X POST https://api.clawifi.dev/search/free \
  -H "Authorization: Bearer $CLAWIFI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"what is the Model Context Protocol"}'
```

**Python**

```python
from clawifi import Clawifi

client = Clawifi()  # reads CLAWIFI_API_KEY
result = client.search_free("what is the Model Context Protocol")
```

**MCP**

```text
search_free(query="what is the Model Context Protocol")
```

## POST /search/content

Search Content. Full parameters on the [endpoint page](https://clawifi.dev/docs/api/post-search-content).

**cURL**

```sh
curl -X POST https://api.clawifi.dev/search/content \
  -H "Authorization: Bearer $CLAWIFI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"what is the Model Context Protocol"}'
```

**Python**

```python
from clawifi import Clawifi

client = Clawifi()  # reads CLAWIFI_API_KEY
result = client.search_content("what is the Model Context Protocol")
```

## POST /search/free/bundle

Search Free Bundle. Full parameters on the [endpoint page](https://clawifi.dev/docs/api/post-search-free-bundle).

**cURL**

```sh
curl -X POST https://api.clawifi.dev/search/free/bundle \
  -H "Authorization: Bearer $CLAWIFI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"what is the Model Context Protocol"}'
```

**Python**

```python
from clawifi import Clawifi

client = Clawifi()  # reads CLAWIFI_API_KEY
result = client.post("/search/free/bundle", json={"query":"what is the Model Context Protocol"})
```

## GET /search/free/status

Search Free Status. Full parameters on the [endpoint page](https://clawifi.dev/docs/api/get-search-free-status).

**cURL**

```sh
curl https://api.clawifi.dev/search/free/status \
  -H "Authorization: Bearer $CLAWIFI_API_KEY"
```

**Python**

```python
from clawifi import Clawifi

client = Clawifi()  # reads CLAWIFI_API_KEY
result = client.get("/search/free/status")
```