> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trychannel3.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Make a Search

AI apps and agents use `/search` to find products across the web.

## The request shape

```json theme={null}
{
  "query": "merino wool sweater",
  "filters": {
    "price": { "min_price": 50, "max_price": 200 },
    "availability": ["InStock"],
    "brand_ids": ["..."],
    "website_ids": ["..."],
    "category": "sweaters"
    // and many more
  },
  "limit": 20
}
```

## Get an API key

Search requires an API key. [Create a free account](https://trychannel3.com/sign-up/developer), then copy your key.

<Note>
  You get **1,000 free credits each month** — that's good for 1,000 searches.
  Extra usage is billed per call; see [pricing](/pricing) for the breakdown.
</Note>

## Choose a search method

<CardGroup cols={3}>
  <Card title="Search" icon="search" href="/guides/search">
    Search with text and images.
  </Card>

  <Card title="Agentic search" icon="sparkles" href="/guides/agentic-search">
    Interpret longer shopping requests for an agent workflow.
  </Card>

  <Card title="Image search" icon="image" href="/guides/image-search">
    Find visually similar products from an image URL or upload.
  </Card>
</CardGroup>

## Filters

Add optional filters to narrow your search.

<CardGroup cols={3}>
  <Card title="Price" icon="dollar-sign" href="/guides/price-filters">
    Constrain results to an offer price range.
  </Card>

  <Card title="Color" icon="palette" href="/guides/color-filters">
    Find products that match a hex color palette.
  </Card>

  <Card title="Dimensions" icon="ruler" href="/guides/dimension-filters">
    Constrain length, width, height, or weight.
  </Card>

  <Card title="Brand" icon="tag" href="/guides/brand-search">
    Filter by the company behind a product.
  </Card>

  <Card title="Website" icon="store" href="/guides/website-search">
    Restrict results to retailer offers from selected websites.
  </Card>

  <Card title="Attributes" icon="sliders" href="/guides/advanced-search">
    Filter on category-specific structured attributes.
  </Card>
</CardGroup>

## Start from an existing product

<CardGroup cols={2}>
  <Card title="Look up a product URL" icon="link" href="/guides/url-lookup">
    Get structured data from a URL, and offers at other retailers.
  </Card>

  <Card title="Find similar products" icon="clone" href="/guides/similar-products">
    Get recommendations from a known Channel3 product ID.
  </Card>
</CardGroup>

## Next

Next: [What you get](/guides/response-overview). It explains how products, offers, prices, and buy links appear in a response.