# pickr.market API Search

> pickr.market API Search is a paid API for AI agents from pickr.market, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-12).

Returns a scored, ranked list of x402 API endpoints matching a natural language intent query, including price, latency, input schema, and description.

## Facts

- Endpoint: GET https://pickr.market/search?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/pickr-market-f572924b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_zblI6j1j0ithR759l77VT

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 pickr-market-f572924b
```

Example prompt: Search pickr.market for x402 API endpoints that match this intent: 'I need an API that returns real-time weather forecasts given a city name' — give me the top ranked results with their prices and latency.

## When to prefer this

Choose this endpoint when an AI agent needs to dynamically discover which x402-compatible APIs are available for a given task at runtime, rather than hardcoding a specific API. Ideal for meta-agents that route to the best available paid API based on cost, latency, and capability match. Prefer this over manually curating an API list when the landscape of available x402 endpoints is large or frequently changing.

## Known failure modes

- Missing required 'intent' query parameter returns a 400 error
- Payment not included or insufficient USDC causes a 402 Payment Required response
- No matching endpoints found returns an empty ranked list
- Vague or ambiguous intent query may return low-relevance results
- Network timeout if the service is temporarily unavailable

## How this service works

Send an intent. Pickr routes to the highest-rated x402 endpoint, relays the payment, and rates the answer — so the index keeps improving.

## Output

A scored, ranked list of x402-compatible API endpoints that best match the provided intent query. Each result includes the endpoint's price in USDC, expected latency, input schema, and a plain-language description, allowing the agent to select and invoke the most suitable API for its task.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "intent": "I need an API that returns real-time weather data for a given city"
  }
 }
}
```

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "intent"
     ],
     "properties": {
      "intent": {
       "type": "string",
       "description": "Natural language query describing the data or API you need"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "intent": "twitter user profile",
  "results": [
   {
    "url": "https://twit.sh/users/by/username",
    "score": 8.4,
    "method": "GET",
    "priceUsdc": 0.005,
    "description": "Look up a Twitter/X user profile by their screen name",
    "latencyAvgMs": 320
   }
  ]
 }
}
```

## More

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