Particle Pro

Live 402 challenge

Captured by the enrichment pass, not read just now. Prices can change — always read the 402 the endpoint answers with.

{
  "type": "https://docs.particle.pro/errors/payment_required",
  "title": "Payment Required",
  "detail": "This request costs $0.01 in USDC. Pay with x402 using PAYMENT-REQUIRED, or MPP using the WWW-Authenticate Payment challenge, or authenticate with a pp_ API key.",
  "status": 402,
  "resolve": {
    "url": "https://docs.particle.pro/x402",
    "action": "pay_per_request",
    "message": "Retry with one payment: x402 PAYMENT-SIGNATURE or MPP Authorization: Payment. You can also use an API key."
  },
  "error_code": "payment_required"
}

Accepts

The payment requirements as published to the catalog. Read the live 402 before paying — a price here is a claim, not a quote.

[
  {
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "extra": {
      "name": "USD Coin",
      "version": "2"
    },
    "payTo": "0x59f3a6dcb6f482c53872dd8f8f9e1f9161a1c5f7",
    "amount": "10000",
    "scheme": "exact",
    "network": "eip155:8453",
    "maxTimeoutSeconds": 300
  }
]

Extensions

{
  "bazaar": {
    "info": {
      "input": {
        "type": "http",
        "method": "GET",
        "queryParams": {
          "language": "fr",
          "format_signal": [
            "interview"
          ],
          "guest_frequency": [
            "regular",
            "always"
          ]
        }
      }
    },
    "schema": {
      "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",
              "properties": {
                "q": {
                  "type": "string",
                  "description": "Search the catalog by podcast name. GET /v1/podcasts/search is the canonical search endpoint and accepts the same parameters. The search is forgiving: it handles typos, missing or extra words ('offline jon favreau' finds Offline with Jon Favreau), a name plus qualifiers ('equity techcrunch'), and pasted episode titles ('Ferrari | Acquired' finds Acquired). The best matches come first, and each result's match_quality tells you how confident the match is — including when a show matched only through its description (match_quality=description) rather than its name."
                },
                "slug": {
                  "type": "string",
                  "description": "Filter by exact podcast slug (e.g., 'all-in'). Slugs are stable, human-readable identifiers returned on every podcast object."
                },
                "sort": {
                  "enum": [
                    "relevance",
                    "popularity"
                  ],
                  "type": "string",
                  "description": "Result ordering. relevance — the default whenever q is present — ranks by how well each podcast matches the query, breaking ties by popularity. popularity orders purely by the global popularity percentile (most popular first; podcasts not currently charting sort last), and also overrides topic_id's concentration ordering. Without q or topic_id, results are popularity-ordered either way."
                },
                "limit": {
                  "type": "integer",
                  "format": "int64",
                  "description": "Results per page"
                },
                "cursor": {
                  "type": "string",
                  "description": "Opaque pagination cursor from previous response"
                },
                "has_ads": {
                  "enum": [
                    "true",
                    "false"
                  ],
                  "type": "string",
                  "description": "Filter by advertiser presence. Pass false to find ad-free shows — an assertion that requires the show to have enough analyzed episodes, so sparsely-analyzed podcasts are excluded rather than presumed ad-free."
                },
                "language": {
                  "type": "string",
                  "description": "Filter by the podcast's language (ISO 639-1 code, e.g. 'en', 'fr'). Matches the primary language subtag, so 'fr' covers 'fr-FR'."
                },
                "topic_id": {
                  "type": "string",
                  "description": "Filter by topic ID, ancestry slug (e.g., technology/artificial-intelligence), or ancestry path hash. Matches podcasts where the topic accounts for at least 20% of the show's episodes, ranked by topic concentration — not merely podcasts that mention it once."
                },
                "has_video": {
                  "enum": [
                    "true",
                    "false"
                  ],
                  "type": "string",
                  "description": "Filter by whether episodes have discovered video versions (e.g. YouTube releases)."
                },
                "format_signal": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "Filter by detected production format. Pass a comma-separated list to match any of several formats — e.g. panel,call_in. Values mirror the format.signals field on podcast responses; a show can carry several signals."
                },
                "guest_frequency": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "Filter by how often episodes feature a guest. Pass a comma-separated list to match any of several buckets — e.g. regular,always for interview-driven shows, or never for shows that don't host guests. Only matches podcasts with enough analyzed episodes to judge; values mirror the format.guest_frequency field on podcast responses."
                },
                "suitability_tier": {
                  "enum": [
                    "SAFE",
                    "LIMITED",
                    "SENSITIVE",
                    "UNSAFE"
                  ],
                  "type": "string",
                  "description": "Filter by brand-suitability tier (IAB Tech Lab Brand Safety & Suitability Framework, formerly GARM). Only returns podcasts whose most recent suitability analysis assigned this tier. Podcasts without a suitability analysis are excluded when this filter is set."
                },
                "publishing_status": {
                  "enum": [
                    "active",
                    "dormant"
                  ],
                  "type": "string",
                  "description": "Filter by publishing activity: active shows have released an episode within the last 90 days; dormant shows have not."
                },
                "popularity_threshold": {
                  "type": "number",
                  "format": "double",
                  "description": "Restrict results to podcasts whose global popularity percentile is at least this value (accepted range [0,1]). Omitting the parameter or passing 0 disables the filter; only a value greater than 0 activates it. Popularity is always global — a cume_dist ranking over all currently-charting podcasts (Apple Podcasts) — never scoped to topic_id or any other filter. When the filter is active (threshold > 0), podcasts not currently charting have no percentile and are excluded, so a high threshold combined with a narrow topic_id may return zero results; lower or remove the threshold to widen the set."
                },
                "max_episodes_per_week": {
                  "type": "number",
                  "format": "double",
                  "description": "Only podcasts publishing at most this many episodes per week on average (e.g. 0.5 for fortnightly-or-slower shows)."
                },
                "min_episodes_per_week": {
                  "type": "number",
                  "format": "double",
                  "description": "Only podcasts publishing at least this many episodes per week on average (e.g. 5 for weekday dailies). Cadence is measured over the trailing 90 days; podcasts tracked too briefly to measure are excluded."
                },
                "max_avg_episode_minutes": {
                  "type": "integer",
                  "format": "int64",
                  "description": "Only podcasts whose average episode runs at most this many minutes."
                },
                "min_avg_episode_minutes": {
                  "type": "integer",
                  "format": "int64",
                  "description": "Only podcasts whose average episode runs at least this many minutes. Combine with max_avg_episode_minutes to target a length band (e.g. 20–40 minute commute shows)."
                }
              }
            }
          },
          "additionalProperties": false
        }
      }
    }
  }
}

Provenance

Seen in the source catalog

2026-09-06 16:33Z

Last indexed by Roundhouse

2026-09-24 07:40Z

Last enriched (probe, favicon, geo)

2026-09-20 08:15Z

x402 version

2

Max timeout

300s

Liveness probe

HTTP 402