# Dentro Merchant Directory Search

> Dentro Merchant Directory Search is a paid API for AI agents from api.dentro.fyi, paid per call via x402, $0.005/call, status down (last checked 2026-09-15).

Search 22,000+ independent e-commerce stores by keyword, country, and category, returning merchant name, domain, country, category, and platform.

## Facts

- Endpoint: GET https://api.dentro.fyi/merchants
- Price: $0.005/call
- Payment: x402
- Status: down
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-dentro-fyi-bd1e12b3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_eUuVtnbfRiK9DbMDD5YlO

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 api-dentro-fyi-bd1e12b3
```

Example prompt: Find me up to 20 independent online stores selling consumer electronics in the USA — I want their names and domains, and prefer Shopify or WooCommerce stores if possible.

## When to prefer this

Use this endpoint when you need to discover independent e-commerce merchants by name, domain, country, or category before fetching their product catalogs. Ideal for building curated store lists, sourcing research, or feeding into product-level queries via /products/:merchant_id. Prefer over general web search when you need structured, consented merchant data across 22,000+ indie brands in 16 countries.

## Known failure modes

- No merchants match the query/country/category combination — returns empty merchant list
- Invalid country code returns no results or error
- Limit out of range (below 1 or above 100) may cause validation error
- Payment not included or insufficient — 402 Payment Required response
- Service unavailable or rate limit exceeded — 5xx error

## How this service works

Merchant directory + product search for independent e-commerce. Query by keyword, country, category, or platform. 22,000+ stores across 16 countries; Shopify, WooCommerce, Magento, custom storefronts. No API key. Pay per call.

## Output

Returns a list of merchants (up to 100 per call) each with name, domain, country, category, and e-commerce platform (e.g. shopify, woocommerce, magento, unknown), plus a count and tier indicator.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "q": "electronics",
   "limit": 10,
   "country": "usa",
   "category": "Consumer Electronics"
  }
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "queryParams": {
      "type": "object",
      "properties": {
       "q": {
        "type": "string",
        "description": "Free-text query against merchant name/domain"
       },
       "limit": {
        "type": "integer",
        "default": 20,
        "maximum": 100,
        "minimum": 1
       },
       "country": {
        "type": "string",
        "description": "ISO-style country code lowercased (e.g. usa, uk, de)"
       },
       "category": {
        "type": "string",
        "description": "Merchant category filter (e.g. 'Consumer Electronics')"
       }
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "tier",
  "count",
  "merchants",
  "data_fetched_at"
 ],
 "properties": {
  "tier": {
   "type": "string"
  },
  "count": {
   "type": "number"
  },
  "merchants": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "name",
     "domain",
     "country",
     "category",
     "platform"
    ],
    "properties": {
     "name": {
      "type": "string"
     },
     "domain": {
      "type": "string"
     },
     "country": {
      "type": "string"
     },
     "category": {
      "type": "string"
     },
     "platform": {
      "type": "string"
     }
    }
   }
  },
  "data_fetched_at": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-dentro-fyi-bd1e12b3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.dentro.fyi](https://www.zero.xyz/host/api.dentro.fyi/llms.txt)