# Get Merchant Details by ID

> Get Merchant Details by ID is a paid API for AI agents from zeroclick.affiliate.com, paid per call via MPP, $0.02/call, status unknown (last checked 2026-10-12).

Retrieve detailed profile information for a specific affiliate merchant by their ID, ULID, canonical ID, or slug.

## Facts

- Endpoint: GET https://zeroclick.affiliate.com/v1/merchants/{id}?utm_source=zero.xyz
- Price: $0.02/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Provider: zeroclick.affiliate.com
- Website: https://zeroclick.affiliate.com
- Canonical page: https://www.zero.xyz/c/zeroclick-affiliate-com-get-merchant-details-by-id-8bca9de8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YQwxZnopc4oMxCTl34-i9

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability zeroclick-affiliate-com-get-merchant-details-by-id-8bca9de8
```

Example prompt: Can you pull up the full details for the Affiliate.com merchant with the slug 'nordstrom' — including their categories, supported countries, and cookie duration?

## When to prefer this

Use this endpoint when you have a known merchant identifier (numeric ID, ULID, canonical ID, or slug) and need structured profile data about that specific merchant — including network affiliation, branding assets, supported countries, categories, and attribution details. Prefer this over a search endpoint when you already know the merchant identifier and want authoritative, complete merchant metadata rather than a ranked list of candidates.

## Known failure modes

- Merchant ID not found — returns 404 with error details
- Invalid ID format supplied — returns 400 validation error
- Unauthorized or payment failure — returns 402 if payment not satisfied
- Rate limiting or quota exceeded — returns 429
- Network or upstream Affiliate.com service unavailable — returns 502 or 503

## How this service works

Retrieve details for a specific merchant by ID.

## Output

Returns a merchant object with numeric ID, display name, slug, canonical domains, affiliate network info (name, URL, country, logo), home URL, icon and logo URLs, canonical record, supported countries, origin ID, product categories with breadcrumbs, supported currencies, product count, cookie duration as ISO 8601 duration, deeplinking support flag, and a trace ID for debugging.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "id"
 ],
 "properties": {
  "id": {
   "type": "string",
   "description": "Merchant identifier. Accepts a numeric id, an nmer_ ULID, a mer_ canonical id, or a slug."
  },
  "extended": {
   "type": "boolean",
   "description": "Include expanded data such as relationship status, canonical record, categories, countries, and network details."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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"
     },
     "desc
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/zeroclick-affiliate-com-get-merchant-details-by-id-8bca9de8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from zeroclick.affiliate.com](https://www.zero.xyz/host/zeroclick.affiliate.com/llms.txt)