{"openapi":"3.1.0","info":{"title":"Brand Protection API","version":"1.0.0","description":"Read supplied listings, reference products, and images, and organize evidence without deciding infringement. Paid with x402 exact USDC on Base. No account is required.","contact":{"email":"support@brainiac.software"},"x-guidance":"BRAINIAC.software is a pay-per-call API for software agents. No account or API key is required.\nPayment uses the x402 protocol with exact USDC on Base (chain id 8453). Each POST operation has a fixed USD price.\nHow to call an operation:\n1. POST a JSON body matching the operation's requestBody schema to the operation path. Include an Idempotency-Key header (64 hex characters, 32 random bytes).\n2. If you have not paid, the server responds 402 with payment requirements in the body. Pay the exact amount to the payTo address on Base.\n3. Retry the identical request with the same Idempotency-Key and add a payment-signature header containing the x402 payment payload. On success (200) the operation result is returned.\n4. Reuse the same Idempotency-Key only for retries of the same operation and request body; it will not be charged twice.\nAll outputs are compliance prechecks, drafts, or data lookups for human review. They are not official determinations, legal advice, identity confirmation, or certified filings. Verify time-sensitive or official data with the cited source before acting."},"servers":[{"url":"https://www.brainiac.software"}],"paths":{"/api/v1/brand-protection/product-listing-match":{"post":{"operationId":"match_a_listing_to_a_supplied_brand","summary":"Match a listing to a supplied brand","description":"Find a supplied brand name only when it is the listing brand field or a whole name in the title, description, or public page title. A partial overlap is not matched, and a name match is not a trademark determination.","tags":["brand-protection"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"brands":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"owner":{"type":"string","maxLength":160}},"required":["name"],"additionalProperties":false}},"products":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"brand":{"type":"string","maxLength":120},"title":{"type":"string","maxLength":300},"sku":{"type":"string","maxLength":80},"price":{"type":"number","minimum":0,"maximum":1000000000},"currency":{"type":"string","maxLength":12},"imageUrl":{"type":"string","maxLength":2000},"description":{"type":"string","maxLength":2000}},"additionalProperties":false}},"listings":{"maxItems":40,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"productId":{"type":"string","maxLength":80},"url":{"type":"string","maxLength":2000},"marketplace":{"type":"string","maxLength":80},"seller":{"type":"string","maxLength":160},"title":{"type":"string","maxLength":300},"price":{"type":"number","minimum":0,"maximum":1000000000},"currency":{"type":"string","maxLength":12},"brand":{"type":"string","maxLength":120},"sku":{"type":"string","maxLength":80},"imageUrl":{"type":"string","maxLength":2000},"observed":{"type":"string","maxLength":40},"description":{"type":"string","maxLength":2000}},"additionalProperties":false}},"images":{"maxItems":8,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"role":{"type":"string","enum":["reference","listing"]},"listingId":{"type":"string","maxLength":80},"productId":{"type":"string","maxLength":80},"url":{"type":"string","maxLength":2000},"mediaType":{"type":"string","enum":["image/png","image/jpeg","image/webp","image/gif"]},"fileBase64":{"type":"string","maxLength":2200000}},"additionalProperties":false}},"authorizedSellers":{"maxItems":40,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":160}},"required":["name"],"additionalProperties":false}},"registrations":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"office":{"type":"string","maxLength":120},"mark":{"type":"string","maxLength":160},"status":{"type":"string","maxLength":80}},"additionalProperties":false}},"rules":{"maxItems":8,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":40},"value":{"type":"string","maxLength":40}},"required":["name","value"],"additionalProperties":false}}},"additionalProperties":false},"example":{"text":"Brand: Example | Example Goods\nListing: L-1 | | Example Market | Shop A | Example kettle | 40 | USD | Example | SKU-1 | | 2026-11-01 | Blue kettle\nThe listing is fake.\nListing: L-2 | | Example Market | Shop B | kettle | 10 | USD | Other | SKU-2 | | 2026-11-01 |\n"}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"matches":{"type":"array","items":{"type":"object","properties":{"listingId":{"type":"string"},"brand":{"type":"string"},"fields":{"type":"string"},"matched":{"type":"boolean"},"quote":{"type":"string"},"sourceUrl":{"type":"string"},"retrievedAt":{"type":"string"},"infringementDetermined":{"type":"boolean"},"interpretation":{"type":"string"}},"additionalProperties":true}},"requestsSent":{"type":"number"},"accountAccessed":{"type":"boolean"},"authenticationBypassed":{"type":"boolean"},"captchaBypassed":{"type":"boolean"},"infringementDetermined":{"type":"boolean"},"counterfeitConfirmed":{"type":"boolean"},"listingRemoved":{"type":"boolean"},"legalConclusion":{"type":"boolean"},"findings":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"code":{"type":"string"},"subject":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T11:00:00.000Z","status":"checked","matches":[{"listingId":"L-1","brand":"Example","fields":"brand,title","matched":true,"quote":"Example","sourceUrl":"","retrievedAt":"2026-11-01","infringementDetermined":false,"interpretation":"stated"},{"listingId":"L-2","brand":"Example","fields":"","matched":false,"quote":"","sourceUrl":"","retrievedAt":"2026-11-01","infringementDetermined":false,"interpretation":"none"}],"requestsSent":0,"accountAccessed":false,"authenticationBypassed":false,"captchaBypassed":false,"infringementDetermined":false,"counterfeitConfirmed":false,"listingRemoved":false,"legalConclusion":false,"findings":[{"kind":"ignored","code":"unlabeled_line","subject":"","detail":"Lines without a recognized label were not read and their text was not copied."},{"kind":"observation","code":"not_a_determination","subject":"","detail":"A supplied brand name appears in a listing. This is not a trademark determination."}],"limitations":["Listings, brand names, and images are taken from the request or from one public page the caller named.","A public page is fetched with one HTTP GET. Login pages and CAPTCHAs are not bypassed.","Image similarity is the mean color difference after both images are drawn at 16 by 16. A difference of 12 or less is similar. It is not proof of counterfeiting.","A brand name in a listing is not a finding of trademark infringement.","No seller account is accessed and no listing is removed."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{}}]}}},"/api/v1/brand-protection/suspected-counterfeit-listing-detect":{"post":{"operationId":"detect_listing_signals_against_a_reference","summary":"Detect listing signals against a reference","description":"Compare a listing with one linked reference product and report brand, price, and stated-word differences. A signal is not a finding that the listing is counterfeit.","tags":["brand-protection"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"brands":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"owner":{"type":"string","maxLength":160}},"required":["name"],"additionalProperties":false}},"products":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"brand":{"type":"string","maxLength":120},"title":{"type":"string","maxLength":300},"sku":{"type":"string","maxLength":80},"price":{"type":"number","minimum":0,"maximum":1000000000},"currency":{"type":"string","maxLength":12},"imageUrl":{"type":"string","maxLength":2000},"description":{"type":"string","maxLength":2000}},"additionalProperties":false}},"listings":{"maxItems":40,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"productId":{"type":"string","maxLength":80},"url":{"type":"string","maxLength":2000},"marketplace":{"type":"string","maxLength":80},"seller":{"type":"string","maxLength":160},"title":{"type":"string","maxLength":300},"price":{"type":"number","minimum":0,"maximum":1000000000},"currency":{"type":"string","maxLength":12},"brand":{"type":"string","maxLength":120},"sku":{"type":"string","maxLength":80},"imageUrl":{"type":"string","maxLength":2000},"observed":{"type":"string","maxLength":40},"description":{"type":"string","maxLength":2000}},"additionalProperties":false}},"images":{"maxItems":8,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"role":{"type":"string","enum":["reference","listing"]},"listingId":{"type":"string","maxLength":80},"productId":{"type":"string","maxLength":80},"url":{"type":"string","maxLength":2000},"mediaType":{"type":"string","enum":["image/png","image/jpeg","image/webp","image/gif"]},"fileBase64":{"type":"string","maxLength":2200000}},"additionalProperties":false}},"authorizedSellers":{"maxItems":40,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":160}},"required":["name"],"additionalProperties":false}},"registrations":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"office":{"type":"string","maxLength":120},"mark":{"type":"string","maxLength":160},"status":{"type":"string","maxLength":80}},"additionalProperties":false}},"rules":{"maxItems":8,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":40},"value":{"type":"string","maxLength":40}},"required":["name","value"],"additionalProperties":false}}},"additionalProperties":false},"example":{"products":[{"id":"P-1","brand":"Example","title":"Example kettle","sku":"SKU-1","price":80,"currency":"USD"}],"listings":[{"id":"L-1","productId":"P-1","marketplace":"Example Market","seller":"Shop B","title":"replica kettle","price":20,"currency":"USD","brand":"Other","sku":"SKU-9"}],"rules":[{"name":"price","value":"0.5"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"listings":{"type":"array","items":{"type":"object","properties":{"listingId":{"type":"string"},"productId":{"type":"string"},"level":{"type":"string"},"counterfeitConfirmed":{"type":"boolean"},"signals":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"kind":{"type":"string"},"confirmed":{"type":"boolean"},"detail":{"type":"string"}},"additionalProperties":true}}},"additionalProperties":true}},"requestsSent":{"type":"number"},"accountAccessed":{"type":"boolean"},"authenticationBypassed":{"type":"boolean"},"captchaBypassed":{"type":"boolean"},"infringementDetermined":{"type":"boolean"},"counterfeitConfirmed":{"type":"boolean"},"listingRemoved":{"type":"boolean"},"legalConclusion":{"type":"boolean"},"findings":{"type":"array","items":{}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T11:00:00.000Z","status":"checked","listings":[{"listingId":"L-1","productId":"P-1","level":"review","counterfeitConfirmed":false,"signals":[{"code":"brand_mismatch","kind":"indicator","confirmed":false,"detail":"Both brand fields are present and they differ. This is not a finding of counterfeiting."},{"code":"stated_replica_word","kind":"indicator","confirmed":false,"detail":"The listing text contains the word \"replica\". The word is not proof of counterfeiting."},{"code":"sku_differs","kind":"observation","confirmed":false,"detail":"Both SKUs are present and they differ."},{"code":"title_differs","kind":"observation","confirmed":false,"detail":"Both titles are present and they differ."},{"code":"price_below","kind":"indicator","confirmed":false,"detail":"The listing price is below the supplied fraction of the reference price. This is not a finding of counterfeiting."}]}],"requestsSent":0,"accountAccessed":false,"authenticationBypassed":false,"captchaBypassed":false,"infringementDetermined":false,"counterfeitConfirmed":false,"listingRemoved":false,"legalConclusion":false,"findings":[],"limitations":["Listings, brand names, and images are taken from the request or from one public page the caller named.","A public page is fetched with one HTTP GET. Login pages and CAPTCHAs are not bypassed.","Image similarity is the mean color difference after both images are drawn at 16 by 16. A difference of 12 or less is similar. It is not proof of counterfeiting.","A brand name in a listing is not a finding of trademark infringement.","No seller account is accessed and no listing is removed."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]}}},"/api/v1/brand-protection/product-image-similarity-check":{"post":{"operationId":"compare_product_images","summary":"Compare product images","description":"Decode the supplied reference and listing images and compare their pixels. Images that cannot be decoded are not compared, and a visual match is not proof of counterfeiting.","tags":["brand-protection"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"brands":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"owner":{"type":"string","maxLength":160}},"required":["name"],"additionalProperties":false}},"products":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"brand":{"type":"string","maxLength":120},"title":{"type":"string","maxLength":300},"sku":{"type":"string","maxLength":80},"price":{"type":"number","minimum":0,"maximum":1000000000},"currency":{"type":"string","maxLength":12},"imageUrl":{"type":"string","maxLength":2000},"description":{"type":"string","maxLength":2000}},"additionalProperties":false}},"listings":{"maxItems":40,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"productId":{"type":"string","maxLength":80},"url":{"type":"string","maxLength":2000},"marketplace":{"type":"string","maxLength":80},"seller":{"type":"string","maxLength":160},"title":{"type":"string","maxLength":300},"price":{"type":"number","minimum":0,"maximum":1000000000},"currency":{"type":"string","maxLength":12},"brand":{"type":"string","maxLength":120},"sku":{"type":"string","maxLength":80},"imageUrl":{"type":"string","maxLength":2000},"observed":{"type":"string","maxLength":40},"description":{"type":"string","maxLength":2000}},"additionalProperties":false}},"images":{"maxItems":8,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"role":{"type":"string","enum":["reference","listing"]},"listingId":{"type":"string","maxLength":80},"productId":{"type":"string","maxLength":80},"url":{"type":"string","maxLength":2000},"mediaType":{"type":"string","enum":["image/png","image/jpeg","image/webp","image/gif"]},"fileBase64":{"type":"string","maxLength":2200000}},"additionalProperties":false}},"authorizedSellers":{"maxItems":40,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":160}},"required":["name"],"additionalProperties":false}},"registrations":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"office":{"type":"string","maxLength":120},"mark":{"type":"string","maxLength":160},"status":{"type":"string","maxLength":80}},"additionalProperties":false}},"rules":{"maxItems":8,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":40},"value":{"type":"string","maxLength":40}},"required":["name","value"],"additionalProperties":false}}},"additionalProperties":false},"example":{"images":[{"id":"R-1","role":"reference","productId":"P-1","mediaType":"image/png","fileBase64":"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAIAAACQd1PeAAAADElEQVR4nGO4IycHAALyARlzRAvLAAAAAElFTkSuQmCC"},{"id":"I-1","role":"listing","listingId":"L-1","productId":"P-1","mediaType":"image/png","fileBase64":"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAIAAACQd1PeAAAADElEQVR4nGO4IycHAALyARlzRAvLAAAAAElFTkSuQmCC"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"pairs":{"type":"array","items":{"type":"object","properties":{"referenceId":{"type":"string"},"listingImageId":{"type":"string"},"listingId":{"type":"string"},"productId":{"type":"string"},"referenceUrl":{"type":"string"},"listingUrl":{"type":"string"},"referenceRetrievedAt":{"type":"string"},"retrievedAt":{"type":"string"},"visualSimilarity":{"type":"string"},"distance":{"type":"number"},"distanceSupplied":{"type":"boolean"},"counterfeitConfirmed":{"type":"boolean"},"detail":{"type":"string"}},"additionalProperties":true}},"requestsSent":{"type":"number"},"accountAccessed":{"type":"boolean"},"authenticationBypassed":{"type":"boolean"},"captchaBypassed":{"type":"boolean"},"infringementDetermined":{"type":"boolean"},"counterfeitConfirmed":{"type":"boolean"},"listingRemoved":{"type":"boolean"},"legalConclusion":{"type":"boolean"},"findings":{"type":"array","items":{}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T11:00:00.000Z","status":"compared","pairs":[{"referenceId":"R-1","listingImageId":"I-1","listingId":"L-1","productId":"P-1","referenceUrl":"","listingUrl":"","referenceRetrievedAt":"","retrievedAt":"","visualSimilarity":"identical","distance":0,"distanceSupplied":false,"counterfeitConfirmed":false,"detail":"The image files match. Matching files are not proof of counterfeiting."}],"requestsSent":0,"accountAccessed":false,"authenticationBypassed":false,"captchaBypassed":false,"infringementDetermined":false,"counterfeitConfirmed":false,"listingRemoved":false,"legalConclusion":false,"findings":[],"limitations":["Listings, brand names, and images are taken from the request or from one public page the caller named.","A public page is fetched with one HTTP GET. Login pages and CAPTCHAs are not bypassed.","Image similarity is the mean color difference after both images are drawn at 16 by 16. A difference of 12 or less is similar. It is not proof of counterfeiting.","A brand name in a listing is not a finding of trademark infringement.","No seller account is accessed and no listing is removed."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]}}},"/api/v1/brand-protection/unauthorized-seller-evidence-extract":{"post":{"operationId":"extract_seller_evidence","summary":"Extract seller evidence","description":"Copy the seller, marketplace, source URL, and timestamp from the supplied listing or a public page. A name missing from the supplied list is not a finding that the sale is unauthorized.","tags":["brand-protection"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"brands":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"owner":{"type":"string","maxLength":160}},"required":["name"],"additionalProperties":false}},"products":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"brand":{"type":"string","maxLength":120},"title":{"type":"string","maxLength":300},"sku":{"type":"string","maxLength":80},"price":{"type":"number","minimum":0,"maximum":1000000000},"currency":{"type":"string","maxLength":12},"imageUrl":{"type":"string","maxLength":2000},"description":{"type":"string","maxLength":2000}},"additionalProperties":false}},"listings":{"maxItems":40,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"productId":{"type":"string","maxLength":80},"url":{"type":"string","maxLength":2000},"marketplace":{"type":"string","maxLength":80},"seller":{"type":"string","maxLength":160},"title":{"type":"string","maxLength":300},"price":{"type":"number","minimum":0,"maximum":1000000000},"currency":{"type":"string","maxLength":12},"brand":{"type":"string","maxLength":120},"sku":{"type":"string","maxLength":80},"imageUrl":{"type":"string","maxLength":2000},"observed":{"type":"string","maxLength":40},"description":{"type":"string","maxLength":2000}},"additionalProperties":false}},"images":{"maxItems":8,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"role":{"type":"string","enum":["reference","listing"]},"listingId":{"type":"string","maxLength":80},"productId":{"type":"string","maxLength":80},"url":{"type":"string","maxLength":2000},"mediaType":{"type":"string","enum":["image/png","image/jpeg","image/webp","image/gif"]},"fileBase64":{"type":"string","maxLength":2200000}},"additionalProperties":false}},"authorizedSellers":{"maxItems":40,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":160}},"required":["name"],"additionalProperties":false}},"registrations":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"office":{"type":"string","maxLength":120},"mark":{"type":"string","maxLength":160},"status":{"type":"string","maxLength":80}},"additionalProperties":false}},"rules":{"maxItems":8,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":40},"value":{"type":"string","maxLength":40}},"required":["name","value"],"additionalProperties":false}}},"additionalProperties":false},"example":{"authorizedSellers":[{"name":"Shop A"}],"listings":[{"id":"L-1","marketplace":"Example Market","seller":"Shop A","url":"","observed":"2026-11-01"},{"id":"L-2","marketplace":"Example Market","seller":"Shop B","observed":"2026-11-02"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"sellers":{"type":"array","items":{"type":"object","properties":{"listingId":{"type":"string"},"seller":{"type":"string"},"marketplace":{"type":"string"},"sourceUrl":{"type":"string"},"finalUrl":{"type":"string"},"observed":{"type":"string"},"retrievedAt":{"type":"string"},"httpStatus":{"type":"number"},"listState":{"type":"string"},"unauthorizedConfirmed":{"type":"boolean"},"interpretation":{"type":"string"}},"additionalProperties":true}},"requestsSent":{"type":"number"},"accountAccessed":{"type":"boolean"},"authenticationBypassed":{"type":"boolean"},"captchaBypassed":{"type":"boolean"},"infringementDetermined":{"type":"boolean"},"counterfeitConfirmed":{"type":"boolean"},"listingRemoved":{"type":"boolean"},"legalConclusion":{"type":"boolean"},"findings":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"code":{"type":"string"},"subject":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T11:00:00.000Z","status":"checked","sellers":[{"listingId":"L-1","seller":"Shop A","marketplace":"Example Market","sourceUrl":"","finalUrl":"","observed":"2026-11-01","retrievedAt":"","httpStatus":0,"listState":"on_list","unauthorizedConfirmed":false,"interpretation":"stated"},{"listingId":"L-2","seller":"Shop B","marketplace":"Example Market","sourceUrl":"","finalUrl":"","observed":"2026-11-02","retrievedAt":"","httpStatus":0,"listState":"not_on_list","unauthorizedConfirmed":false,"interpretation":"stated"}],"requestsSent":0,"accountAccessed":false,"authenticationBypassed":false,"captchaBypassed":false,"infringementDetermined":false,"counterfeitConfirmed":false,"listingRemoved":false,"legalConclusion":false,"findings":[{"kind":"observation","code":"not_on_list","subject":"","detail":"A seller name is not on the supplied list. This is not a finding that the sale is unauthorized."}],"limitations":["Listings, brand names, and images are taken from the request or from one public page the caller named.","A public page is fetched with one HTTP GET. Login pages and CAPTCHAs are not bypassed.","Image similarity is the mean color difference after both images are drawn at 16 by 16. A difference of 12 or less is similar. It is not proof of counterfeiting.","A brand name in a listing is not a finding of trademark infringement.","No seller account is accessed and no listing is removed."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{}}]}}},"/api/v1/brand-protection/name-usage-audit":{"post":{"operationId":"audit_brand_name_usage","summary":"Audit brand-name usage","description":"Record each whole supplied brand name in a listing field or public page title. A partial overlap is not counted, and usage is not a trademark determination.","tags":["brand-protection"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"brands":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"owner":{"type":"string","maxLength":160}},"required":["name"],"additionalProperties":false}},"products":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"brand":{"type":"string","maxLength":120},"title":{"type":"string","maxLength":300},"sku":{"type":"string","maxLength":80},"price":{"type":"number","minimum":0,"maximum":1000000000},"currency":{"type":"string","maxLength":12},"imageUrl":{"type":"string","maxLength":2000},"description":{"type":"string","maxLength":2000}},"additionalProperties":false}},"listings":{"maxItems":40,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"productId":{"type":"string","maxLength":80},"url":{"type":"string","maxLength":2000},"marketplace":{"type":"string","maxLength":80},"seller":{"type":"string","maxLength":160},"title":{"type":"string","maxLength":300},"price":{"type":"number","minimum":0,"maximum":1000000000},"currency":{"type":"string","maxLength":12},"brand":{"type":"string","maxLength":120},"sku":{"type":"string","maxLength":80},"imageUrl":{"type":"string","maxLength":2000},"observed":{"type":"string","maxLength":40},"description":{"type":"string","maxLength":2000}},"additionalProperties":false}},"images":{"maxItems":8,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"role":{"type":"string","enum":["reference","listing"]},"listingId":{"type":"string","maxLength":80},"productId":{"type":"string","maxLength":80},"url":{"type":"string","maxLength":2000},"mediaType":{"type":"string","enum":["image/png","image/jpeg","image/webp","image/gif"]},"fileBase64":{"type":"string","maxLength":2200000}},"additionalProperties":false}},"authorizedSellers":{"maxItems":40,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":160}},"required":["name"],"additionalProperties":false}},"registrations":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"office":{"type":"string","maxLength":120},"mark":{"type":"string","maxLength":160},"status":{"type":"string","maxLength":80}},"additionalProperties":false}},"rules":{"maxItems":8,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":40},"value":{"type":"string","maxLength":40}},"required":["name","value"],"additionalProperties":false}}},"additionalProperties":false},"example":{"brands":[{"name":"Example"}],"listings":[{"id":"L-1","title":"Example kettle","description":"Sold by Examples","brand":""}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"uses":{"type":"array","items":{"type":"object","properties":{"listingId":{"type":"string"},"brand":{"type":"string"},"field":{"type":"string"},"quote":{"type":"string"},"sourceUrl":{"type":"string"},"retrievedAt":{"type":"string"},"trademarkInfringement":{"type":"boolean"},"interpretation":{"type":"string"}},"additionalProperties":true}},"requestsSent":{"type":"number"},"accountAccessed":{"type":"boolean"},"authenticationBypassed":{"type":"boolean"},"captchaBypassed":{"type":"boolean"},"infringementDetermined":{"type":"boolean"},"counterfeitConfirmed":{"type":"boolean"},"listingRemoved":{"type":"boolean"},"legalConclusion":{"type":"boolean"},"findings":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"code":{"type":"string"},"subject":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T11:00:00.000Z","status":"found","uses":[{"listingId":"L-1","brand":"Example","field":"title","quote":"Example kettle","sourceUrl":"","retrievedAt":"","trademarkInfringement":false,"interpretation":"stated"}],"requestsSent":0,"accountAccessed":false,"authenticationBypassed":false,"captchaBypassed":false,"infringementDetermined":false,"counterfeitConfirmed":false,"listingRemoved":false,"legalConclusion":false,"findings":[{"kind":"observation","code":"partial_overlap","subject":"L-1","detail":"The description overlaps the brand name without containing it as a whole name. It was not counted."}],"limitations":["Listings, brand names, and images are taken from the request or from one public page the caller named.","A public page is fetched with one HTTP GET. Login pages and CAPTCHAs are not bypassed.","Image similarity is the mean color difference after both images are drawn at 16 by 16. A difference of 12 or less is similar. It is not proof of counterfeiting.","A brand name in a listing is not a finding of trademark infringement.","No seller account is accessed and no listing is removed."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{}}]}}},"/api/v1/brand-protection/marketplace-listing-compare":{"post":{"operationId":"compare_two_listing_records","summary":"Compare two listing records","description":"Compare supplied titles, brands, sellers, prices, and decoded images field by field. Different currencies are not converted, and a difference is not a finding that either listing is counterfeit.","tags":["brand-protection"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"brands":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"owner":{"type":"string","maxLength":160}},"required":["name"],"additionalProperties":false}},"products":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"brand":{"type":"string","maxLength":120},"title":{"type":"string","maxLength":300},"sku":{"type":"string","maxLength":80},"price":{"type":"number","minimum":0,"maximum":1000000000},"currency":{"type":"string","maxLength":12},"imageUrl":{"type":"string","maxLength":2000},"description":{"type":"string","maxLength":2000}},"additionalProperties":false}},"listings":{"maxItems":40,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"productId":{"type":"string","maxLength":80},"url":{"type":"string","maxLength":2000},"marketplace":{"type":"string","maxLength":80},"seller":{"type":"string","maxLength":160},"title":{"type":"string","maxLength":300},"price":{"type":"number","minimum":0,"maximum":1000000000},"currency":{"type":"string","maxLength":12},"brand":{"type":"string","maxLength":120},"sku":{"type":"string","maxLength":80},"imageUrl":{"type":"string","maxLength":2000},"observed":{"type":"string","maxLength":40},"description":{"type":"string","maxLength":2000}},"additionalProperties":false}},"images":{"maxItems":8,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"role":{"type":"string","enum":["reference","listing"]},"listingId":{"type":"string","maxLength":80},"productId":{"type":"string","maxLength":80},"url":{"type":"string","maxLength":2000},"mediaType":{"type":"string","enum":["image/png","image/jpeg","image/webp","image/gif"]},"fileBase64":{"type":"string","maxLength":2200000}},"additionalProperties":false}},"authorizedSellers":{"maxItems":40,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":160}},"required":["name"],"additionalProperties":false}},"registrations":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"office":{"type":"string","maxLength":120},"mark":{"type":"string","maxLength":160},"status":{"type":"string","maxLength":80}},"additionalProperties":false}},"rules":{"maxItems":8,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":40},"value":{"type":"string","maxLength":40}},"required":["name","value"],"additionalProperties":false}}},"additionalProperties":false},"example":{"listings":[{"id":"L-1","title":"Example kettle","brand":"Example","seller":"Shop A","price":80,"currency":"USD","sku":"SKU-1"},{"id":"L-2","title":"Example kettle","brand":"Other","seller":"Shop B","price":20,"currency":"USD","sku":"SKU-9"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"leftId":{"type":"string"},"rightId":{"type":"string"},"fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"left":{"type":"string"},"right":{"type":"string"},"state":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"requestsSent":{"type":"number"},"accountAccessed":{"type":"boolean"},"authenticationBypassed":{"type":"boolean"},"captchaBypassed":{"type":"boolean"},"infringementDetermined":{"type":"boolean"},"counterfeitConfirmed":{"type":"boolean"},"listingRemoved":{"type":"boolean"},"legalConclusion":{"type":"boolean"},"findings":{"type":"array","items":{}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T11:00:00.000Z","status":"compared","leftId":"L-1","rightId":"L-2","fields":[{"name":"title","left":"Example kettle","right":"Example kettle","state":"same","detail":"The supplied values match."},{"name":"brand","left":"Example","right":"Other","state":"differs","detail":"The supplied values differ."},{"name":"seller","left":"Shop A","right":"Shop B","state":"differs","detail":"The supplied values differ."},{"name":"sku","left":"SKU-1","right":"SKU-9","state":"differs","detail":"The supplied values differ."},{"name":"price","left":"80","right":"20","state":"differs","detail":"The supplied values differ."},{"name":"currency","left":"USD","right":"USD","state":"same","detail":"The supplied values match."},{"name":"url","left":"","right":"","state":"missing","detail":"One or both records omit this field."},{"name":"image","left":"","right":"","state":"not_compared","detail":"The images were not both decoded, so they were not compared."}],"requestsSent":0,"accountAccessed":false,"authenticationBypassed":false,"captchaBypassed":false,"infringementDetermined":false,"counterfeitConfirmed":false,"listingRemoved":false,"legalConclusion":false,"findings":[],"limitations":["Listings, brand names, and images are taken from the request or from one public page the caller named.","A public page is fetched with one HTTP GET. Login pages and CAPTCHAs are not bypassed.","Image similarity is the mean color difference after both images are drawn at 16 by 16. A difference of 12 or less is similar. It is not proof of counterfeiting.","A brand name in a listing is not a finding of trademark infringement.","No seller account is accessed and no listing is removed."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]}}},"/api/v1/brand-protection/intellectual-property-evidence-package":{"post":{"operationId":"package_intellectual_property_evidence","summary":"Package intellectual-property evidence","description":"Collect the supplied listing, registration text, decoded image hash, source URL, and timestamp, and list the pieces that were not supplied. The package is not a legal conclusion.","tags":["brand-protection"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"brands":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"owner":{"type":"string","maxLength":160}},"required":["name"],"additionalProperties":false}},"products":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"brand":{"type":"string","maxLength":120},"title":{"type":"string","maxLength":300},"sku":{"type":"string","maxLength":80},"price":{"type":"number","minimum":0,"maximum":1000000000},"currency":{"type":"string","maxLength":12},"imageUrl":{"type":"string","maxLength":2000},"description":{"type":"string","maxLength":2000}},"additionalProperties":false}},"listings":{"maxItems":40,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"productId":{"type":"string","maxLength":80},"url":{"type":"string","maxLength":2000},"marketplace":{"type":"string","maxLength":80},"seller":{"type":"string","maxLength":160},"title":{"type":"string","maxLength":300},"price":{"type":"number","minimum":0,"maximum":1000000000},"currency":{"type":"string","maxLength":12},"brand":{"type":"string","maxLength":120},"sku":{"type":"string","maxLength":80},"imageUrl":{"type":"string","maxLength":2000},"observed":{"type":"string","maxLength":40},"description":{"type":"string","maxLength":2000}},"additionalProperties":false}},"images":{"maxItems":8,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"role":{"type":"string","enum":["reference","listing"]},"listingId":{"type":"string","maxLength":80},"productId":{"type":"string","maxLength":80},"url":{"type":"string","maxLength":2000},"mediaType":{"type":"string","enum":["image/png","image/jpeg","image/webp","image/gif"]},"fileBase64":{"type":"string","maxLength":2200000}},"additionalProperties":false}},"authorizedSellers":{"maxItems":40,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":160}},"required":["name"],"additionalProperties":false}},"registrations":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"office":{"type":"string","maxLength":120},"mark":{"type":"string","maxLength":160},"status":{"type":"string","maxLength":80}},"additionalProperties":false}},"rules":{"maxItems":8,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":40},"value":{"type":"string","maxLength":40}},"required":["name","value"],"additionalProperties":false}}},"additionalProperties":false},"example":{"brands":[{"name":"Example","owner":"Example Goods"}],"listings":[{"id":"L-1","seller":"Shop B","title":"Example kettle","brand":"Example","marketplace":"Example Market"}],"registrations":[{"id":"TM-1","office":"Example Office","mark":"Example","status":"listed by caller"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"items":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"subject":{"type":"string"},"sourceUrl":{"type":"string"},"retrievedAt":{"type":"string"},"text":{"type":"string"},"sha256":{"type":"string"},"legalConclusion":{"type":"boolean"},"interpretation":{"type":"string"}},"additionalProperties":true}},"requestsSent":{"type":"number"},"accountAccessed":{"type":"boolean"},"authenticationBypassed":{"type":"boolean"},"captchaBypassed":{"type":"boolean"},"infringementDetermined":{"type":"boolean"},"counterfeitConfirmed":{"type":"boolean"},"listingRemoved":{"type":"boolean"},"legalConclusion":{"type":"boolean"},"findings":{"type":"array","items":{}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T11:00:00.000Z","status":"packaged","items":[{"kind":"gap","subject":"reference","sourceUrl":"","retrievedAt":"","text":"No reference product was supplied.","sha256":"","legalConclusion":false,"interpretation":"none"},{"kind":"listing","subject":"L-1","sourceUrl":"","retrievedAt":"","text":"Example Market | Shop B | Example kettle | Example","sha256":"","legalConclusion":false,"interpretation":"stated"},{"kind":"gap","subject":"L-1","sourceUrl":"","retrievedAt":"","text":"The listing has no source URL.","sha256":"","legalConclusion":false,"interpretation":"none"},{"kind":"gap","subject":"L-1","sourceUrl":"","retrievedAt":"","text":"The listing has no timestamp.","sha256":"","legalConclusion":false,"interpretation":"none"},{"kind":"gap","subject":"image","sourceUrl":"","retrievedAt":"","text":"No image was decoded.","sha256":"","legalConclusion":false,"interpretation":"none"},{"kind":"registration","subject":"TM-1","sourceUrl":"","retrievedAt":"","text":"Example Office | Example | listed by caller","sha256":"","legalConclusion":false,"interpretation":"stated"}],"requestsSent":0,"accountAccessed":false,"authenticationBypassed":false,"captchaBypassed":false,"infringementDetermined":false,"counterfeitConfirmed":false,"listingRemoved":false,"legalConclusion":false,"findings":[],"limitations":["Listings, brand names, and images are taken from the request or from one public page the caller named.","A public page is fetched with one HTTP GET. Login pages and CAPTCHAs are not bypassed.","Image similarity is the mean color difference after both images are drawn at 16 by 16. A difference of 12 or less is similar. It is not proof of counterfeiting.","A brand name in a listing is not a finding of trademark infringement.","No seller account is accessed and no listing is removed."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]}}},"/api/v1/brand-protection/investigation-report":{"post":{"operationId":"report_a_brand_investigation","summary":"Report a brand investigation","description":"Combine the brand match, listing signals, image comparison, seller list, and evidence gaps from the supplied records. The report does not determine infringement or counterfeiting.","tags":["brand-protection"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"brands":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"owner":{"type":"string","maxLength":160}},"required":["name"],"additionalProperties":false}},"products":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"brand":{"type":"string","maxLength":120},"title":{"type":"string","maxLength":300},"sku":{"type":"string","maxLength":80},"price":{"type":"number","minimum":0,"maximum":1000000000},"currency":{"type":"string","maxLength":12},"imageUrl":{"type":"string","maxLength":2000},"description":{"type":"string","maxLength":2000}},"additionalProperties":false}},"listings":{"maxItems":40,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"productId":{"type":"string","maxLength":80},"url":{"type":"string","maxLength":2000},"marketplace":{"type":"string","maxLength":80},"seller":{"type":"string","maxLength":160},"title":{"type":"string","maxLength":300},"price":{"type":"number","minimum":0,"maximum":1000000000},"currency":{"type":"string","maxLength":12},"brand":{"type":"string","maxLength":120},"sku":{"type":"string","maxLength":80},"imageUrl":{"type":"string","maxLength":2000},"observed":{"type":"string","maxLength":40},"description":{"type":"string","maxLength":2000}},"additionalProperties":false}},"images":{"maxItems":8,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"role":{"type":"string","enum":["reference","listing"]},"listingId":{"type":"string","maxLength":80},"productId":{"type":"string","maxLength":80},"url":{"type":"string","maxLength":2000},"mediaType":{"type":"string","enum":["image/png","image/jpeg","image/webp","image/gif"]},"fileBase64":{"type":"string","maxLength":2200000}},"additionalProperties":false}},"authorizedSellers":{"maxItems":40,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":160}},"required":["name"],"additionalProperties":false}},"registrations":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"office":{"type":"string","maxLength":120},"mark":{"type":"string","maxLength":160},"status":{"type":"string","maxLength":80}},"additionalProperties":false}},"rules":{"maxItems":8,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":40},"value":{"type":"string","maxLength":40}},"required":["name","value"],"additionalProperties":false}}},"additionalProperties":false},"example":{"brands":[{"name":"Example","owner":"Example Goods"}],"products":[{"id":"P-1","brand":"Example","title":"Example kettle","sku":"SKU-1","price":80,"currency":"USD"}],"listings":[{"id":"L-1","marketplace":"Example Market","seller":"Shop B","title":"Example kettle","price":20,"currency":"USD","brand":"Example","sku":"SKU-1"},{"id":"L-2","marketplace":"Example Market","seller":"Shop A","title":"Other kettle","price":80,"currency":"USD","brand":"Other","sku":"SKU-2"}],"authorizedSellers":[{"name":"Shop A"}],"rules":[{"name":"price","value":"0.5"}],"images":[{"id":"R-1","role":"reference","productId":"P-1","mediaType":"image/png","fileBase64":"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAIAAACQd1PeAAAADElEQVR4nGO4IycHAALyARlzRAvLAAAAAElFTkSuQmCC"},{"id":"I-1","role":"listing","listingId":"L-1","productId":"P-1","mediaType":"image/png","fileBase64":"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAIAAACQd1PeAAAADElEQVR4nGO4IycHAALyARlzRAvLAAAAAElFTkSuQmCC"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"listingCount":{"type":"number"},"matchedCount":{"type":"number"},"indicatorCount":{"type":"number"},"similarCount":{"type":"number"},"notOnListCount":{"type":"number"},"gapCount":{"type":"number"},"matches":{"type":"array","items":{"type":"object","properties":{"listingId":{"type":"string"},"brand":{"type":"string"},"fields":{"type":"string"},"matched":{"type":"boolean"},"quote":{"type":"string"},"sourceUrl":{"type":"string"},"retrievedAt":{"type":"string"},"infringementDetermined":{"type":"boolean"},"interpretation":{"type":"string"}},"additionalProperties":true}},"listings":{"type":"array","items":{"type":"object","properties":{"listingId":{"type":"string"},"productId":{"type":"string"},"level":{"type":"string"},"counterfeitConfirmed":{"type":"boolean"},"signals":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"kind":{"type":"string"},"confirmed":{"type":"boolean"},"detail":{"type":"string"}},"additionalProperties":true}}},"additionalProperties":true}},"pairs":{"type":"array","items":{"type":"object","properties":{"referenceId":{"type":"string"},"listingImageId":{"type":"string"},"listingId":{"type":"string"},"productId":{"type":"string"},"referenceUrl":{"type":"string"},"listingUrl":{"type":"string"},"referenceRetrievedAt":{"type":"string"},"retrievedAt":{"type":"string"},"visualSimilarity":{"type":"string"},"distance":{"type":"number"},"distanceSupplied":{"type":"boolean"},"counterfeitConfirmed":{"type":"boolean"},"detail":{"type":"string"}},"additionalProperties":true}},"sellers":{"type":"array","items":{"type":"object","properties":{"listingId":{"type":"string"},"seller":{"type":"string"},"marketplace":{"type":"string"},"sourceUrl":{"type":"string"},"finalUrl":{"type":"string"},"observed":{"type":"string"},"retrievedAt":{"type":"string"},"httpStatus":{"type":"number"},"listState":{"type":"string"},"unauthorizedConfirmed":{"type":"boolean"},"interpretation":{"type":"string"}},"additionalProperties":true}},"uses":{"type":"array","items":{"type":"object","properties":{"listingId":{"type":"string"},"brand":{"type":"string"},"field":{"type":"string"},"quote":{"type":"string"},"sourceUrl":{"type":"string"},"retrievedAt":{"type":"string"},"trademarkInfringement":{"type":"boolean"},"interpretation":{"type":"string"}},"additionalProperties":true}},"fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"left":{"type":"string"},"right":{"type":"string"},"state":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"items":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"subject":{"type":"string"},"sourceUrl":{"type":"string"},"retrievedAt":{"type":"string"},"text":{"type":"string"},"sha256":{"type":"string"},"legalConclusion":{"type":"boolean"},"interpretation":{"type":"string"}},"additionalProperties":true}},"requestsSent":{"type":"number"},"accountAccessed":{"type":"boolean"},"authenticationBypassed":{"type":"boolean"},"captchaBypassed":{"type":"boolean"},"infringementDetermined":{"type":"boolean"},"counterfeitConfirmed":{"type":"boolean"},"listingRemoved":{"type":"boolean"},"legalConclusion":{"type":"boolean"},"findings":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"code":{"type":"string"},"subject":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T11:00:00.000Z","status":"reported","listingCount":2,"matchedCount":1,"indicatorCount":1,"similarCount":1,"notOnListCount":1,"gapCount":4,"matches":[{"listingId":"L-1","brand":"Example","fields":"brand,title","matched":true,"quote":"Example","sourceUrl":"","retrievedAt":"","infringementDetermined":false,"interpretation":"stated"},{"listingId":"L-2","brand":"Example","fields":"","matched":false,"quote":"","sourceUrl":"","retrievedAt":"","infringementDetermined":false,"interpretation":"none"}],"listings":[{"listingId":"L-1","productId":"P-1","level":"indicator","counterfeitConfirmed":false,"signals":[{"code":"price_below","kind":"indicator","confirmed":false,"detail":"The listing price is below the supplied fraction of the reference price. This is not a finding of counterfeiting."},{"code":"image_identical","kind":"observation","confirmed":false,"detail":"The image files match. Matching files are not proof of counterfeiting."}]},{"listingId":"L-2","productId":"","level":"none","counterfeitConfirmed":false,"signals":[{"code":"reference_missing","kind":"unavailable","confirmed":false,"detail":"No single supplied reference product is linked to this listing, so it was not compared."}]}],"pairs":[{"referenceId":"R-1","listingImageId":"I-1","listingId":"L-1","productId":"P-1","referenceUrl":"","listingUrl":"","referenceRetrievedAt":"","retrievedAt":"","visualSimilarity":"identical","distance":0,"distanceSupplied":false,"counterfeitConfirmed":false,"detail":"The image files match. Matching files are not proof of counterfeiting."}],"sellers":[{"listingId":"L-1","seller":"Shop B","marketplace":"Example Market","sourceUrl":"","finalUrl":"","observed":"","retrievedAt":"","httpStatus":0,"listState":"not_on_list","unauthorizedConfirmed":false,"interpretation":"stated"},{"listingId":"L-2","seller":"Shop A","marketplace":"Example Market","sourceUrl":"","finalUrl":"","observed":"","retrievedAt":"","httpStatus":0,"listState":"on_list","unauthorizedConfirmed":false,"interpretation":"stated"}],"uses":[{"listingId":"L-1","brand":"Example","field":"brand","quote":"Example","sourceUrl":"","retrievedAt":"","trademarkInfringement":false,"interpretation":"stated"},{"listingId":"L-1","brand":"Example","field":"title","quote":"Example kettle","sourceUrl":"","retrievedAt":"","trademarkInfringement":false,"interpretation":"stated"}],"fields":[{"name":"title","left":"Example kettle","right":"Other kettle","state":"differs","detail":"The supplied values differ."},{"name":"brand","left":"Example","right":"Other","state":"differs","detail":"The supplied values differ."},{"name":"seller","left":"Shop B","right":"Shop A","state":"differs","detail":"The supplied values differ."},{"name":"sku","left":"SKU-1","right":"SKU-2","state":"differs","detail":"The supplied values differ."},{"name":"price","left":"20","right":"80","state":"differs","detail":"The supplied values differ."},{"name":"currency","left":"USD","right":"USD","state":"same","detail":"The supplied values match."},{"name":"url","left":"","right":"","state":"missing","detail":"One or both records omit this field."},{"name":"image","left":"","right":"","state":"not_compared","detail":"The images were not both decoded, so they were not compared."}],"items":[{"kind":"listing","subject":"L-1","sourceUrl":"","retrievedAt":"","text":"Example Market | Shop B | Example kettle | Example","sha256":"","legalConclusion":false,"interpretation":"stated"},{"kind":"gap","subject":"L-1","sourceUrl":"","retrievedAt":"","text":"The listing has no source URL.","sha256":"","legalConclusion":false,"interpretation":"none"},{"kind":"gap","subject":"L-1","sourceUrl":"","retrievedAt":"","text":"The listing has no timestamp.","sha256":"","legalConclusion":false,"interpretation":"none"},{"kind":"listing","subject":"L-2","sourceUrl":"","retrievedAt":"","text":"Example Market | Shop A | Other kettle | Other","sha256":"","legalConclusion":false,"interpretation":"stated"},{"kind":"gap","subject":"L-2","sourceUrl":"","retrievedAt":"","text":"The listing has no source URL.","sha256":"","legalConclusion":false,"interpretation":"none"},{"kind":"gap","subject":"L-2","sourceUrl":"","retrievedAt":"","text":"The listing has no timestamp.","sha256":"","legalConclusion":false,"interpretation":"none"},{"kind":"image","subject":"R-1","sourceUrl":"","retrievedAt":"","text":"1x1","sha256":"0d241b0667c6ffc3e6c2c21c9c329f10d6b8a5f3405f94164240d0e651f48895","legalConclusion":false,"interpretation":"stated"},{"kind":"image","subject":"I-1","sourceUrl":"","retrievedAt":"","text":"1x1","sha256":"0d241b0667c6ffc3e6c2c21c9c329f10d6b8a5f3405f94164240d0e651f48895","legalConclusion":false,"interpretation":"stated"}],"requestsSent":0,"accountAccessed":false,"authenticationBypassed":false,"captchaBypassed":false,"infringementDetermined":false,"counterfeitConfirmed":false,"listingRemoved":false,"legalConclusion":false,"findings":[{"kind":"observation","code":"not_a_determination","subject":"","detail":"A supplied brand name appears in a listing. This is not a trademark determination."},{"kind":"observation","code":"not_on_list","subject":"","detail":"A seller name is not on the supplied list. This is not a finding that the sale is unauthorized."}],"limitations":["Listings, brand names, and images are taken from the request or from one public page the caller named.","A public page is fetched with one HTTP GET. Login pages and CAPTCHAs are not bypassed.","Image similarity is the mean color difference after both images are drawn at 16 by 16. A difference of 12 or less is similar. It is not proof of counterfeiting.","A brand name in a listing is not a finding of trademark infringement.","No seller account is accessed and no listing is removed."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.12"},"protocols":[{"x402":{}}]}}}},"components":{"schemas":{"ApiError":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}}