---
search:
  tags:
    - Catalog
    - GET
seo:
  description: >-
    Ranked full-text search over the catalog. A query also matches by
    capability, and a long… Reference for the GET /v1/catalog/search endpoint in
    the looot API.
sidebar:
  label: Search the catalog
  badge: GET
title: Search the catalog
type: openapi-operation
---
Ranked full-text search over the catalog. A query also matches by capability, and a long natural-language query falls back to stemmed tokens, so it never comes back empty.

The same search core answers MCP `search` (10 title rows by default) and MCP `search_catalog` (50 full rows by default, like this route). A title row is a subset of this route's row: endpointId, provider, name, capability, category, estimatedPrice, priceBasis, access, executionMode, costPerSuccessUsd (facts.costPerSuccessUsd), async (facts.async), works, sourceCapability and credential, in the same order for the same q, limit and offset for a customer token. A platform operator token differs: this route always includes unavailable rows, while MCP honors an explicit filters.includeUnavailable false.

`GET /v1/catalog/search`