---
name: api.crinkl.xyz
description: api.crinkl.xyz provides two meta-level routing and discovery skills for Crinkl's commerce signal API ecosystem. Neither skill returns actual commerce data; both help agents identify which Crinkl endpoint to call before committing to a paid signal request.
host: api.crinkl.xyz
---

# api.crinkl.xyz

Crinkl is a commerce signal provider whose x402-accessible API surface includes category pulse, merchant signal, and campaign fit endpoints. This host exposes only the discovery and routing layer: one skill enumerates all available endpoints with pricing and usage details, and another recommends the highest-priority next endpoint given a specific research goal, category, merchant, and geography. It is intended as a pre-purchase decision layer for agents navigating Crinkl's broader signal catalog.

## When to use this host

Use this host when an agent needs to navigate Crinkl's signal API before making a paid call — specifically to discover available endpoints or to get a ranked recommendation for which endpoint fits a given research goal. Do not use this host to retrieve actual commerce data such as category trends, merchant spend signals, or campaign fit estimates; those are returned by the downstream endpoints (e.g. /x402/category-pulse) that these skills point to. If an agent already knows which Crinkl endpoint it needs, skip this host entirely and call that endpoint directly. This host has no utility for non-Crinkl data sources or general market research outside the Crinkl ecosystem.

## Capabilities

### Endpoint Discovery and Routing

These two skills together allow an agent to enumerate all available Crinkl signal endpoints and then determine the optimal one to call for a given goal, category, merchant, and geography — before any paid signal is purchased.

- **`fetch-crinkl-verified-commerce-signals`** — Returns a directory of Crinkl's verified commerce signal endpoints with capabilities, pricing, example calls, and a plain-English product description for agent onboarding.
- **`fetch-next-best-signal`** — Returns the highest-priority recommended API route for a given trading/marketing goal, category, merchant, and geo, along with upgrade paths and stop rules.

## Workflows

### Discover Then Route

*Use when an agent is unfamiliar with Crinkl's signal catalog and needs to first understand what endpoints exist before selecting the best one for a specific research goal.*

1. **`fetch-crinkl-verified-commerce-signals`** — Retrieve the full directory of available Crinkl signal endpoints, including capabilities, pricing, and example calls, to establish what options exist.
2. **`fetch-next-best-signal`** — Using the goal, category, merchant, and geo derived from the agent's task, obtain a prioritized recommendation for which specific endpoint to call next, along with upgrade paths and stop rules.

## Skill reference

### `fetch-crinkl-verified-commerce-signals`

**Verified Commerce Signals** — Returns a directory of Crinkl's verified commerce signal endpoints with capabilities, pricing, example calls, and a plain-English product description for agent onboarding.

*Use when:* Use when an agent needs to discover which Crinkl commerce signal endpoints exist, what each costs, what questions each answers, and how to call them — typically as a first step before purchasing a category pulse, merchant signal, or campaign fit estimate.

*Not for:* Do not use to retrieve actual commerce signal data (category trends, merchant signals, campaign fit); use the specific endpoint listed in the returned directory instead.

**Inputs:**

- `goal` (string) — Intent or workflow stage to tailor the returned signal directory. Known value: 'first_campaign'.

**Returns:** Returns a crinkl_paid_report with a plain-English product description and an array of available signal endpoints (category-pulse, merchant-category-signal, campaign-fit-estimate, next-best-signal), each with pricing, capability summary, buyer questions, and example GET calls.

**Example:** `GET https://api.crinkl.xyz/x402/crinkl-verified-commerce-signals?goal=first_campaign`

---

### `fetch-next-best-signal`

**Next Best Signal** — Returns the highest-priority recommended API route for a given trading/marketing goal, category, merchant, and geo, along with upgrade paths and stop rules.

*Use when:* Use when an agent needs to determine which Crinkl x402 endpoint to call next for a given research goal, category, or geography before committing to a more specific or expensive signal call.

*Not for:* Do not use for retrieving actual spend data, category pulse metrics, or campaign measurement results; use the recommended route returned in nextSignals (e.g. /x402/category-pulse) for those purposes.

**Inputs:**

- `goal` (string) — Research or strategy goal to guide signal selection (e.g. 'general').
- `category` (string) — Product or merchant category to scope the signal recommendation; null for no category filter.
- `merchant` (string) — Specific merchant to scope the signal recommendation; null for no merchant filter.
- `geo` (string) — Two-letter ISO country/region code for geographic scope.

**Returns:** Returns a crinkl_paid_report with a ranked nextSignals array recommending the best Crinkl route to call next, plus upgrade paths, stop rules, methodology, proof hash, license, and privacy metadata.

**Example:** `GET https://api.crinkl.xyz/x402/next-best-signal?goal=general&geo=US`

---