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

# Search Collections

> Search collections by keyword

# Search Collections

Searches collections by keyword. Keyword search over collections is served by
the **storefront** predictive-search endpoint — request `collection` as the
resource type. This is served from the store domain and needs no OAuth token.

<Note>
  To list or filter collections with an OAuth app token (e.g. by published
  status / pagination), use [`GET /api/v1/collections.json`](/api-reference/collections/list)
  instead. This page covers keyword search.
</Note>

## Request

```bash theme={null}
curl -X GET "https://mystore.launchmystore.io/search/suggest.json?q=summer&resources[type]=collection"
```

## Parameters

<ParamField query="q" type="string" required>
  Search query (predictive search activates at 2+ characters). Also accepts
  the `query` alias.
</ParamField>

<ParamField query="resources[type]" type="string" default="product,collection,article,page">
  Resource types to search. Set to `collection` to return only collections.
</ParamField>

<ParamField query="resources[limit]" type="integer" default="10">
  Maximum results (max 50). Also accepts the `limit` alias.
</ParamField>

## Response

Matches the Shopify predictive-search shape: a `resources.results` object.
Collections are returned under `results.collections`.

<ResponseField name="resources" type="object">
  <Expandable title="resources">
    <ResponseField name="results" type="object">
      <Expandable title="results">
        <ResponseField name="collections" type="array">
          Matching collections.

          <Expandable title="Collection Object">
            <ResponseField name="id" type="string">
              Collection ID.
            </ResponseField>

            <ResponseField name="title" type="string">
              Collection title.
            </ResponseField>

            <ResponseField name="handle" type="string">
              URL handle.
            </ResponseField>

            <ResponseField name="description" type="string">
              Short description (truncated).
            </ResponseField>

            <ResponseField name="published_at" type="string">
              ISO-8601 publish timestamp.
            </ResponseField>

            <ResponseField name="image" type="string">
              Collection image URL (or `null`).
            </ResponseField>

            <ResponseField name="url" type="string">
              Storefront URL, e.g. `/collections/{handle}`.
            </ResponseField>

            <ResponseField name="products_count" type="integer">
              Number of products in the collection.
            </ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="products" type="array">
          Matching products (when requested).
        </ResponseField>

        <ResponseField name="articles" type="array">
          Matching articles (when requested).
        </ResponseField>

        <ResponseField name="pages" type="array">
          Matching pages (when requested).
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

## Example Response

```json theme={null}
{
  "resources": {
    "results": {
      "products": [],
      "collections": [
        {
          "id": "col_abc123",
          "title": "Summer Collection 2024",
          "handle": "summer-collection-2024",
          "description": "Our latest summer styles featuring lightweight fabrics...",
          "published_at": "2024-04-01T00:00:00.000Z",
          "image": "https://cdn.launchmystore.io/images/summer-2024.jpg",
          "url": "/collections/summer-collection-2024",
          "products_count": 48
        },
        {
          "id": "col_def456",
          "title": "Summer Essentials",
          "handle": "summer-essentials",
          "description": "Must-have items for the summer season...",
          "published_at": "2024-04-01T00:00:00.000Z",
          "image": "https://cdn.launchmystore.io/images/summer-essentials.jpg",
          "url": "/collections/summer-essentials",
          "products_count": 24
        }
      ],
      "articles": [],
      "pages": []
    }
  }
}
```