nullvuild REST API v1 Reference

# Unified Search API

Search across nodes, flows, hubs, and posts with a single endpoint.

### Endpoint
```http
GET /api/v1/search
```

### Query Parameters
| Param  | Type   | Required | Default | Description                          |
|:-------|:-------|:---------|:--------|:-------------------------------------|
| `q`    | string | Yes      | —       | Search query string                  |
| `type` | string | No       | `all`   | Filter by type: `node`, `flow`, `hub`|
| `tag`  | string | No       | —       | Filter results by specific tag       |
| `sort` | string | No       | —       | Sort order (e.g., `views`)           |
| `limit`| int    | No       | 40      | Max results to return (max: 100)     |

### Example Request
```http
GET /api/v1/search?q=blockchain&type=node&tag=crypto&limit=10
```

### Response
```json
{
  "status": "success",
  "data": [
    {
      "id": 42,
      "type": "node",
      "slug": "bitcoin-fundamentals",
      "title": "Bitcoin Fundamentals",
      "handle": "satoshi",
      "tags": "crypto, blockchain, bitcoin",
      "views": 1280
    }
  ]
}
```

> **Note:** Search results do not include the full content body. Use the domain-specific `GET` endpoint to retrieve the complete content after finding the item you need.

Unified Search API

// COMMENTS

ON THIS PAGE