{ "openapi": "3.1.0", "x-zeroclick-navigation": { "fullSpec": "https://zeroclick.affiliate.com/zcj/qmhpewfmao8m/openapi.json", "services": "https://zeroclick.affiliate.com/zcj/qmhpewfmao8m/services", "serviceSpecTemplate": "https://zeroclick.affiliate.com/zcj/qmhpewfmao8m/services/{slug}/openapi.json", "searchTemplate": "https://zeroclick.affiliate.com/zcj/qmhpewfmao8m/openapi.json?q={text}", "operationTemplate": "https://zeroclick.affiliate.com/zcj/qmhpewfmao8m/openapi.json?path={path}&method={method}", "firstPage": "https://zeroclick.affiliate.com/zcj/qmhpewfmao8m/openapi.json?page=1", "instructions": [ "Use this spec if it contains the operation and details you need. Otherwise, search or open a relevant service spec using the links below.", "Find service slugs in x-zeroclick-services or x-payment-info.rates[].service; use them in serviceSpecTemplate, never as request values.", "URL-encode template values. Search is ranked; service, path, and method filters are exact. Filters combine.", "Pages contain up to 10 operations; follow info.x-next or the Link header if you need more results. Shared operations retain all selector values." ] }, "info": { "title": "Affiliate.com", "version": "1.0.0", "description": "Product catalog search across all Affiliate.com merchants. Search and retrieve products with structured queries, and look up the merchants behind the catalog. This server is a pay-per-use, transparent proxy in front of Affiliate.com's own API: it handles identity, payment, and proxying. Agents can purchase autonomously or with their human's approval. The complete verified paid surface is listed at /openapi.json, the source of truth for available operations. Each operation here carries its live price in x-payment-info. Use the operations and details here when they meet your needs. Filtered specs contain only matching operations; if you cannot find what you need here, use search or the service catalog. The live catalog at /manifest.json is authoritative for prices and any free included units (prices[].includedUnits) - some meters include free usage per account before any charge, reserved for agents claimed by a human with a verified email.", "x-guidance": "Start with the free seller advisor: POST https://zeroclick.affiliate.com/zcj/qmhpewfmao8m/zeroclick/agent/quote with your goal and known budget or requirements. This operation costs $0 and requires only an x402 or MPP wallet proof; it returns a guide and never executes a purchase. Without a wallet, GET https://zeroclick.affiliate.com/zcj/qmhpewfmao8m/zeroclick/agent/guide?goal=URL_ENCODED_TASK or POST to that guide. Other operations below are the direct API reference; their own prices and access requirements still apply. Call the operations listed in this document at https://zeroclick.affiliate.com. Each service's full price matrix, plans, and how to buy are at https://zeroclick.affiliate.com/zcj/qmhpewfmao8m/services/{slug}; each operation's x-payment-info names the service it bills by slug (rates[].service). Slugs identify services in prices and usage reports and are never request values: when one operation serves several services, its request body schema lists the accepted values of the field that selects the service, so send one of those exactly as written. An unpaid call returns 402 Payment Required with a signed challenge; settle it with a supported payment method - x402 (Base USDC) or MPP (Tempo USDC) today - and retry with the proof attached. No upstream API key is needed, and an agent without a payment method can set one up instantly at no cost. Read GET https://zeroclick.affiliate.com/zcj/qmhpewfmao8m/manifest.json for the live services, meters, plans, prices, and any free included units, and https://zeroclick.affiliate.com/zcj/qmhpewfmao8m/llms-full.txt for the full agent guide, including how the free allowance works without funding (it requires an agent identity claimed by a human with a verified email)." }, "x-service-info": { "docs": { "homepage": "https://www.affiliate.com", "apiReference": "https://zeroclick.affiliate.com/zcj/qmhpewfmao8m/openapi.json", "llms": "https://zeroclick.affiliate.com/zcj/qmhpewfmao8m/llms.txt" } }, "externalDocs": { "url": "https://zeroclick.affiliate.com/zcj/qmhpewfmao8m/llms-full.txt", "description": "How to authenticate, pay, and call this API; links the upstream API reference." }, "servers": [ { "url": "https://zeroclick.affiliate.com/zcj/qmhpewfmao8m", "description": "Pay-per-use access to Affiliate.com's API" } ], "security": [ { "payPerUse": [] } ], "components": { "securitySchemes": { "payPerUse": { "type": "apiKey", "in": "header", "name": "x-payment", "description": "Pay-per-use access. An unpaid call returns 402 Payment Required with a signed challenge; settle it with a supported payment method (x402 or MPP today) and retry with the proof in this header (x402) or as Authorization: Payment (MPP; use ZC-Agent-Authorization for a separate buyer bearer). No upstream API key is needed, and an agent without a payment method can set one up instantly at no cost." }, "sellerAgentX402": { "type": "apiKey", "in": "header", "name": "Payment-Signature", "description": "Signed $0 x402 proof from the 402 challenge" }, "sellerAgentMpp": { "type": "http", "scheme": "Payment", "description": "Signed $0 MPP proof from the 402 challenge" } } }, "paths": { "/v1/merchants": { "get": { "summary": "List merchants", "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric merchant id." }, "name": { "type": "string", "description": "Merchant display name." }, "slug": { "type": "string", "description": "Short identifier suitable for URLs." }, "domains": { "type": "array", "items": { "type": "string" }, "description": "Canonical merchant domains." }, "network": { "type": "object", "properties": { "id": { "type": "integer" }, "url": { "type": "string" }, "name": { "type": "string" }, "country": { "type": "object", "properties": { "id": { "type": "string", "description": "ISO country code." } } }, "logo_url": { "type": [ "string", "null" ] } }, "description": "Affiliate network the merchant belongs to." }, "home_url": { "type": [ "string", "null" ] }, "icon_url": { "type": [ "string", "null" ] }, "logo_url": { "type": [ "string", "null" ] }, "canonical": { "type": [ "object", "null" ], "description": "Deduplicated canonical merchant record when available." }, "countries": { "type": "array", "items": { "type": "string" }, "description": "ISO country codes." }, "object_id": { "type": "string", "description": "ULID identifier with the nmer_ prefix." }, "origin_id": { "type": [ "string", "null" ], "description": "Identifier in the originating network." }, "categories": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string", "description": "Leaf category name." }, "google_id": { "type": [ "string", "null" ] }, "breadcrumb": { "type": "string", "description": "Full category path." }, "shopify_id": { "type": [ "string", "null" ] } } } }, "currencies": { "type": "array", "items": { "type": "string" }, "description": "ISO currency codes." }, "description": { "type": [ "string", "null" ] }, "product_count": { "type": "integer", "description": "Number of products available from this merchant." }, "cookie_duration": { "type": [ "string", "null" ], "description": "Attribution window as an ISO 8601 duration." }, "supports_deeplinking": { "type": [ "boolean", "null" ] } } } }, "meta": { "type": "object", "properties": { "to": { "type": "integer" }, "from": { "type": "integer" }, "total": { "type": "integer", "description": "Total number of matching merchants." }, "fields": { "type": "array", "items": { "type": "string" } }, "per_page": { "type": "integer" }, "trace_id": { "type": "string", "description": "Request trace id for support." }, "last_page": { "type": "integer" }, "current_page": { "type": "integer" } } } } } } }, "description": "Successful response" }, "402": { "description": "Payment required" } }, "parameters": [ { "in": "query", "name": "search", "schema": { "type": "string", "maxLength": 255, "minLength": 1 }, "example": "walmart", "required": false, "description": "Search by merchant name, domain, or id." }, { "in": "query", "name": "id", "schema": { "type": "string" }, "example": "930288", "required": false, "description": "Filter by a numeric merchant id or an nmer_ ULID." }, { "in": "query", "name": "fields", "schema": { "type": "string" }, "example": "id,name,domains,product_count", "required": false, "description": "Comma separated list of merchant fields to include." }, { "in": "query", "name": "page", "schema": { "type": "integer", "default": 1, "minimum": 1 }, "required": false, "description": "Page number to return." }, { "in": "query", "name": "per_page", "schema": { "type": "integer", "default": 100, "minimum": 1 }, "example": 25, "required": false, "description": "Number of results per page." }, { "in": "query", "name": "country_ids", "schema": { "type": "string", "items": { "type": "string" } }, "example": "US", "required": false, "description": "Comma separated ISO country codes." }, { "in": "query", "name": "product_count_min", "schema": { "type": "integer" }, "required": false, "description": "Only include merchants with at least this many products." }, { "in": "query", "name": "product_count_max", "schema": { "type": "integer" }, "required": false, "description": "Only include merchants with at most this many products." } ], "description": "Retrieve a list of all merchants.", "operationId": "listMerchants", "x-zeroclick-document-sources": [ { "gaps": [], "pages": [ 1 ], "sourceId": "sds_5d171b3495d5e97dfced40befd1be5af", "authority": "supplemental", "conflicts": [ "/responses/200/description" ], "revisionId": "sdrn_KeiHjJlsXhNV6xdLnYswq" }, { "gaps": [], "pages": [ 1 ], "sourceId": "sds_a86c40804511a67fb8fcec90dfbc8cfb", "authority": "supplemental", "conflicts": [ "/parameters/query/country_ids/schema/type", "/description" ], "revisionId": "sdrn_pVPqOIjr2FLz6S7xJx7qt" } ], "x-zeroclick-services": [ "merchants" ], "x-payment-info": { "access": "payg", "protocols": [ { "mpp": { "method": "tempo", "intent": "charge", "currency": "USD" } }, { "x402": { "network": "eip155:8453", "scheme": "exact", "currency": "USDC" } } ], "offers": [ { "amount": "20000", "currency": "0x20C000000000000000000000b9537d11c60E8b50", "description": "$0.020000 per request (requests, service merchants)", "intent": "charge", "method": "tempo" } ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.020000" }, "rates": [ { "service": "merchants", "meter": "requests", "unit": "request", "unitSize": 1, "priceUsd": "0.020000", "includedUnits": 0 } ], "perCallUsage": [ { "service": "merchants", "meter": "requests", "quantity": 1 } ] } } }, "/v1/merchants/{id}": { "get": { "summary": "Get merchant details", "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric merchant id." }, "name": { "type": "string", "description": "Merchant display name." }, "slug": { "type": "string", "description": "Short identifier suitable for URLs." }, "domains": { "type": "array", "items": { "type": "string" }, "description": "Canonical merchant domains." }, "network": { "type": "object", "properties": { "id": { "type": "integer" }, "url": { "type": "string" }, "name": { "type": "string" }, "country": { "type": "object", "properties": { "id": { "type": "string", "description": "ISO country code." } } }, "logo_url": { "type": [ "string", "null" ] } }, "description": "Affiliate network the merchant belongs to." }, "home_url": { "type": [ "string", "null" ] }, "icon_url": { "type": [ "string", "null" ] }, "logo_url": { "type": [ "string", "null" ] }, "canonical": { "type": [ "object", "null" ], "description": "Deduplicated canonical merchant record when available." }, "countries": { "type": "array", "items": { "type": "string" }, "description": "ISO country codes." }, "object_id": { "type": "string", "description": "ULID identifier with the nmer_ prefix." }, "origin_id": { "type": [ "string", "null" ], "description": "Identifier in the originating network." }, "categories": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string", "description": "Leaf category name." }, "google_id": { "type": [ "string", "null" ] }, "breadcrumb": { "type": "string", "description": "Full category path." }, "shopify_id": { "type": [ "string", "null" ] } } } }, "currencies": { "type": "array", "items": { "type": "string" }, "description": "ISO currency codes." }, "description": { "type": [ "string", "null" ] }, "product_count": { "type": "integer", "description": "Number of products available from this merchant." }, "cookie_duration": { "type": [ "string", "null" ], "description": "Attribution window as an ISO 8601 duration." }, "supports_deeplinking": { "type": [ "boolean", "null" ] } }, "description": "The matching merchant." }, "meta": { "type": "object", "properties": { "trace_id": { "type": "string", "description": "Request trace id for support." } } } } } } }, "description": "Successful response" }, "402": { "description": "Payment required" } }, "parameters": [ { "in": "path", "name": "id", "schema": { "type": "string" }, "example": "71655", "required": true, "description": "Merchant identifier. Accepts a numeric id, an nmer_ ULID, a mer_ canonical id, or a slug." }, { "in": "query", "name": "extended", "schema": { "type": "boolean" }, "required": false, "description": "Include expanded data such as relationship status, canonical record, categories, countries, and network details." } ], "description": "Retrieve details for a specific merchant by ID.", "operationId": "getMerchant", "x-zeroclick-document-sources": [ { "gaps": [], "pages": [ 1 ], "sourceId": "sds_5d171b3495d5e97dfced40befd1be5af", "authority": "supplemental", "conflicts": [ "/responses/200/description" ], "revisionId": "sdrn_KeiHjJlsXhNV6xdLnYswq" }, { "gaps": [], "pages": [ 1 ], "sourceId": "sds_a86c40804511a67fb8fcec90dfbc8cfb", "authority": "supplemental", "conflicts": [ "/summary", "/description" ], "revisionId": "sdrn_pVPqOIjr2FLz6S7xJx7qt" } ], "x-zeroclick-services": [ "merchants" ], "x-payment-info": { "access": "payg", "protocols": [ { "mpp": { "method": "tempo", "intent": "charge", "currency": "USD" } }, { "x402": { "network": "eip155:8453", "scheme": "exact", "currency": "USDC" } } ], "offers": [ { "amount": "20000", "currency": "0x20C000000000000000000000b9537d11c60E8b50", "description": "$0.020000 per request (requests, service merchants)", "intent": "charge", "method": "tempo" } ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.020000" }, "rates": [ { "service": "merchants", "meter": "requests", "unit": "request", "unitSize": 1, "priceUsd": "0.020000", "includedUnits": 0 } ], "perCallUsage": [ { "service": "merchants", "meter": "requests", "quantity": 1 } ] } } }, "/v1/products": { "post": { "summary": "Create product", "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "Unique product identifier." }, "sku": { "type": "string" }, "name": { "type": "string" }, "brand": { "type": "string" }, "barcode": { "type": "string", "description": "UPC, EAN, ISBN, or GTIN." }, "network": { "type": "object", "properties": { "id": { "type": "integer" }, "name": { "type": "string" } }, "description": "Affiliate network attribution." }, "on_sale": { "type": "boolean" }, "added_at": { "type": "string", "description": "UTC timestamp when the product was added." }, "category": { "type": "string" }, "currency": { "type": "string", "description": "ISO 4217 currency code." }, "merchant": { "type": "object", "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "canonical_id": { "type": "string" }, "canonical_name": { "type": "string" } } }, "image_url": { "type": "string", "description": "Primary image URL." }, "direct_url": { "type": "string", "description": "Direct product link." }, "updated_at": { "type": "string", "description": "UTC timestamp of the last refresh." }, "description": { "type": "string" }, "final_price": { "type": "number", "description": "Current price after discounts." }, "availability": { "type": [ "string", "null" ], "description": "InStock, OutOfStock, or null when unknown." }, "regular_price": { "type": "number", "description": "Original retail price." }, "sale_discount": { "type": "number" }, "commission_url": { "type": "string", "description": "Affiliate link. Contains placeholder tokens for the affiliate id and sub id unless network credentials were provided in the request." }, "stock_quantity": { "type": [ "integer", "null" ] }, "commissionable_status": { "type": "string", "description": "One of commissionable, assumed_commissionable, or not_commissionable." } } } }, "meta": { "type": "object", "properties": { "to": { "type": "integer" }, "from": { "type": "integer" }, "after": { "type": [ "string", "null" ], "description": "Cursor for deep pagination." }, "total": { "type": "integer", "description": "Total number of matching products." }, "fields": { "type": "array", "items": { "type": "string" } }, "sort_by": { "type": "string" }, "per_page": { "type": "integer" }, "trace_id": { "type": "string", "description": "Request trace id for support." }, "last_page": { "type": "integer" }, "sort_order": { "type": "string" }, "current_page": { "type": "integer" } } }, "facets": { "type": "object", "description": "Aggregated statistics for the requested facets." } } } } }, "description": "Successful response" }, "201": { "description": "Product created." }, "400": { "description": "Bad Request" }, "401": { "description": "Unauthorized" }, "402": { "description": "Payment required" }, "403": { "description": "Forbidden" }, "422": { "description": "Unprocessable Entity" }, "429": { "description": "Too Many Requests" }, "500": { "description": "Internal Server Error" } }, "parameters": [ { "in": "header", "name": "X-End-User-Id", "schema": { "type": "string" }, "example": "user-8421", "required": false, "description": "Attribute this request to a specific end user." } ], "description": "Create a new product entry.", "operationId": "searchProducts", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "search" ], "properties": { "name": { "type": "string" }, "page": { "type": "integer", "minimum": 1, "description": "Page number to return." }, "after": { "type": "string", "description": "Cursor token for pagination beyond 10000 results, returned as meta.after in a previous response." }, "query": { "type": "object", "properties": { "rules": { "type": "array", "items": { "type": "object", "required": [ "conditions_operator", "conditions" ], "properties": { "conditions": { "type": "array", "items": { "type": "object", "required": [ "field", "operator", "value" ], "properties": { "field": { "type": "string", "description": "Product field to match." }, "value": { "description": "Value to match." }, "operator": { "type": "string", "description": "Comparison operator." } } } }, "conditions_operator": { "enum": [ "any", "all" ], "type": "string", "description": "How the conditions inside this rule combine." } } } }, "rules_operator": { "enum": [ "any", "all" ], "type": "string", "description": "How rules combine. any means OR and all means AND. Defaults to all." } }, "description": "Structured rule based query builder for compound conditions. Mutually exclusive with search." }, "config": { "type": "object" }, "facets": { "type": "array", "items": { "type": "string" }, "description": "Facet aggregations to include with the results, up to 20. Supports dot notation, for example merchant.product_count." }, "fields": { "type": "array", "items": { "type": "string" }, "description": "Product fields to include in the response. All fields are returned when omitted." }, "search": { "type": "array", "items": { "type": "object" }, "oneOf": [ { "type": "string", "description": "Free text search across product fields." }, { "type": "array", "items": { "type": "object", "required": [ "field", "operator", "value" ], "properties": { "field": { "type": "string", "example": "name", "description": "Product field to filter on. Common fields are any, name, brand, category, barcode, final_price, on_sale, availability, merchant.id, and merchant.name." }, "value": { "example": "wireless headphones", "description": "Value to match against the field." }, "operator": { "type": "string", "example": "LIKE", "description": "Comparison operator supported by the field. Text fields accept =, !=, LIKE, and NOT LIKE. Numeric fields accept =, !=, >, <, >=, and <=." } } }, "description": "Filter objects that are combined with AND." } ], "example": "wireless headphones", "description": "Search criteria. Pass a plain string for a broad match across product fields, or an array of filter objects for precise matching. Mutually exclusive with query." }, "pool_id": { "type": "string", "description": "ULID of a pool that combines networks and merchants." }, "sort_by": { "enum": [ "relevance", "id", "barcode", "name", "description", "commission_url", "direct_url", "image_url", "currency", "regular_price", "final_price", "on_sale", "sale_discount", "availability", "stock_quantity", "sku", "brand", "category", "network", "merchant", "updated_at", "started_at" ], "type": "string", "description": "Field to sort results by." }, "networks": { "type": "object", "description": "Per network configuration keyed by network id, each entry carrying affiliate_id and an optional sub_id. When provided, commission URLs are populated with your affiliate credentials.", "additionalProperties": { "type": "object", "properties": { "sub_id": { "type": "string", "description": "Optional sub id for campaign tracking." }, "affiliate_id": { "type": "string", "description": "Your affiliate id on this network." } } } }, "per_page": { "type": "integer", "default": 100, "minimum": 1, "description": "Number of results per page." }, "sort_order": { "enum": [ "asc", "desc" ], "type": "string", "description": "Sort direction." }, "exact_total": { "type": "boolean" }, "balanced_mix": { "type": "object", "description": "Round robin interleaving of results with optional weighting. Incompatible with duplicate_fields_to_exclude." }, "click_tracking": { "type": "boolean", "default": false, "description": "Replace the sub id with a click_id for consolidated reporting." }, "duplicate_fields_to_exclude": { "type": "string", "description": "Collapse results that share the same value for this field. Incompatible with balanced_mix." } } } } }, "required": true }, "x-zeroclick-document-sources": [ { "gaps": [ "Missing schema details for product creation" ], "pages": [ 1 ], "sourceId": "sds_5d171b3495d5e97dfced40befd1be5af", "authority": "supplemental", "conflicts": [ "/requestBody/content/application/json/schema/required" ], "revisionId": "sdrn_KeiHjJlsXhNV6xdLnYswq" }, { "gaps": [], "pages": [ 1 ], "sourceId": "sds_dca90331f66e6869f93c6b016f6b1fac", "authority": "supplemental", "conflicts": [ "/summary", "/responses/200/description", "/description" ], "revisionId": "sdrn_zglbVb6JLvnHuWN8nNEPj" }, { "gaps": [ "Request body schema details are not fully documented in the provided text", "Response schema details are not provided" ], "pages": [ 1 ], "sourceId": "sds_GEF1AuI-jdjsovUpQ_f_P", "authority": "supplemental", "conflicts": [ "/summary", "/responses/200/description", "/description", "/requestBody/content/application/json/schema/properties/query/type" ], "revisionId": "sdrn_Nvt3c9A2HcClpl3NbgZMw" } ], "x-zeroclick-services": [ "product-search" ], "x-payment-info": { "access": "payg", "protocols": [ { "mpp": { "method": "tempo", "intent": "charge", "currency": "USD" } }, { "x402": { "network": "eip155:8453", "scheme": "exact", "currency": "USDC" } } ], "offers": [ { "amount": "20000", "currency": "0x20C000000000000000000000b9537d11c60E8b50", "description": "$0.020000 per request (requests, service product-search)", "intent": "charge", "method": "tempo" } ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.020000" }, "rates": [ { "service": "product-search", "meter": "requests", "unit": "request", "unitSize": 1, "priceUsd": "0.020000", "includedUnits": 0 } ] } } }, "/v1/tools/convert/asin-to-barcode": { "post": { "summary": "Convert ASIN to barcode", "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "description": "Key value pairs mapping each submitted ASIN to an array of barcodes.", "additionalProperties": { "type": "array", "items": { "type": "string" }, "description": "Barcodes found for the ASIN, empty when none were found." } }, "meta": { "type": "object", "properties": { "to": { "type": "string", "description": "Always \"barcode\"." }, "from": { "type": "string", "description": "Always \"asin\"." }, "config": { "type": "object", "description": "The configuration used for the conversion." }, "to_total": { "type": "integer", "description": "Number of values that resolved to a result." }, "trace_id": { "type": "string", "description": "Request trace id for support." }, "from_total": { "type": "integer", "description": "Number of values submitted." } } } } } } }, "description": "Successful response" }, "402": { "description": "Payment required" } }, "description": "Convert an ASIN to its corresponding barcode.", "operationId": "convertAsinToBarcode", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "config" ], "properties": { "asin": { "type": "string" }, "data": { "type": "array", "items": { "type": "string" }, "example": [ "B0C792QRW6", "B00AQUO5RI" ], "maxItems": 10, "description": "The ASINs to convert, up to 10 per request." }, "config": { "type": "object", "example": { "asin": { "locale": "US" } }, "required": [ "asin" ], "properties": { "asin": { "type": "object", "required": [ "locale" ], "properties": { "locale": { "type": "string", "example": "US", "description": "Amazon marketplace locale, for example US." } } } }, "description": "Identifies the Amazon marketplace." } } } } }, "required": true }, "x-zeroclick-document-sources": [ { "gaps": [], "pages": [ 1 ], "sourceId": "sds_5d171b3495d5e97dfced40befd1be5af", "authority": "supplemental", "conflicts": [ "/responses/200/description", "/requestBody/content/application/json/schema/required" ], "revisionId": "sdrn_KeiHjJlsXhNV6xdLnYswq" }, { "gaps": [], "pages": [ 1 ], "sourceId": "sds_8cb31df2bca0dd784f77fb59ed6cab97", "authority": "supplemental", "conflicts": [ "/summary", "/responses/200/description", "/requestBody/content/application/json/schema/required" ], "revisionId": "sdrn_uzAWnCKiU5ASiElQaP10y" }, { "gaps": [], "pages": [ 1 ], "sourceId": "sds_a470b587fad7caa8af50eae403f1e557", "authority": "supplemental", "conflicts": [ "/summary", "/responses/200/description", "/description", "/requestBody/content/application/json/schema/properties/data/description", "/requestBody/content/application/json/schema/properties/config/properties/asin/properties/locale/description" ], "revisionId": "sdrn_--31z5UdJ5XkCeezghnom" } ], "x-zeroclick-services": [ "tool-convert" ], "x-payment-info": { "access": "payg", "protocols": [ { "mpp": { "method": "tempo", "intent": "charge", "currency": "USD" } }, { "x402": { "network": "eip155:8453", "scheme": "exact", "currency": "USDC" } } ], "offers": [ { "amount": "20000", "currency": "0x20C000000000000000000000b9537d11c60E8b50", "description": "$0.020000 per request (requests, service tool-convert)", "intent": "charge", "method": "tempo" } ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.020000" }, "rates": [ { "service": "tool-convert", "meter": "requests", "unit": "request", "unitSize": 1, "priceUsd": "0.020000", "includedUnits": 0 } ], "perCallUsage": [ { "service": "tool-convert", "meter": "requests", "quantity": 1 } ] } } }, "/v1/tools/convert/barcode-to-asin": { "post": { "summary": "Convert barcode to ASIN", "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "description": "Key value pairs mapping each submitted barcode to an array of ASIN results.", "additionalProperties": { "type": "array", "items": { "type": "object", "properties": { "asin": { "type": "string", "description": "The Amazon Standard Identification Number." }, "locale": { "type": "string", "description": "Marketplace locale, for example us." } } }, "description": "ASIN results found for the barcode." } }, "meta": { "type": "object", "properties": { "to": { "type": "string", "description": "Always \"asin\"." }, "from": { "type": "string", "description": "Always \"barcode\"." }, "to_total": { "type": "integer", "description": "Number of values that resolved to a result." }, "trace_id": { "type": "string", "description": "Request trace id for support." }, "from_total": { "type": "integer", "description": "Number of values submitted." } } } } } } }, "description": "Successful response" }, "402": { "description": "Payment required" } }, "description": "Convert a barcode to its corresponding ASIN.", "operationId": "convertBarcodeToAsin", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "array", "items": { "type": "string" }, "example": [ "8806095074122", "0887276760049" ], "description": "The barcodes to convert. Each element must be a valid numeric barcode string." }, "barcode": { "type": "string" } } } } }, "required": true }, "x-zeroclick-document-sources": [ { "gaps": [], "pages": [ 1 ], "sourceId": "sds_5d171b3495d5e97dfced40befd1be5af", "authority": "supplemental", "conflicts": [ "/responses/200/description", "/requestBody/content/application/json/schema/required" ], "revisionId": "sdrn_KeiHjJlsXhNV6xdLnYswq" }, { "gaps": [], "pages": [ 1 ], "sourceId": "sds_8cb31df2bca0dd784f77fb59ed6cab97", "authority": "supplemental", "conflicts": [ "/summary", "/responses/200/description" ], "revisionId": "sdrn_uzAWnCKiU5ASiElQaP10y" }, { "gaps": [], "pages": [ 1 ], "sourceId": "sds_bb111dddfbd5b2d3f7a518ed941eb617", "authority": "supplemental", "conflicts": [ "/summary", "/responses/200/description", "/description", "/requestBody/content/application/json/schema/properties/data/description" ], "revisionId": "sdrn_uW1Cn2k2soObs-QdbW3R4" } ], "x-zeroclick-services": [ "tool-convert" ], "x-payment-info": { "access": "payg", "protocols": [ { "mpp": { "method": "tempo", "intent": "charge", "currency": "USD" } }, { "x402": { "network": "eip155:8453", "scheme": "exact", "currency": "USDC" } } ], "offers": [ { "amount": "20000", "currency": "0x20C000000000000000000000b9537d11c60E8b50", "description": "$0.020000 per request (requests, service tool-convert)", "intent": "charge", "method": "tempo" } ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.020000" }, "rates": [ { "service": "tool-convert", "meter": "requests", "unit": "request", "unitSize": 1, "priceUsd": "0.020000", "includedUnits": 0 } ], "perCallUsage": [ { "service": "tool-convert", "meter": "requests", "quantity": 1 } ] } } }, "/v1/tools/convert/barcode-to-sku": { "post": { "summary": "Convert barcode to SKU", "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "description": "Key value pairs mapping each submitted barcode to its SKU, or null when no match exists.", "additionalProperties": { "type": [ "string", "null" ], "description": "The resolved SKU, or null when no match exists." } }, "meta": { "type": "object", "properties": { "to": { "type": "string", "description": "Always \"sku\"." }, "from": { "type": "string", "description": "Always \"barcode\"." }, "config": { "type": "object", "description": "The configuration used for the conversion." }, "to_total": { "type": "integer", "description": "Number of values that resolved to a result." }, "trace_id": { "type": "string", "description": "Request trace id for support." }, "from_total": { "type": "integer", "description": "Number of values submitted." } } } } } } }, "description": "Successful response" }, "402": { "description": "Payment required" } }, "description": "Convert a barcode to its corresponding SKU.", "operationId": "convertBarcodeToSku", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "config" ], "properties": { "data": { "type": "array", "items": { "type": "string" }, "example": [ "9349520733755", "648093563899" ], "description": "The barcodes to convert. Each element must be a valid numeric barcode string." }, "config": { "type": "object", "example": { "merchant": { "name": "walmart" } }, "required": [ "merchant" ], "properties": { "merchant": { "type": "object", "properties": { "url": { "type": "string", "example": "walmart.com", "description": "Merchant domain, used when name is omitted." }, "name": { "type": "string", "example": "walmart", "description": "Merchant name. Takes precedence over url." } } } }, "description": "Identifies the source merchant. Provide merchant.name or merchant.url." }, "barcode": { "type": "string" } } } } }, "required": true }, "x-zeroclick-document-sources": [ { "gaps": [], "pages": [ 1 ], "sourceId": "sds_5d171b3495d5e97dfced40befd1be5af", "authority": "supplemental", "conflicts": [ "/responses/200/description", "/requestBody/content/application/json/schema/required" ], "revisionId": "sdrn_KeiHjJlsXhNV6xdLnYswq" }, { "gaps": [], "pages": [ 1 ], "sourceId": "sds_8cb31df2bca0dd784f77fb59ed6cab97", "authority": "supplemental", "conflicts": [ "/summary", "/responses/200/description", "/requestBody/content/application/json/schema/required" ], "revisionId": "sdrn_uzAWnCKiU5ASiElQaP10y" }, { "gaps": [], "pages": [ 1 ], "sourceId": "sds_fa39937e1f903f361b7309012aaeece2", "authority": "supplemental", "conflicts": [ "/summary", "/responses/200/description", "/description" ], "revisionId": "sdrn_bxbHyJip3y11KRrqdXOlq" } ], "x-zeroclick-services": [ "tool-convert" ], "x-payment-info": { "access": "payg", "protocols": [ { "mpp": { "method": "tempo", "intent": "charge", "currency": "USD" } }, { "x402": { "network": "eip155:8453", "scheme": "exact", "currency": "USDC" } } ], "offers": [ { "amount": "20000", "currency": "0x20C000000000000000000000b9537d11c60E8b50", "description": "$0.020000 per request (requests, service tool-convert)", "intent": "charge", "method": "tempo" } ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.020000" }, "rates": [ { "service": "tool-convert", "meter": "requests", "unit": "request", "unitSize": 1, "priceUsd": "0.020000", "includedUnits": 0 } ], "perCallUsage": [ { "service": "tool-convert", "meter": "requests", "quantity": 1 } ] } } }, "/v1/tools/convert/sku-to-barcode": { "post": { "summary": "Convert merchant-specific SKUs to product barcodes", "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "description": "Key value pairs mapping each submitted SKU to its barcode, or null when no match exists.", "additionalProperties": { "type": [ "string", "null" ], "description": "The resolved barcode, or null when no match exists." } }, "meta": { "type": "object", "properties": { "to": { "type": "string", "description": "Always \"barcode\"." }, "from": { "type": "string", "description": "Always \"sku\"." }, "config": { "type": "object", "description": "The configuration used for the conversion." }, "to_total": { "type": "integer", "description": "Number of values that resolved to a result." }, "trace_id": { "type": "string", "description": "Request trace id for support." }, "from_total": { "type": "integer", "description": "Number of values submitted." } } } } } } }, "description": "Successful response" }, "402": { "description": "Payment required" } }, "description": "Resolve merchant-specific SKUs to their standard barcodes. Requires a merchant name or URL in the config object to identify the source catalog.", "operationId": "convertSkuToBarcode", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "config" ], "properties": { "sku": { "type": "string" }, "data": { "type": "array", "items": { "type": "string" }, "example": [ "12987717129", "9853123116", "9885868036" ], "description": "The merchant SKUs to convert." }, "config": { "type": "object", "example": { "merchant": { "name": "walmart" } }, "required": [ "merchant" ], "properties": { "merchant": { "type": "object", "properties": { "url": { "type": "string", "example": "walmart.com", "description": "Merchant domain, used when name is omitted." }, "name": { "type": "string", "example": "walmart", "description": "Merchant name. Takes precedence over url." } } } }, "description": "Identifies the source merchant. Provide merchant.name or merchant.url." } } } } }, "required": true }, "x-zeroclick-document-sources": [ { "gaps": [], "pages": [ 1 ], "sourceId": "sds_2e68cc868e02094bf88379de1577e089", "authority": "supplemental", "conflicts": [ "/responses/200/description" ], "revisionId": "sdrn_Y9Q4Rhn4Q_zMb3G8HUCS2" }, { "gaps": [], "pages": [ 1 ], "sourceId": "sds_5d171b3495d5e97dfced40befd1be5af", "authority": "supplemental", "conflicts": [ "/summary", "/responses/200/description", "/description", "/requestBody/content/application/json/schema/required" ], "revisionId": "sdrn_KeiHjJlsXhNV6xdLnYswq" }, { "gaps": [], "pages": [ 1 ], "sourceId": "sds_8cb31df2bca0dd784f77fb59ed6cab97", "authority": "supplemental", "conflicts": [ "/summary", "/responses/200/description", "/requestBody/content/application/json/schema/required" ], "revisionId": "sdrn_uzAWnCKiU5ASiElQaP10y" } ], "x-zeroclick-services": [ "tool-convert" ], "x-payment-info": { "access": "payg", "protocols": [ { "mpp": { "method": "tempo", "intent": "charge", "currency": "USD" } }, { "x402": { "network": "eip155:8453", "scheme": "exact", "currency": "USDC" } } ], "offers": [ { "amount": "20000", "currency": "0x20C000000000000000000000b9537d11c60E8b50", "description": "$0.020000 per request (requests, service tool-convert)", "intent": "charge", "method": "tempo" } ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.020000" }, "rates": [ { "service": "tool-convert", "meter": "requests", "unit": "request", "unitSize": 1, "priceUsd": "0.020000", "includedUnits": 0 } ], "perCallUsage": [ { "service": "tool-convert", "meter": "requests", "quantity": 1 } ] } } }, "/v1/tools/convert/url-to-barcode": { "post": { "summary": "Convert retailer product page URLs to barcodes", "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "description": "Key value pairs mapping each submitted URL to an array of barcodes.", "additionalProperties": { "type": "array", "items": { "type": "string" }, "description": "Barcodes found for the URL, empty when none were found." } }, "meta": { "type": "object", "properties": { "to": { "type": "string", "description": "Always \"barcode\"." }, "from": { "type": "string", "description": "Always \"url\"." }, "to_total": { "type": "integer", "description": "Number of values that resolved to a result." }, "trace_id": { "type": "string", "description": "Request trace id for support." }, "from_total": { "type": "integer", "description": "Number of values submitted." } } } } } } }, "description": "Successful response" }, "402": { "description": "Payment required" } }, "description": "Submit product page URLs from major retailers and receive the corresponding barcodes. Returns an array per URL; empty array means no match was found.", "operationId": "convertUrlToBarcode", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "url": { "type": "string" }, "data": { "type": "array", "items": { "type": "string" }, "example": [ "https://www.abt.com/JBL-Charge-5-Black-Portable-Waterproof-Speaker-With-Powerbank-JBLCHARGE5BLKAM/p/159497.html" ], "description": "The product page URLs to convert. Each element must be a full URL string." } } } } }, "required": true }, "x-zeroclick-document-sources": [ { "gaps": [], "pages": [ 1 ], "sourceId": "sds_352718a3d2081eb034dc388c2db2a219", "authority": "supplemental", "conflicts": [ "/responses/200/description", "/requestBody/content/application/json/schema/properties/data/description" ], "revisionId": "sdrn_piBJ67z47Y0H7O6sVX3NP" }, { "gaps": [], "pages": [ 1 ], "sourceId": "sds_5d171b3495d5e97dfced40befd1be5af", "authority": "supplemental", "conflicts": [ "/summary", "/responses/200/description", "/description", "/requestBody/content/application/json/schema/required" ], "revisionId": "sdrn_KeiHjJlsXhNV6xdLnYswq" }, { "gaps": [], "pages": [ 1 ], "sourceId": "sds_8cb31df2bca0dd784f77fb59ed6cab97", "authority": "supplemental", "conflicts": [ "/summary", "/responses/200/description" ], "revisionId": "sdrn_uzAWnCKiU5ASiElQaP10y" } ], "x-zeroclick-services": [ "tool-convert" ], "x-payment-info": { "access": "payg", "protocols": [ { "mpp": { "method": "tempo", "intent": "charge", "currency": "USD" } }, { "x402": { "network": "eip155:8453", "scheme": "exact", "currency": "USDC" } } ], "offers": [ { "amount": "20000", "currency": "0x20C000000000000000000000b9537d11c60E8b50", "description": "$0.020000 per request (requests, service tool-convert)", "intent": "charge", "method": "tempo" } ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.020000" }, "rates": [ { "service": "tool-convert", "meter": "requests", "unit": "request", "unitSize": 1, "priceUsd": "0.020000", "includedUnits": 0 } ], "perCallUsage": [ { "service": "tool-convert", "meter": "requests", "quantity": 1 } ] } } }, "/zeroclick/agent/quote": { "post": { "operationId": "sellerAgentQuote", "summary": "Get a free seller API quote and purchase guide", "description": "Describe your task to get the matching API contract, prices, prerequisites and next steps. This is a $0 wallet-proof lookup, not the seller's paid service. No purchase is executed. Without a wallet, use /zeroclick/agent/guide.", "servers": [ { "url": "https://zeroclick.affiliate.com/zcj/qmhpewfmao8m" } ], "security": [ { "sellerAgentX402": [] }, { "sellerAgentMpp": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "goal": { "type": "string", "minLength": 1, "maxLength": 2000, "description": "Describe the task and known inputs. Do not include credentials." }, "quantity": { "description": "Number of API calls, not returned items. Omit when unknown; describe desired output in goal.", "type": "integer", "minimum": 1, "maximum": 1000000 }, "budgetUsd": { "description": "Total cash budget in USD. A quote does not authorize spending.", "type": "string", "pattern": "^(0|[1-9]\\d{0,8})(\\.\\d{1,6})?$" }, "budgetExclusive": { "type": "boolean" }, "reviewAfterCalls": { "type": "integer", "minimum": 1, "maximum": 1000000 }, "requirements": { "type": "string", "minLength": 1, "maxLength": 300 }, "humanAvailable": { "description": "Whether a human is in the loop. False recommends anonymous auth for a new autonomous identity; omit when unknown. Executing a human's request without further interruptions does not by itself mean false.", "type": "boolean" }, "payment": { "description": "Known payment method for the eventual purchase, independent of this free lookup's wallet proof.", "type": "string", "enum": [ "x402", "mpp", "card" ] } }, "required": [ "goal" ], "additionalProperties": false }, "example": { "goal": "Find the available services, prices and purchase steps" } } } }, "responses": { "200": { "description": "Task guidance; inspect status before executing anything", "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "status": { "type": "string", "enum": [ "quoted", "ready", "needs_input", "blocked", "unknown", "unsupported", "unavailable" ] }, "priceUsd": { "type": "string", "const": "0" }, "guide": { "type": "string", "description": "Markdown guidance containing the task result, exact contract, pricing and next steps when available. No purchase is executed." }, "guideUrl": { "type": "string", "format": "uri", "description": "Wallet-free advisor endpoint for further planning or recovery." } }, "required": [ "status", "priceUsd", "guide", "guideUrl" ], "additionalProperties": false } } } }, "402": { "description": "$0 x402 or MPP wallet proof required; sign and retry the same request. No funds are transferred." }, "503": { "description": "Advisor unavailable; use the wallet-free guide or direct storefront references" } }, "x-payment-info": { "access": "payg", "price": { "mode": "fixed", "currency": "USD", "amount": "0" }, "protocols": [ { "x402": { "network": "eip155:8453", "scheme": "exact", "currency": "USDC" } }, { "mpp": { "method": "tempo", "intent": "charge", "currency": "USD" } } ], "offers": [ { "amount": "0", "currency": "0x20C000000000000000000000b9537d11c60E8b50", "method": "tempo", "intent": "charge", "description": "Free seller advisor lookup" } ] } } } }, "x-zeroclick-navigation-footer": { "instructions": [ "Use this spec if it contains the operation and details you need. Otherwise, search or open a relevant service spec using the links below.", "Find service slugs in x-zeroclick-services or x-payment-info.rates[].service; use them in serviceSpecTemplate, never as request values.", "URL-encode template values. Search is ranked; service, path, and method filters are exact. Filters combine.", "Pages contain up to 10 operations; follow info.x-next or the Link header if you need more results. Shared operations retain all selector values." ], "fullSpec": "https://zeroclick.affiliate.com/zcj/qmhpewfmao8m/openapi.json", "services": "https://zeroclick.affiliate.com/zcj/qmhpewfmao8m/services", "serviceSpecTemplate": "https://zeroclick.affiliate.com/zcj/qmhpewfmao8m/services/{slug}/openapi.json", "searchTemplate": "https://zeroclick.affiliate.com/zcj/qmhpewfmao8m/openapi.json?q={text}", "operationTemplate": "https://zeroclick.affiliate.com/zcj/qmhpewfmao8m/openapi.json?path={path}&method={method}", "firstPage": "https://zeroclick.affiliate.com/zcj/qmhpewfmao8m/openapi.json?page=1" } }