{"uid":"cap_6BL2rpXoIHH8vnOmxa8JV","slug":"brainiac-product-category-classifier-604e8cf7","name":"BRAINIAC Product Category Classifier","description":"Pay-per-call APIs for AI agents: OFAC sanctions screening, compliance checks, token security, and Base chain data via x402. No account. Fixed USDC price. MCP-ready.","url":"https://www.brainiac.software/api/v1/ecommerce-catalog/product-category-classify?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"csv":{"type":"string","maxLength":200000,"minLength":1},"file":{"type":"object","required":["mediaType","fileBase64"],"properties":{"filename":{"type":"string","maxLength":180,"minLength":1},"mediaType":{"enum":["text/csv","application/json","text/plain"],"type":"string"},"fileBase64":{"type":"string","maxLength":12000000,"minLength":1}},"additionalProperties":false},"json":{"type":"string","maxLength":200000,"minLength":1},"products":{"type":"array","items":{"type":"object","properties":{"mpn":{"type":"string","maxLength":80,"minLength":1},"sku":{"type":"string","maxLength":80,"minLength":1},"gtin":{"type":"string","maxLength":20,"minLength":1},"link":{"type":"string","maxLength":2000,"minLength":1},"size":{"type":"string","maxLength":80,"minLength":1},"brand":{"type":"string","maxLength":200,"minLength":1},"color":{"type":"string","maxLength":80,"minLength":1},"price":{"type":"number","maximum":1000000000,"minimum":0},"title":{"type":"string","maxLength":500,"minLength":1},"width":{"type":"number","maximum":1000000000,"minimum":0},"height":{"type":"number","maximum":1000000000,"minimum":0},"length":{"type":"number","maximum":1000000000,"minimum":0},"weight":{"type":"number","maximum":1000000000,"minimum":0},"category":{"type":"string","maxLength":300,"minLength":1},"currency":{"type":"string","maxLength":12,"minLength":1},"imageAlt":{"type":"string","maxLength":300,"minLength":1},"imageUrl":{"type":"string","maxLength":2000,"minLength":1},"material":{"type":"string","maxLength":200,"minLength":1},"condition":{"type":"string","maxLength":40,"minLength":1},"parentSku":{"type":"string","maxLength":80,"minLength":1},"attributes":{"type":"array","items":{"type":"object","required":["name","value"],"properties":{"name":{"type":"string","maxLength":80,"minLength":1},"value":{"type":"string","maxLength":500,"minLength":1}},"additionalProperties":false},"maxItems":40},"imageWidth":{"type":"integer","maximum":20000,"minimum":0},"weightUnit":{"type":"string","maxLength":20,"minLength":1},"description":{"type":"string","maxLength":20000,"minLength":1},"imageHeight":{"type":"integer","maximum":20000,"minimum":0},"availability":{"type":"string","maxLength":40,"minLength":1},"certification":{"type":"string","maxLength":200,"minLength":1},"dimensionUnit":{"type":"string","maxLength":20,"minLength":1},"attributesText":{"type":"string","maxLength":20000,"minLength":1},"additionalImageUrls":{"type":"array","items":{"type":"string","maxLength":2000,"minLength":1},"maxItems":10},"googleProductCategory":{"type":"string","maxLength":300,"minLength":1}},"additionalProperties":false},"maxItems":500},"taxonomy":{"type":"array","items":{"type":"object","required":["category"],"properties":{"terms":{"type":"array","items":{"type":"string","maxLength":80,"minLength":1},"maxItems":20},"category":{"type":"string","maxLength":300,"minLength":1}},"additionalProperties":false},"maxItems":100}}},"responseSchema":{"type":"json","example":{"issues":[{"row":2,"code":"category_inferred","kind":"inferred","field":"category","detail":"One caller-supplied keyword matched the title. The category was not copied onto the product.","productRef":"shirt-1"},{"row":3,"code":"category","kind":"conflict","field":"category","detail":"More than one keyword rule matched: Home > Kitchen, Apparel. No category was chosen.","productRef":"mix-1"}],"status":"classified","checkedAt":"2026-11-03T09:00:00.000Z","limitations":["No sales channel was contacted and no product was published.","Specifications, dimensions, materials, and certifications are not invented.","…"],"productCount":3,"classifications":[{"row":1,"detail":"The supplied category matches the taxonomy. It was not inferred.","status":"observed","inferred":false,"productRef":"mug-1","matchedCategory":"Home > Kitchen","suppliedCategory":"Home > Kitchen","suggestedCategory":""},{"row":2,"detail":"One caller-supplied keyword matched the title. The category was not copied onto the product.","status":"inferred","inferred":true,"productRef":"shirt-1","matchedCategory":"","suppliedCategory":"","suggestedCategory":"Apparel"},"…"],"channelPublished":false,"specificationsInvented":false}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.04","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.04/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_EKDj6swvO_GfW5zfLQAtM","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.04","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Classifies e-commerce products into taxonomy categories and validates/infers categories from product data supplied as a list, CSV, JSON, or file.","exampleAgentPrompt":"Classify the categories for my product list — I'll give you the titles, brands, and any existing categories I already have, and I need you to tell me whether each one matches a known taxonomy, infer categories for any missing ones, and flag any conflicts.","exampleUseCases":[{"title":"Auto-categorize uncategorized product feed","prompt":"I have a CSV of 500 products that don't have categories assigned yet. Can you classify them into standard e-commerce taxonomy categories based on their titles and brands?"},{"title":"Validate existing Google Shopping categories","prompt":"I need to check whether the categories I've already assigned to my products are correct against a standard taxonomy. Here's my product list with titles and existing categories — flag any mismatches or conflicts."},{"title":"Resolve category conflicts before marketplace listing","prompt":"I'm about to submit my catalog to a marketplace but I'm worried some products match multiple categories. Can you run my product data through and identify any category conflicts so I can fix them before submitting?"}],"resultDescription":"A JSON object containing: a 'status' field (e.g. 'classified'), a 'classifications' array with per-product rows showing productRef, inferred/observed status, suppliedCategory, matchedCategory, suggestedCategory, and detail; an 'issues' array listing conflicts or inferred categories with row numbers and codes; productCount; checkedAt timestamp; channelPublished (always false); specificationsInvented (always false); and a limitations list explaining what the service does and does not do.","failureModes":["No products supplied — request rejected if both 'products' array and file/csv/json fields are absent","Category conflict when multiple keyword rules match — no category chosen, returned as conflict issue","Oversized input — CSV or JSON exceeding 200,000 characters or file base64 exceeding 12MB will be rejected","Unknown taxonomy — categories not in the supported taxonomy cannot be matched","Ambiguous product data — sparse titles or missing attributes may result in no suggested category"],"whenToPreferThis":"Use this endpoint when you need to classify, validate, or infer e-commerce product categories at scale without setting up an account or subscription. It is well-suited for one-off catalog audits, pre-listing checks, or agent-driven pipelines that process product feeds. It supports flexible input (array, CSV, JSON, or file) and returns per-product classification results with conflict detection, making it preferable over manual taxonomy lookups or heavyweight PIM systems for lightweight catalog enrichment tasks.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-17T00:36:50.336Z","isFirstParty":false,"canonicalSlug":"brainiac-product-category-classifier-604e8cf7"}