> Agent-readable docs index: /llms.txt. Download /docs.zip to grep all markdown files locally.

---
title: "Unified semantic search"
description: "Search across all entity types using AI embeddings"
api: "GET /api/v1/search"
gridGap: 30
---

<Aside full>
  <RequestExample>
    ```bash title="cURL" lines=false
    curl -X GET "https://api.adjacent.markets/api/v1/search?q=%3Cq%3E" \
      -H "Authorization: Bearer <token>"
    ```
  </RequestExample>
</Aside>

<OpenAPIEndpoint {...{"method":"get","path":"/api/v1/search","summary":"Unified semantic search","description":"Search across all entity types using AI embeddings","parameters":[{"name":"q","in":"query","required":true,"description":"Search query","schema":{"type":"string"}},{"name":"type","in":"query","description":"Filter by entity type","schema":{"type":"string","enum":["market","event","index","rate","article"]}},{"name":"limit","in":"query","description":"Max results","schema":{"type":"integer","default":10}},{"name":"min_similarity","in":"query","description":"Min similarity (0.0-1.0)","schema":{"type":"number","default":0}},{"name":"max_similarity","in":"query","description":"Max similarity (0.0-1.0)","schema":{"type":"number","default":1}},{"name":"page","in":"query","description":"Page number","schema":{"type":"integer","default":1,"minimum":1}},{"name":"per_page","in":"query","description":"Items per page","schema":{"type":"integer","default":100,"minimum":1,"maximum":500}}],"responses":[{"status":"200","description":"Paginated search results","schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","required":["entity_type","entity_id","similarity"],"properties":{"entity_type":{"type":"string"},"entity_id":{"type":"string"},"similarity":{"type":"number"},"name":{"type":["string","null"]},"description":{"type":["string","null"]},"latest_price":{"type":["number","null"]},"category":{"type":["string","null"]},"platform":{"type":["string","null"]},"date":{"type":["string","null"]},"url":{"type":["string","null"]}}}},"meta":{"type":"object","properties":{"total":{"type":"integer"},"page":{"type":"integer"},"per_page":{"type":"integer"},"total_pages":{"type":"integer"},"has_next":{"type":"boolean"},"has_prev":{"type":"boolean"}}}}},"examples":[]}],"security":[{"name":"bearerAuth","type":"http","scheme":"bearer","in":"header","description":"Clerk JWT Bearer token"}],"servers":[{"url":"https://api.adjacent.markets","description":"API server"}]}} />