Skip to main content
GET
/
api
/
v1
/
search
/
collections.json
Search Collections
curl --request GET \
  --url https://api.launchmystore.io/api/v1/search/collections.json \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "data": {
    "query": "<string>",
    "items": [
      {}
    ],
    "pagination": {}
  }
}

​
Search Collections

Search for collections by keyword.

​
Request

curl -X GET "https://api.launchmystore.io/api/v1/search/collections.json?q=summer" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

​
Parameters

​
q
string
required
Search query string
​
page
integer
default:"1"
Page number for pagination
​
limit
integer
default:"24"
Number of results per page (max 100)
​
published_status
string
Filter by status: published, unpublished, any
​
sort
string
default:"relevance"
Sort order: relevance, title-asc, title-desc, updated-desc

​
Response

​
success
boolean
Whether the request succeeded
​
data
object
Search results

​
Example Response

{
  "success": true,
  "data": {
    "query": "summer",
    "items": [
      {
        "id": "col_abc123",
        "title": "Summer Collection 2024",
        "handle": "summer-collection-2024",
        "description": "Our latest summer styles featuring lightweight fabrics...",
        "published": true,
        "image": {
          "src": "https://cdn.launchmystore.io/images/summer-2024.jpg",
          "alt": "Summer Collection 2024"
        },
        "products_count": 48
      },
      {
        "id": "col_def456",
        "title": "Summer Essentials",
        "handle": "summer-essentials",
        "description": "Must-have items for the summer season...",
        "published": true,
        "image": {
          "src": "https://cdn.launchmystore.io/images/summer-essentials.jpg",
          "alt": "Summer Essentials"
        },
        "products_count": 24
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 24,
      "total": 5,
      "hasMore": false
    }
  }
}

​
Error Codes

CodeDescription
UNAUTHORIZEDInvalid or missing access token
VALIDATION_ERRORInvalid search parameters