{"openapi":"3.1.0","info":{"title":"Little Bird Electronics Public API","description":"A free, open, read-only API for browsing products, collections, and stock availability. No authentication required. Rate limited to 60 requests/minute.","version":"1.0.0","contact":{"email":"help@littlebirdelectronics.com.au"},"license":{"name":"MIT"}},"servers":[{"url":"https://littlebirdelectronics.com.au/public-api/v1"}],"paths":{"/products":{"get":{"summary":"List products","operationId":"listProducts","parameters":[{"name":"q","in":"query","schema":{"type":"string"},"description":"Search query"},{"name":"in_stock","in":"query","schema":{"type":"string","enum":["true"]},"description":"Filter to in-stock only"},{"name":"vendor","in":"query","schema":{"type":"string"},"description":"Filter by vendor/brand"},{"name":"product_type","in":"query","schema":{"type":"string"},"description":"Filter by product type"},{"name":"page","in":"query","schema":{"type":"integer","default":1}},{"name":"per_page","in":"query","schema":{"type":"integer","default":25,"maximum":100}}],"responses":{"200":{"description":"Paginated list of products","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductList"}}}}}}},"/products/{handle}":{"get":{"summary":"Get product details","operationId":"getProduct","parameters":[{"name":"handle","in":"path","required":true,"schema":{"type":"string"},"description":"Product URL handle (slug)"}],"responses":{"200":{"description":"Product details with variants","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductDetail"}}}},"404":{"description":"Product not found"}}}},"/collections":{"get":{"summary":"List collections","operationId":"listCollections","responses":{"200":{"description":"All published collections","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionList"}}}}}}},"/collections/{handle}":{"get":{"summary":"Get collection with products","operationId":"getCollection","parameters":[{"name":"handle","in":"path","required":true,"schema":{"type":"string"}},{"name":"page","in":"query","schema":{"type":"integer","default":1}},{"name":"per_page","in":"query","schema":{"type":"integer","default":25,"maximum":100}}],"responses":{"200":{"description":"Collection details with paginated products"}}}}},"components":{"schemas":{"ProductSummary":{"type":"object","properties":{"handle":{"type":"string"},"title":{"type":"string"},"vendor":{"type":"string"},"product_type":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"in_stock":{"type":"boolean"},"price":{"type":"number"},"compare_at_price":{"type":"number","nullable":true},"price_currency":{"type":"string","example":"AUD"},"url":{"type":"string"},"image_url":{"type":"string","nullable":true},"variant_count":{"type":"integer"},"published_at":{"type":"string","format":"date-time"}}},"Variant":{"type":"object","properties":{"sku":{"type":"string"},"mpn":{"type":"string","nullable":true},"title":{"type":"string"},"price":{"type":"number"},"compare_at_price":{"type":"number","nullable":true},"price_currency":{"type":"string"},"in_stock":{"type":"boolean"},"available_quantity":{"type":"integer"},"option1":{"type":"string","nullable":true},"option2":{"type":"string","nullable":true},"option3":{"type":"string","nullable":true},"barcode":{"type":"string","nullable":true},"weight":{"type":"number","nullable":true},"weight_unit":{"type":"string","nullable":true}}},"ProductDetail":{"type":"object","properties":{"product":{"type":"object","properties":{"handle":{"type":"string"},"title":{"type":"string"},"description_html":{"type":"string"},"vendor":{"type":"string"},"product_type":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"in_stock":{"type":"boolean"},"url":{"type":"string"},"variants":{"type":"array","items":{"$ref":"#/components/schemas/Variant"}},"images":{"type":"array","items":{"type":"string"}},"average_rating":{"type":"number","nullable":true},"reviews_count":{"type":"integer"}}}}},"ProductList":{"type":"object","properties":{"products":{"type":"array","items":{"$ref":"#/components/schemas/ProductSummary"}},"meta":{"$ref":"#/components/schemas/PaginationMeta"}}},"CollectionList":{"type":"object","properties":{"collections":{"type":"array","items":{"type":"object","properties":{"handle":{"type":"string"},"title":{"type":"string"},"description_html":{"type":"string","nullable":true},"url":{"type":"string"},"product_count":{"type":"integer"}}}}}},"PaginationMeta":{"type":"object","properties":{"total":{"type":"integer"},"page":{"type":"integer"},"per_page":{"type":"integer"},"total_pages":{"type":"integer"}}}}}}