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

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 Products

Search for products by keyword, with filtering and sorting options.

Request

curl -X GET "https://api.launchmystore.io/api/v1/search/products.json?q=t-shirt" \
  -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)
sort
string
default:"relevance"
Sort order: relevance, title-asc, title-desc, price-asc, price-desc, created-desc, best-selling
product_type
string
Filter by product type
vendor
string
Filter by vendor
tag
string
Filter by tag
collection_id
string
Filter to products in a specific collection
price_min
integer
Minimum price in cents
price_max
integer
Maximum price in cents
available
boolean
Filter to only available (in-stock) products
fields
string
Comma-separated list of fields to return

Response

success
boolean
Whether the request succeeded
data
object
Search results

Example Response

{
  "success": true,
  "data": {
    "query": "t-shirt",
    "items": [
      {
        "id": "prod_abc123",
        "title": "Classic Cotton T-Shirt",
        "handle": "classic-cotton-t-shirt",
        "description": "A comfortable everyday t-shirt...",
        "vendor": "MyBrand",
        "product_type": "Apparel",
        "price": 2500,
        "compare_at_price": 3000,
        "available": true,
        "images": [
          {
            "src": "https://cdn.launchmystore.io/images/tshirt-1.jpg",
            "alt": "Classic Cotton T-Shirt"
          }
        ],
        "variants_count": 12,
        "tags": ["cotton", "casual", "summer"]
      },
      {
        "id": "prod_def456",
        "title": "Premium V-Neck T-Shirt",
        "handle": "premium-v-neck-t-shirt",
        "description": "A premium v-neck style...",
        "vendor": "MyBrand",
        "product_type": "Apparel",
        "price": 3500,
        "compare_at_price": null,
        "available": true,
        "images": [
          {
            "src": "https://cdn.launchmystore.io/images/vneck-1.jpg",
            "alt": "Premium V-Neck T-Shirt"
          }
        ],
        "variants_count": 8,
        "tags": ["premium", "v-neck"]
      }
    ],
    "filters": {
      "product_types": [
        {"value": "Apparel", "count": 24},
        {"value": "Accessories", "count": 3}
      ],
      "vendors": [
        {"value": "MyBrand", "count": 20},
        {"value": "PartnerBrand", "count": 7}
      ],
      "tags": [
        {"value": "cotton", "count": 18},
        {"value": "summer", "count": 15},
        {"value": "casual", "count": 12}
      ],
      "price_range": {
        "min": 1500,
        "max": 7500
      }
    },
    "pagination": {
      "page": 1,
      "limit": 24,
      "total": 27,
      "hasMore": true
    }
  }
}

Error Codes

CodeDescription
UNAUTHORIZEDInvalid or missing access token
VALIDATION_ERRORInvalid search parameters