{"uid":"cap_pKWWaIqv3ZhF4fOVztq6L","slug":"blocklabs-catalog-product-search-d9b0186d","name":"BlockLabs Catalog Product Search","description":"Full-text product search over the BlockLabs dropshipping catalog (multi-language). Payer wallet must be deployed (counterfactual smart accounts are not supported).","url":"https://shop.blocklabs.nl/api/search","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["q"],"properties":{"q":{"type":"string","pattern":"\\S","minLength":1,"description":"Search query; matches name, description, SKU, EAN13, manufacturer and taxonomy"},"iso":{"type":"string","default":"en","pattern":"^[a-zA-Z]{2}$","description":"Two-letter language code of an indexed catalog language (400 if not indexed)"},"page":{"type":"string","default":"1","pattern":"^-?[0-9]+$","description":"Page number (integer; values below 1 are clamped to 1)"},"per_page":{"type":"string","default":"20","pattern":"^-?[0-9]+$","description":"Results per page (integer, clamped to 1-250)"},"include_inactive":{"type":"string","description":"Include inactive products when \"true\" or \"1\"; any other value means active only"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["found","page","hits"],"properties":{"hits":{"type":"array","items":{"type":"object","required":["id","sku","ean13","name","description","price","retailPrice","stock","imageUrl","manufacturer","taxonomy","url"],"properties":{"id":{"type":"integer","description":"Catalog product id"},"sku":{"type":"string"},"url":{"type":["string","null"]},"name":{"type":["string","null"],"description":"Localized name for requested iso"},"ean13":{"type":["string","null"]},"price":{"type":["number","null"],"description":"Wholesale price"},"stock":{"type":"integer"},"imageUrl":{"type":["string","null"]},"taxonomy":{"type":"array","items":{"type":"string"}},"description":{"type":["string","null"]},"retailPrice":{"type":["number","null"]},"manufacturer":{"type":["string","null"]}}}},"page":{"type":"integer"},"found":{"type":"integer","description":"Total matching products"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_AlT555LZCj2z7kkBL3q2x","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Full-text search over the BlockLabs dropshipping product catalog with multi-language support, returning paginated product listings with pricing, stock, and metadata.","exampleAgentPrompt":"Search the BlockLabs dropshipping catalog for 'wireless earbuds' in English and show me the first 10 results with their wholesale prices and stock levels.","exampleUseCases":[{"title":"Finding products to list in online store","prompt":"Search the BlockLabs catalog for 'bluetooth speaker' in English and give me the first 20 results including SKU, wholesale price, retail price, and stock count so I can decide what to add to my store."},{"title":"EAN barcode product lookup","prompt":"I have the barcode 8710103622581 — can you search the BlockLabs dropshipping catalog for it and tell me the product name, price, and how many are in stock?"},{"title":"Dutch-language catalog search","prompt":"Search the BlockLabs catalog for 'telefoonhoesje' in Dutch and show me up to 50 results per page, including inactive products, so I can see everything available."}],"resultDescription":"A paginated JSON response containing the total number of matching products ('found'), the current page number, and an array of product hits. Each hit includes catalog product id, SKU, EAN13, localized name, description, wholesale price, retail price, current stock integer, image URL, manufacturer name, taxonomy category array, and product URL.","failureModes":["400 error if the 'iso' language code is not indexed in the catalog","Empty results array if no products match the query","Pagination out of bounds returns empty hits array","Payment/wallet error if caller uses a counterfactual (undeployed) smart account wallet","Missing or blank 'q' parameter causes validation failure","Invalid page or per_page values are clamped rather than errored"],"whenToPreferThis":"Use this endpoint when you need to search the BlockLabs dropshipping catalog by keyword, SKU, EAN13, manufacturer, or taxonomy in a specific language. Prefer this over the category browse endpoint when you have a search term but not a known taxonomy node. Choose this over the product detail endpoint when you need to discover products rather than fetch a known product ID.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:37:23.721Z","isFirstParty":false}