{"openapi":"3.1.0","info":{"title":"Little Bird Electronics Public API","description":"A free, open API for browsing products, collections, and stock availability. No authentication required for browsing. Rate limited to 60 requests/minute. Customer-scoped endpoints (orders, quotes, cart, wishlist, addresses) use a bearer token from the email-code sign-in flow — see /auth.md for the agent walkthrough.","version":"1.0.0","contact":{"email":"team@littlebirdelectronics.com.au"},"license":{"name":"MIT"}},"servers":[{"url":"https://littlebirdelectronics.com.au"}],"paths":{"/public-api/v1/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"}}}}}}},"/public-api/v1/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"}}}},"/public-api/v1/collections":{"get":{"summary":"List collections","operationId":"listCollections","responses":{"200":{"description":"All published collections","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionList"}}}}}}},"/public-api/v1/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}}},"Document":{"type":"object","description":"A datasheet, guide, code sample or other resource attached to the product. `link: true` means the URL is a page on another site rather than a file to download.","properties":{"title":{"type":"string"},"type":{"type":"string"},"type_label":{"type":"string"},"url":{"type":"string"},"link":{"type":"boolean"},"file_extension":{"type":"string","nullable":true},"file_size":{"type":"integer","nullable":true},"description":{"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"}},"documents":{"type":"array","items":{"$ref":"#/components/schemas/Document"}},"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"}}}}},"x-service-info":{"categories":["shopping","electronics"],"docs":{"homepage":"https://littlebirdelectronics.com.au/help/public-api","llms":"https://littlebirdelectronics.com.au/llms.txt","apiReference":"https://littlebirdelectronics.com.au/public-api/v1/openapi.json"}}}