{ "openapi": "3.1.0", "info": { "title": "APIStead", "version": "0.8.0", "summary": "Discovery API for first-party x402 APIs from APIStead Labs.", "description": "APIStead exposes free discovery and per-listing record endpoints for first-party APIs built and operated by APIStead Labs. APIStead Marketplace is not accepting new listing submissions yet. Payment happens on each API's own HTTP 402 challenge in USDC on Base.", "x-guidance": "Free discovery is at /agent, /api/apis/{slug}, /mcp, /llms.txt and this document. Paid routes are under /api/v1 and return HTTP 402 with x402 terms. Call the route unpaid, read PAYMENT-REQUIRED, pay the quoted USDC amount on Base, then retry with PAYMENT-SIGNATURE. The live 402 challenge is the authoritative price. Full payment docs: /api.", "contact": { "name": "APIStead", "url": "https://x402.apistead.qd.je", "email": "spnkrnsm1@gmail.com" }, "x-logo": { "url": "https://x402.apistead.qd.je/icon.svg", "altText": "APIStead" }, "x-icon": "https://x402.apistead.qd.je/favicon.ico", "license": { "name": "Catalogue metadata is public", "identifier": "CC0-1.0" } }, "x-apistead-marketplace": { "accepting_listings": false, "first_party_only": true, "note": "APIStead Marketplace is not live yet and is not accepting new listing submissions. All live APIs are first-party APIs built and operated by APIStead Labs." }, "servers": [ { "url": "https://x402.apistead.qd.je", "description": "Production" } ], "tags": [ { "name": "Discovery", "description": "Free, read-only catalogue endpoints. No authentication and no payment." }, { "name": "geocoding-api", "description": "Geocoding & Reverse Geocoding API. Address to coordinates, coordinates to address. Price: 0.001-0.001 USDC per call. Networks: base.", "externalDocs": { "url": "https://apistead.qd.je/api", "description": "Provider documentation" }, "x-apistead": { "provider": "APIStead Labs", "category": "Weather & Geospatial", "verification": "verified", "base_url": "https://apistead.qd.je/api/v1", "mcp_endpoint": "https://apistead.qd.je/mcp", "json": "https://x402.apistead.qd.je/api/apis/geocoding-api", "markdown": "https://x402.apistead.qd.je/api/apis/geocoding-api/md" } }, { "name": "ip-geolocation-api", "description": "IP Geolocation API. Turn an IP into a place and network. Price: 0.001-0.001 USDC per call. Networks: base.", "externalDocs": { "url": "https://apistead.qd.je/api", "description": "Provider documentation" }, "x-apistead": { "provider": "APIStead Labs", "category": "Address & Location", "verification": "verified", "base_url": "https://apistead.qd.je/api/v1", "mcp_endpoint": "https://apistead.qd.je/mcp", "json": "https://x402.apistead.qd.je/api/apis/ip-geolocation-api", "markdown": "https://x402.apistead.qd.je/api/apis/ip-geolocation-api/md" } }, { "name": "sanctions-screening-api", "description": "Sanctions & PEP Screening API. A deterministic first pass against sanctions lists. Price: 0.01-0.01 USDC per call. Networks: base.", "externalDocs": { "url": "https://apistead.qd.je/api", "description": "Provider documentation" }, "x-apistead": { "provider": "APIStead Labs", "category": "Compliance", "verification": "verified", "base_url": "https://apistead.qd.je/api/v1", "mcp_endpoint": "https://apistead.qd.je/mcp", "json": "https://x402.apistead.qd.je/api/apis/sanctions-screening-api", "markdown": "https://x402.apistead.qd.je/api/apis/sanctions-screening-api/md" } }, { "name": "us-zip-code-api", "description": "US ZIP Code API. Validate and enrich any US ZIP code. Price: 0.001-0.002 USDC per call. Networks: base.", "externalDocs": { "url": "https://apistead.qd.je/api", "description": "Provider documentation" }, "x-apistead": { "provider": "APIStead Labs", "category": "Address & Location", "verification": "verified", "base_url": "https://apistead.qd.je/api/v1", "mcp_endpoint": "https://apistead.qd.je/mcp", "json": "https://x402.apistead.qd.je/api/apis/us-zip-code-api", "markdown": "https://x402.apistead.qd.je/api/apis/us-zip-code-api/md" } }, { "name": "coordinates-distance-api", "description": "Coordinates & Distance API. Distance, midpoint and bearing between coordinates. Price: 0.001-0.001 USDC per call. Networks: base.", "externalDocs": { "url": "https://apistead.qd.je/api", "description": "Provider documentation" }, "x-apistead": { "provider": "APIStead Labs", "category": "Weather & Geospatial", "verification": "verified", "base_url": "https://apistead.qd.je/api/v1", "mcp_endpoint": "https://apistead.qd.je/mcp", "json": "https://x402.apistead.qd.je/api/apis/coordinates-distance-api", "markdown": "https://x402.apistead.qd.je/api/apis/coordinates-distance-api/md" } }, { "name": "email-verification-api", "description": "Email Verification API. Real-time email verification for AI agents, with a quality score. Price: 0.001-0.001 USDC per call. Networks: base.", "externalDocs": { "url": "https://apistead.qd.je/api", "description": "Provider documentation" }, "x-apistead": { "provider": "APIStead Labs", "category": "Verification", "verification": "verified", "base_url": "https://apistead.qd.je/api/v1", "mcp_endpoint": "https://apistead.qd.je/mcp", "json": "https://x402.apistead.qd.je/api/apis/email-verification-api", "markdown": "https://x402.apistead.qd.je/api/apis/email-verification-api/md" } }, { "name": "global-weather-api", "description": "Global Weather API. Current conditions and forecasts by coordinates. Price: 0.001-0.002 USDC per call. Networks: base.", "externalDocs": { "url": "https://apistead.qd.je/api", "description": "Provider documentation" }, "x-apistead": { "provider": "APIStead Labs", "category": "Weather & Geospatial", "verification": "verified", "base_url": "https://apistead.qd.je/api/v1", "mcp_endpoint": "https://apistead.qd.je/mcp", "json": "https://x402.apistead.qd.je/api/apis/global-weather-api", "markdown": "https://x402.apistead.qd.je/api/apis/global-weather-api/md" } }, { "name": "spotify-api", "description": "Spotify API for AI Agents. Spotify API, metadata for agents: playlists, albums, artists and tracks. Complete discographies are in v2. Price: 0.02-0.02 USDC per call. Networks: base.", "externalDocs": { "url": "https://apistead.qd.je/api", "description": "Provider documentation" }, "x-apistead": { "provider": "APIStead Labs", "category": "Media", "verification": "verified", "base_url": "https://apistead.qd.je/api/v1", "mcp_endpoint": "https://apistead.qd.je/mcp", "json": "https://x402.apistead.qd.je/api/apis/spotify-api", "markdown": "https://x402.apistead.qd.je/api/apis/spotify-api/md" } }, { "name": "spotify-api-v2", "description": "Spotify API v2 for AI Agents. Spotify metadata v2: tracks, albums, artists, playlists, search, full discographies, artist playlists, related artists, discovered-on and featuring playlists, similar albums, podcasts, episodes, audiobooks, chapters, genres and users. No auth, no API key. Price: 0.03-0.03 USDC per call. Networks: base.", "externalDocs": { "url": "https://apistead.qd.je/api", "description": "Provider documentation" }, "x-apistead": { "provider": "APIStead Labs", "category": "Media", "verification": "verified", "base_url": "https://apistead.qd.je/api/v2", "mcp_endpoint": "https://apistead.qd.je/mcp", "json": "https://x402.apistead.qd.je/api/apis/spotify-api-v2", "markdown": "https://x402.apistead.qd.je/api/apis/spotify-api-v2/md" } }, { "name": "us-building-permits-api", "description": "US Building Permits API. Permit history for US properties and contractors. Price: 0.01-0.01 USDC per call. Networks: base.", "externalDocs": { "url": "https://apistead.qd.je/api", "description": "Provider documentation" }, "x-apistead": { "provider": "APIStead Labs", "category": "Public Records", "verification": "verified", "base_url": "https://apistead.qd.je/api/v1", "mcp_endpoint": "https://apistead.qd.je/mcp", "json": "https://x402.apistead.qd.je/api/apis/us-building-permits-api", "markdown": "https://x402.apistead.qd.je/api/apis/us-building-permits-api/md" } } ], "paths": { "/agent/search": { "get": { "tags": [ "Discovery" ], "summary": "Search the catalogue", "description": "Free-text search across listings. Discovery never returns a payment challenge.", "parameters": [ { "name": "q", "in": "query", "schema": { "type": "string" }, "description": "Free-text query." }, { "name": "category", "in": "query", "schema": { "type": "string", "enum": [ "Address & Location", "Compliance", "Media", "Public Records", "Verification", "Weather & Geospatial" ] }, "description": "Category filter." }, { "name": "network", "in": "query", "schema": { "type": "string", "enum": [ "base" ] }, "description": "Network filter." }, { "name": "max_price", "in": "query", "schema": { "type": "number", "minimum": 0 }, "description": "Maximum price per call in USDC." }, { "name": "verified_only", "in": "query", "schema": { "type": "boolean" }, "description": "Only return settlement-verified listings." }, { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 } } ], "responses": { "200": { "description": "Search results", "content": { "application/json": { "schema": { "type": "object", "properties": { "query": { "type": "string" }, "total": { "type": "integer" }, "count": { "type": "integer" }, "results": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "slug": { "type": "string" }, "name": { "type": "string" }, "provider": { "type": "object" }, "category": { "type": "string" }, "tagline": { "type": "string" }, "description": { "type": "string" }, "long_description": { "type": "string" }, "agent_summary": { "type": [ "string", "null" ] }, "scope": { "type": [ "string", "null" ] }, "intent_phrases": { "type": "array", "items": { "type": "string" } }, "faqs": { "type": "array", "items": { "type": "object" } }, "code_examples": { "type": "array", "items": { "type": "object" } }, "price": { "type": "object" }, "payment": { "type": "object" }, "networks": { "type": "array", "items": { "type": "string" } }, "primary_network": { "type": "string" }, "verification": { "type": "string", "enum": [ "verified", "listed", "paused" ] }, "verification_detail": { "type": "object" }, "reliability": { "type": "object" }, "base_url": { "type": "string", "format": "uri" }, "mcp_endpoint": { "type": [ "string", "null" ], "format": "uri" }, "docs_url": { "type": [ "string", "null" ], "format": "uri" }, "tags": { "type": "array", "items": { "type": "string" } }, "use_cases": { "type": "array", "items": { "type": "string" } }, "routes": { "type": "array", "items": { "type": "object", "properties": { "method": { "type": "string" }, "path": { "type": "string" }, "url": { "type": "string", "format": "uri" }, "price_usdc": { "type": "number" }, "pay_to": { "type": [ "string", "null" ] }, "description": { "type": "string" }, "example_request": { "type": "string" }, "example_response": { "type": "object" }, "verified": { "type": "boolean" }, "last_checked_at": { "type": [ "string", "null" ], "format": "date-time" }, "latency_ms": { "type": [ "number", "null" ] }, "uptime_30d": { "type": [ "number", "null" ] } } } }, "links": { "type": "object" }, "changelog": { "type": "array", "items": { "type": "object" } } } } } } } } } }, "400": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "status": { "type": "integer" } } } } } } }, "security": [] } }, "/agent/list": { "get": { "tags": [ "Discovery" ], "summary": "List the catalogue", "parameters": [ { "name": "category", "in": "query", "schema": { "type": "string", "enum": [ "Address & Location", "Compliance", "Media", "Public Records", "Verification", "Weather & Geospatial" ] } }, { "name": "network", "in": "query", "schema": { "type": "string", "enum": [ "base" ] } }, { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 100 } }, { "name": "cursor", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Paginated catalogue", "content": { "application/json": { "schema": { "type": "object", "properties": { "total": { "type": "integer" }, "count": { "type": "integer" }, "next_cursor": { "type": [ "string", "null" ] }, "results": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "slug": { "type": "string" }, "name": { "type": "string" }, "provider": { "type": "object" }, "category": { "type": "string" }, "tagline": { "type": "string" }, "description": { "type": "string" }, "long_description": { "type": "string" }, "agent_summary": { "type": [ "string", "null" ] }, "scope": { "type": [ "string", "null" ] }, "intent_phrases": { "type": "array", "items": { "type": "string" } }, "faqs": { "type": "array", "items": { "type": "object" } }, "code_examples": { "type": "array", "items": { "type": "object" } }, "price": { "type": "object" }, "payment": { "type": "object" }, "networks": { "type": "array", "items": { "type": "string" } }, "primary_network": { "type": "string" }, "verification": { "type": "string", "enum": [ "verified", "listed", "paused" ] }, "verification_detail": { "type": "object" }, "reliability": { "type": "object" }, "base_url": { "type": "string", "format": "uri" }, "mcp_endpoint": { "type": [ "string", "null" ], "format": "uri" }, "docs_url": { "type": [ "string", "null" ], "format": "uri" }, "tags": { "type": "array", "items": { "type": "string" } }, "use_cases": { "type": "array", "items": { "type": "string" } }, "routes": { "type": "array", "items": { "type": "object", "properties": { "method": { "type": "string" }, "path": { "type": "string" }, "url": { "type": "string", "format": "uri" }, "price_usdc": { "type": "number" }, "pay_to": { "type": [ "string", "null" ] }, "description": { "type": "string" }, "example_request": { "type": "string" }, "example_response": { "type": "object" }, "verified": { "type": "boolean" }, "last_checked_at": { "type": [ "string", "null" ], "format": "date-time" }, "latency_ms": { "type": [ "number", "null" ] }, "uptime_30d": { "type": [ "number", "null" ] } } } }, "links": { "type": "object" }, "changelog": { "type": "array", "items": { "type": "object" } } } } } } } } } }, "400": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "status": { "type": "integer" } } } } } } }, "security": [] } }, "/agent/get": { "get": { "tags": [ "Discovery" ], "summary": "Get one listing", "parameters": [ { "name": "id", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Listing slug or id." } ], "responses": { "200": { "description": "A listing with routes, verification and reliability", "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string" }, "slug": { "type": "string" }, "name": { "type": "string" }, "provider": { "type": "object" }, "category": { "type": "string" }, "tagline": { "type": "string" }, "description": { "type": "string" }, "long_description": { "type": "string" }, "agent_summary": { "type": [ "string", "null" ] }, "scope": { "type": [ "string", "null" ] }, "intent_phrases": { "type": "array", "items": { "type": "string" } }, "faqs": { "type": "array", "items": { "type": "object" } }, "code_examples": { "type": "array", "items": { "type": "object" } }, "price": { "type": "object" }, "payment": { "type": "object" }, "networks": { "type": "array", "items": { "type": "string" } }, "primary_network": { "type": "string" }, "verification": { "type": "string", "enum": [ "verified", "listed", "paused" ] }, "verification_detail": { "type": "object" }, "reliability": { "type": "object" }, "base_url": { "type": "string", "format": "uri" }, "mcp_endpoint": { "type": [ "string", "null" ], "format": "uri" }, "docs_url": { "type": [ "string", "null" ], "format": "uri" }, "tags": { "type": "array", "items": { "type": "string" } }, "use_cases": { "type": "array", "items": { "type": "string" } }, "routes": { "type": "array", "items": { "type": "object", "properties": { "method": { "type": "string" }, "path": { "type": "string" }, "url": { "type": "string", "format": "uri" }, "price_usdc": { "type": "number" }, "pay_to": { "type": [ "string", "null" ] }, "description": { "type": "string" }, "example_request": { "type": "string" }, "example_response": { "type": "object" }, "verified": { "type": "boolean" }, "last_checked_at": { "type": [ "string", "null" ], "format": "date-time" }, "latency_ms": { "type": [ "number", "null" ] }, "uptime_30d": { "type": [ "number", "null" ] } } } }, "links": { "type": "object" }, "changelog": { "type": "array", "items": { "type": "object" } } } } } } }, "400": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "status": { "type": "integer" } } } } } }, "404": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "status": { "type": "integer" } } } } } } }, "security": [] } }, "/agent/routes": { "get": { "tags": [ "Discovery" ], "summary": "Get the routes for a listing", "parameters": [ { "name": "id", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Routes and examples" }, "400": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "status": { "type": "integer" } } } } } }, "404": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "status": { "type": "integer" } } } } } } }, "security": [] } }, "/agent/receipts": { "get": { "tags": [ "Discovery" ], "summary": "Get verification receipts", "description": "Omit id to list recent paid verification receipts. Pass id to get the receipts for one listing.", "parameters": [ { "name": "id", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Listing slug or id." } ], "responses": { "200": { "description": "Recent receipts, or receipts for one listing" }, "404": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "status": { "type": "integer" } } } } } } }, "security": [] } }, "/api/apis/{slug}": { "get": { "tags": [ "Discovery" ], "summary": "Read one listing as JSON", "description": "Agent-readable listing record with provider, pricing, payment terms, verification, normalized routes, example requests and responses, FAQs and code examples. Free and unauthenticated.", "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Listing slug, for example spotify-api." } ], "responses": { "200": { "description": "Listing record", "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string" }, "slug": { "type": "string" }, "name": { "type": "string" }, "provider": { "type": "object" }, "category": { "type": "string" }, "tagline": { "type": "string" }, "description": { "type": "string" }, "long_description": { "type": "string" }, "agent_summary": { "type": [ "string", "null" ] }, "scope": { "type": [ "string", "null" ] }, "intent_phrases": { "type": "array", "items": { "type": "string" } }, "faqs": { "type": "array", "items": { "type": "object" } }, "code_examples": { "type": "array", "items": { "type": "object" } }, "price": { "type": "object" }, "payment": { "type": "object" }, "networks": { "type": "array", "items": { "type": "string" } }, "primary_network": { "type": "string" }, "verification": { "type": "string", "enum": [ "verified", "listed", "paused" ] }, "verification_detail": { "type": "object" }, "reliability": { "type": "object" }, "base_url": { "type": "string", "format": "uri" }, "mcp_endpoint": { "type": [ "string", "null" ], "format": "uri" }, "docs_url": { "type": [ "string", "null" ], "format": "uri" }, "tags": { "type": "array", "items": { "type": "string" } }, "use_cases": { "type": "array", "items": { "type": "string" } }, "routes": { "type": "array", "items": { "type": "object", "properties": { "method": { "type": "string" }, "path": { "type": "string" }, "url": { "type": "string", "format": "uri" }, "price_usdc": { "type": "number" }, "pay_to": { "type": [ "string", "null" ] }, "description": { "type": "string" }, "example_request": { "type": "string" }, "example_response": { "type": "object" }, "verified": { "type": "boolean" }, "last_checked_at": { "type": [ "string", "null" ], "format": "date-time" }, "latency_ms": { "type": [ "number", "null" ] }, "uptime_30d": { "type": [ "number", "null" ] } } } }, "links": { "type": "object" }, "changelog": { "type": "array", "items": { "type": "object" } } } } } } }, "404": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "status": { "type": "integer" } } } } } } }, "security": [] } }, "/api/apis/{slug}/md": { "get": { "tags": [ "Discovery" ], "summary": "Read one listing as Markdown", "description": "The same listing record as a single Markdown document, including route details, example responses, payment terms, verification receipt, FAQ and code examples.", "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Listing slug, for example spotify-api." } ], "responses": { "200": { "description": "Markdown listing record", "content": { "text/markdown": { "schema": { "type": "string" } } } }, "404": { "description": "No listing found", "content": { "text/markdown": { "schema": { "type": "string" } } } } }, "security": [] } }, "/mcp": { "post": { "tags": [ "Discovery" ], "summary": "MCP JSON-RPC endpoint", "description": "Streamable HTTP MCP endpoint. Free discovery tools: search_apis, list_apis, list_bundles, get_api, get_routes, get_receipt and check_reliability. submit_listing returns the current listing submission status. Submissions are closed.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "jsonrpc": { "type": "string", "const": "2.0" }, "id": { "type": [ "string", "number" ] }, "method": { "type": "string" }, "params": { "type": "object" } }, "required": [ "jsonrpc", "method" ] } } } }, "responses": { "200": { "description": "JSON-RPC response or SSE stream" }, "400": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "status": { "type": "integer" } } } } } } }, "security": [] } }, "/llms.txt": { "get": { "tags": [ "Discovery" ], "summary": "LLM-oriented catalogue map", "responses": { "200": { "description": "text/plain" } }, "security": [] } }, "/openapi.json": { "get": { "tags": [ "Discovery" ], "summary": "This document", "responses": { "200": { "description": "OpenAPI 3.1 document" } }, "security": [] } }, "/api/v1/geocode": { "get": { "operationId": "get_api_v1_geocode", "tags": [ "geocoding-api" ], "summary": "Forward geocode an address.", "description": "Forward geocode an address. Price: $0.001000 USD per call on Base via x402. The live 402 challenge is the authoritative price.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.001000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "lat": { "type": "number" }, "lon": { "type": "number" }, "source": { "type": "string" }, "place_id": { "type": "string" }, "confidence": { "type": "number" }, "formatted_address": { "type": "string" } }, "required": [ "lat", "lon", "source", "place_id", "confidence", "formatted_address" ] } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "address", "in": "query", "required": false, "schema": { "type": "string", "example": "10 Downing Street London" }, "description": "Address to geocode or reverse geocode" } ] } }, "/api/v1/reverse": { "get": { "operationId": "get_api_v1_reverse", "tags": [ "geocoding-api" ], "summary": "Reverse geocode a coordinate.", "description": "Reverse geocode a coordinate. Price: $0.001000 USD per call on Base via x402. The live 402 challenge is the authoritative price.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.001000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "city": { "type": "string" }, "source": { "type": "string" }, "country": { "type": "string" }, "place_id": { "type": "string" }, "country_code": { "type": "string" }, "formatted_address": { "type": "string" } }, "required": [ "city", "source", "country", "place_id", "country_code", "formatted_address" ] } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "lat", "in": "query", "required": false, "schema": { "type": "string", "example": "51.5034" }, "description": "Latitude in decimal degrees" }, { "name": "lon", "in": "query", "required": false, "schema": { "type": "string", "example": "-0.1276" }, "description": "Longitude in decimal degrees" } ] } }, "/api/v1/ip/me": { "get": { "operationId": "get_api_v1_ip_me", "tags": [ "ip-geolocation-api" ], "summary": "Look up the caller's own public IP.", "description": "Look up the caller's own public IP. Price: $0.001000 USD per call on Base via x402. The live 402 challenge is the authoritative price.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.001000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "ip": { "type": "string" }, "city": { "type": "string" }, "country": { "type": "string" }, "country_code": { "type": "string" } }, "required": [ "ip", "city", "country", "country_code" ] } } } }, "402": { "description": "Payment Required" } } } }, "/api/v1/ip/{ip}": { "get": { "operationId": "get_api_v1_ip_ip", "tags": [ "ip-geolocation-api" ], "summary": "Look up a public IPv4 or IPv6 address.", "description": "Look up a public IPv4 or IPv6 address. Price: $0.001000 USD per call on Base via x402. The live 402 challenge is the authoritative price.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.001000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "ip": { "type": "string" }, "asn": { "type": "string" }, "city": { "type": "string" }, "region": { "type": "string" }, "source": { "type": "string" }, "country": { "type": "string" }, "latitude": { "type": "number" }, "timezone": { "type": "string" }, "longitude": { "type": "number" }, "country_code": { "type": "string" } }, "required": [ "ip", "asn", "city", "region", "source", "country", "latitude", "timezone", "longitude", "country_code" ] } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "ip", "in": "path", "required": true, "schema": { "type": "string", "example": "8.8.8.8" }, "description": "IPv4 or IPv6 address" } ] } }, "/api/v1/sanctions/screen": { "post": { "operationId": "post_api_v1_sanctions_screen", "tags": [ "sanctions-screening-api" ], "summary": "Screen a name against the local sanctions and PEP sample.", "description": "Screen a name against the local sanctions and PEP sample. Price: $0.010000 USD per call on Base via x402. The live 402 challenge is the authoritative price.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.010000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "note": { "type": "string" }, "matches": { "type": "array", "items": {} }, "screening_id": { "type": "string" }, "lists_checked": { "type": "array", "items": { "type": "string" } } }, "required": [ "note", "matches", "screening_id", "lists_checked" ] } } } }, "402": { "description": "Payment Required" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string" }, "country": { "type": "string" } }, "required": [ "name", "country" ] }, "example": { "name": "Ivan Petrov", "country": "RU" } } } } } }, "/api/v1/us-zip/{zip}": { "get": { "operationId": "get_api_v1_us_zip_zip", "tags": [ "us-zip-code-api" ], "summary": "Validate a US ZIP code and return city, state and coordinates.", "description": "Validate a US ZIP code and return city, state and coordinates. Price: $0.001000 USD per call on Base via x402. The live 402 challenge is the authoritative price.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.001000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "zip": { "type": "string" }, "city": { "type": "string" }, "state": { "type": "string" }, "source": { "type": "string" }, "latitude": { "type": "number" }, "longitude": { "type": "number" }, "retrieved_at": { "type": "string" } }, "required": [ "zip", "city", "state", "source", "latitude", "longitude", "retrieved_at" ] } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "zip", "in": "path", "required": true, "schema": { "type": "string", "example": "10001" }, "description": "US ZIP code" } ] } }, "/api/v1/us-zip/distance": { "get": { "operationId": "get_api_v1_us_zip_distance", "tags": [ "us-zip-code-api" ], "summary": "Great-circle distance between two US ZIP centroids.", "description": "Great-circle distance between two US ZIP centroids. Price: $0.002000 USD per call on Base via x402. The live 402 challenge is the authoritative price.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.002000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "to": { "type": "string" }, "from": { "type": "string" }, "distance_km": { "type": "number" }, "distance_miles": { "type": "number" } }, "required": [ "to", "from", "distance_km", "distance_miles" ] } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "from", "in": "query", "required": false, "schema": { "type": "string", "example": "10001" }, "description": "Origin ZIP code or latitude,longitude pair" }, { "name": "to", "in": "query", "required": false, "schema": { "type": "string", "example": "90210" }, "description": "Destination ZIP code or latitude,longitude pair" } ] } }, "/api/v1/distance": { "get": { "operationId": "get_api_v1_distance", "tags": [ "coordinates-distance-api" ], "summary": "Great-circle distance, midpoint and initial bearing.", "description": "Great-circle distance, midpoint and initial bearing. Price: $0.001000 USD per call on Base via x402. The live 402 challenge is the authoritative price.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.001000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "to": { "type": "object", "properties": { "lat": { "type": "number" }, "lon": { "type": "number" } }, "required": [ "lat", "lon" ] }, "from": { "type": "object", "properties": { "lat": { "type": "number" }, "lon": { "type": "number" } }, "required": [ "lat", "lon" ] }, "midpoint": { "type": "object", "properties": { "lat": { "type": "integer" }, "lon": { "type": "integer" } }, "required": [ "lat", "lon" ] }, "distance_km": { "type": "number" }, "distance_miles": { "type": "number" }, "initial_bearing_deg": { "type": "number" }, "distance_nautical_miles": { "type": "number" } }, "required": [ "to", "from", "midpoint", "distance_km", "distance_miles", "initial_bearing_deg", "distance_nautical_miles" ] } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "from", "in": "query", "required": false, "schema": { "type": "string", "example": "51.5074,-0.1278" }, "description": "Origin ZIP code or latitude,longitude pair" }, { "name": "to", "in": "query", "required": false, "schema": { "type": "string", "example": "40.7128,-74.0060" }, "description": "Destination ZIP code or latitude,longitude pair" } ] } }, "/api/v1/email/verify": { "post": { "operationId": "post_api_v1_email_verify", "tags": [ "email-verification-api" ], "summary": "Verify email syntax, domain and MX records.", "description": "Verify email syntax, domain and MX records. Price: $0.001000 USD per call on Base via x402. The live 402 challenge is the authoritative price.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.001000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "mx": { "type": "array", "items": {} }, "note": { "type": "string" }, "email": { "type": "string" }, "checks": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "detail": { "type": "string" }, "status": { "type": "string" } }, "required": [ "name", "detail", "status" ] } }, "domain": { "type": "string" }, "reason": { "type": "string" }, "null_mx": { "type": "boolean" }, "preview": { "type": "boolean" }, "verdict": { "type": "string" }, "checked_at": { "type": "string" }, "confidence": { "type": "integer" }, "disposable": { "type": "boolean" }, "suggestion": { "type": "null" }, "implicit_mx": { "type": "boolean" }, "accepts_mail": { "type": "boolean" }, "role_account": { "type": "boolean" }, "free_provider": { "type": "boolean" }, "mailbox_checked": { "type": "boolean" }, "normalized_email": { "type": "string" } }, "required": [ "mx", "note", "email", "checks", "domain", "reason", "null_mx", "preview", "verdict", "checked_at", "confidence", "disposable", "suggestion", "implicit_mx", "accepts_mail", "role_account", "free_provider", "mailbox_checked", "normalized_email" ] } } } }, "402": { "description": "Payment Required" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "email": { "type": "string" } }, "required": [ "email" ] }, "example": { "email": "hello@example.com" } } } } } }, "/api/v1/weather/current": { "get": { "operationId": "get_api_v1_weather_current", "tags": [ "global-weather-api" ], "summary": "Current conditions for a coordinate.", "description": "Current conditions for a coordinate. Price: $0.001000 USD per call on Base via x402. The live 402 challenge is the authoritative price.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.001000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "source": { "type": "string" }, "location": { "type": "object", "properties": { "lat": { "type": "number" }, "lon": { "type": "number" }, "timezone": { "type": "string" } }, "required": [ "lat", "lon", "timezone" ] }, "wind_kph": { "type": "integer" }, "condition": { "type": "string" }, "generated_at": { "type": "string" }, "temperature_c": { "type": "number" } }, "required": [ "source", "location", "wind_kph", "condition", "generated_at", "temperature_c" ] } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "lat", "in": "query", "required": false, "schema": { "type": "string", "example": "51.5074" }, "description": "Latitude in decimal degrees" }, { "name": "lon", "in": "query", "required": false, "schema": { "type": "string", "example": "-0.1278" }, "description": "Longitude in decimal degrees" } ] } }, "/api/v1/weather/forecast": { "get": { "operationId": "get_api_v1_weather_forecast", "tags": [ "global-weather-api" ], "summary": "Daily forecast for up to 7 days.", "description": "Daily forecast for up to 7 days. Price: $0.002000 USD per call on Base via x402. The live 402 challenge is the authoritative price.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.002000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "days": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string" }, "low_c": { "type": "integer" }, "high_c": { "type": "integer" }, "condition": { "type": "string" } }, "required": [ "date", "low_c", "high_c", "condition" ] } }, "source": { "type": "string" } }, "required": [ "days", "source" ] } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "lat", "in": "query", "required": false, "schema": { "type": "string", "example": "51.5074" }, "description": "Latitude in decimal degrees" }, { "name": "lon", "in": "query", "required": false, "schema": { "type": "string", "example": "-0.1278" }, "description": "Longitude in decimal degrees" }, { "name": "days", "in": "query", "required": false, "schema": { "type": "integer", "example": 3 }, "description": "Number of forecast days" } ] } }, "/api/v1/spotify/album": { "get": { "operationId": "get_api_v1_spotify_album", "tags": [ "spotify-api" ], "summary": "Get Spotify album metadata, cover art, artists, release date, copyright lines and the full ordered track list.", "description": "Get Spotify album metadata, cover art, artists, release date, copyright lines and the full ordered track list. Price: $0.020000 USD per call on Base via x402. The live 402 challenge is the authoritative price.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.020000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "album": { "type": "object", "properties": { "id": { "type": "string" }, "uri": { "type": "string" }, "url": { "type": "string" }, "name": { "type": "string" }, "type": { "type": "string" }, "artists": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "url": { "type": "string" }, "name": { "type": "string" } }, "required": [ "id", "url", "name" ] } }, "playable": { "type": "boolean" }, "copyrights": { "type": "array", "items": { "type": "string" } }, "cover_image": { "type": "string" }, "duration_ms": { "type": "integer" }, "track_count": { "type": "integer" }, "release_date": { "type": "string" }, "explicit_count": { "type": "integer" }, "duration_formatted": { "type": "string" } }, "required": [ "id", "uri", "url", "name", "type", "artists", "playable", "copyrights", "cover_image", "duration_ms", "track_count", "release_date", "explicit_count", "duration_formatted" ] }, "source": { "type": "string" }, "tracks": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "uri": { "type": "string" }, "url": { "type": "string" }, "album": { "type": "object", "properties": { "id": { "type": "string" }, "url": { "type": "string" }, "name": { "type": "string" }, "release_date": { "type": "string" } }, "required": [ "id", "url", "name", "release_date" ] }, "title": { "type": "string" }, "artists": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "url": { "type": "string" }, "name": { "type": "string" } }, "required": [ "id", "url", "name" ] } }, "artwork": { "type": "string" }, "explicit": { "type": "boolean" }, "playable": { "type": "boolean" }, "position": { "type": "integer" }, "disc_number": { "type": "integer" }, "duration_ms": { "type": "integer" }, "preview_url": { "type": "string" }, "track_number": { "type": "integer" }, "duration_formatted": { "type": "string" } }, "required": [ "id", "uri", "url", "album", "title", "artists", "artwork", "explicit", "playable", "position", "disc_number", "duration_ms", "preview_url", "track_number", "duration_formatted" ] } }, "preview": { "type": "boolean" }, "summary": { "type": "object", "properties": { "duration_ms": { "type": "integer" }, "track_count": { "type": "integer" }, "explicit_count": { "type": "integer" }, "unique_artists": { "type": "integer" }, "returned_tracks": { "type": "integer" }, "duration_formatted": { "type": "string" }, "average_track_duration_ms": { "type": "integer" } }, "required": [ "duration_ms", "track_count", "explicit_count", "unique_artists", "returned_tracks", "duration_formatted", "average_track_duration_ms" ] }, "retrieved_at": { "type": "string" } }, "required": [ "album", "source", "tracks", "preview", "summary", "retrieved_at" ] } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string", "example": "https://open.spotify.com/album/5WulAOx9ilWy1h8UGZ1gkI" }, "description": "Spotify URL, URI or 22-character id" }, { "name": "id", "in": "query", "required": false, "schema": { "type": "string", "example": "5WulAOx9ilWy1h8UGZ1gkI" }, "description": "22-character Spotify artist, album, track or playlist id" } ] } }, "/api/v1/spotify/artist": { "get": { "operationId": "get_api_v1_spotify_artist", "tags": [ "spotify-api" ], "summary": "Get a Spotify artist profile with monthly listeners, followers, bio when published and top tracks with collaborator ids and album context.", "description": "Get a Spotify artist profile with monthly listeners, followers, bio when published and top tracks with collaborator ids and album context. Price: $0.020000 USD per call on Base via x402. The live 402 challenge is the authoritative price.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.020000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "artist": { "type": "object", "properties": { "id": { "type": "string" }, "bio": { "type": "string" }, "uri": { "type": "string" }, "url": { "type": "string" }, "name": { "type": "string" }, "image": { "type": "string" }, "followers": { "type": "integer" }, "monthly_listeners": { "type": "integer" } }, "required": [ "id", "bio", "uri", "url", "name", "image", "followers", "monthly_listeners" ] }, "source": { "type": "string" }, "preview": { "type": "boolean" }, "summary": { "type": "object", "properties": { "top_tracks": { "type": "integer" }, "duration_ms": { "type": "integer" }, "explicit_count": { "type": "integer" }, "unique_artists": { "type": "integer" }, "duration_formatted": { "type": "string" } }, "required": [ "top_tracks", "duration_ms", "explicit_count", "unique_artists", "duration_formatted" ] }, "top_tracks": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "uri": { "type": "string" }, "url": { "type": "string" }, "album": { "type": "object", "properties": { "id": { "type": "string" }, "url": { "type": "string" }, "name": { "type": "string" }, "release_date": { "type": "string" } }, "required": [ "id", "url", "name", "release_date" ] }, "title": { "type": "string" }, "artists": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "url": { "type": "string" }, "name": { "type": "string" } }, "required": [ "id", "url", "name" ] } }, "artwork": { "type": "string" }, "explicit": { "type": "boolean" }, "playable": { "type": "boolean" }, "position": { "type": "integer" }, "duration_ms": { "type": "integer" }, "preview_url": { "type": "string" }, "duration_formatted": { "type": "string" } }, "required": [ "id", "uri", "url", "album", "title", "artists", "artwork", "explicit", "playable", "position", "duration_ms", "preview_url", "duration_formatted" ] } }, "retrieved_at": { "type": "string" } }, "required": [ "artist", "source", "preview", "summary", "top_tracks", "retrieved_at" ] } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string", "example": "https://open.spotify.com/artist/5INjqkS1o8h1imAzPqGZBb" }, "description": "Spotify URL, URI or 22-character id" }, { "name": "id", "in": "query", "required": false, "schema": { "type": "string", "example": "5INjqkS1o8h1imAzPqGZBb" }, "description": "22-character Spotify artist, album, track or playlist id" } ] } }, "/api/v1/spotify/playlist": { "get": { "operationId": "get_api_v1_spotify_playlist", "tags": [ "spotify-api" ], "summary": "Get Spotify playlist cover art, owner, ordered tracks, artists, artwork, duration and optional album enrichment.", "description": "Get Spotify playlist cover art, owner, ordered tracks, artists, artwork, duration and optional album enrichment. Price: $0.020000 USD per call on Base via x402. The live 402 challenge is the authoritative price.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.020000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "source": { "type": "string" }, "tracks": { "type": "array", "items": { "type": "object", "properties": { "album": { "type": "object", "properties": { "name": { "type": "string" }, "release_date": { "type": "string" } }, "required": [ "name", "release_date" ] }, "title": { "type": "string" }, "artists": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "url": { "type": "string" }, "name": { "type": "string" } }, "required": [ "id", "url", "name" ] } }, "artwork": { "type": "string" }, "explicit": { "type": "boolean" }, "position": { "type": "integer" }, "duration_formatted": { "type": "string" } }, "required": [ "album", "title", "artists", "artwork", "explicit", "position", "duration_formatted" ] } }, "preview": { "type": "boolean" }, "summary": { "type": "object", "properties": { "unique_albums": { "type": "integer" }, "unique_artists": { "type": "integer" }, "returned_tracks": { "type": "integer" }, "duration_formatted": { "type": "string" } }, "required": [ "unique_albums", "unique_artists", "returned_tracks", "duration_formatted" ] }, "playlist": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "owner": { "type": "object", "properties": { "id": { "type": "string" }, "url": { "type": "string" }, "name": { "type": "string" }, "avatar": { "type": "string" } }, "required": [ "id", "url", "name", "avatar" ] }, "saves": { "type": "integer" }, "cover_image": { "type": "string" }, "description": { "type": "string" }, "track_count": { "type": "integer" }, "explicit_count": { "type": "integer" }, "duration_formatted": { "type": "string" } }, "required": [ "id", "name", "owner", "saves", "cover_image", "description", "track_count", "explicit_count", "duration_formatted" ] }, "retrieved_at": { "type": "string" }, "album_enrichment": { "type": "object", "properties": { "limit": { "type": "integer" }, "limited": { "type": "boolean" }, "requested": { "type": "boolean" }, "enriched_tracks": { "type": "integer" } }, "required": [ "limit", "limited", "requested", "enriched_tracks" ] } }, "required": [ "source", "tracks", "preview", "summary", "playlist", "retrieved_at", "album_enrichment" ] } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string", "example": "https://open.spotify.com/playlist/37i9dQZF1DXcBWIGoYBM5M" }, "description": "Spotify URL, URI or 22-character id" }, { "name": "include_albums", "in": "query", "required": false, "schema": { "type": "boolean", "example": true }, "description": "Include album context on playlist tracks" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "example": 20 }, "description": "Maximum number of items to return" }, { "name": "album_limit", "in": "query", "required": false, "schema": { "type": "integer", "example": 10 }, "description": "Maximum number of playlist tracks to enrich with album context" }, { "name": "id", "in": "query", "required": false, "schema": { "type": "string", "example": "37i9dQZF1DXcBWIGoYBM5M" }, "description": "22-character Spotify artist, album, track or playlist id" } ] } }, "/api/v1/spotify/track": { "get": { "operationId": "get_api_v1_spotify_track", "tags": [ "spotify-api" ], "summary": "Get Spotify track metadata, artists, album context, release date, copyright lines, duration, preview URL and artwork.", "description": "Get Spotify track metadata, artists, album context, release date, copyright lines, duration, preview URL and artwork. Price: $0.020000 USD per call on Base via x402. The live 402 challenge is the authoritative price.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.020000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "note": { "type": "string" }, "track": { "type": "object", "properties": { "id": { "type": "string" }, "uri": { "type": "string" }, "url": { "type": "string" }, "album": { "type": "object", "properties": { "id": { "type": "string" }, "url": { "type": "string" }, "name": { "type": "string" }, "release_date": { "type": "string" } }, "required": [ "id", "url", "name", "release_date" ] }, "title": { "type": "string" }, "artists": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "url": { "type": "string" }, "name": { "type": "string" } }, "required": [ "id", "url", "name" ] } }, "artwork": { "type": "string" }, "explicit": { "type": "boolean" }, "playable": { "type": "boolean" }, "copyrights": { "type": "array", "items": { "type": "string" } }, "duration_ms": { "type": "integer" }, "preview_url": { "type": "string" }, "release_date": { "type": "string" }, "duration_formatted": { "type": "string" } }, "required": [ "id", "uri", "url", "album", "title", "artists", "artwork", "explicit", "playable", "copyrights", "duration_ms", "preview_url", "release_date", "duration_formatted" ] }, "source": { "type": "string" }, "preview": { "type": "boolean" }, "retrieved_at": { "type": "string" } }, "required": [ "note", "track", "source", "preview", "retrieved_at" ] } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string", "example": "https://open.spotify.com/track/4cOdK2wGLETKBW3PvgPWqT" }, "description": "Spotify URL, URI or 22-character id" }, { "name": "id", "in": "query", "required": false, "schema": { "type": "string", "example": "4cOdK2wGLETKBW3PvgPWqT" }, "description": "22-character Spotify artist, album, track or playlist id" } ] } }, "/api/v1/spotify/artist/top-tracks": { "get": { "operationId": "get_api_v1_spotify_artist_top_tracks", "tags": [ "spotify-api" ], "summary": "Get a Spotify artist's ranked top tracks with album context, artists, duration, preview URL and artwork.", "description": "Get a Spotify artist's ranked top tracks with album context, artists, duration, preview URL and artwork. Price: $0.020000 USD per call on Base via x402. The live 402 challenge is the authoritative price.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.020000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "note": { "type": "string" }, "artist": { "type": "object", "properties": { "id": { "type": "string" }, "bio": { "type": "string" }, "uri": { "type": "string" }, "url": { "type": "string" }, "name": { "type": "string" }, "image": { "type": "string" }, "followers": { "type": "integer" }, "monthly_listeners": { "type": "integer" } }, "required": [ "id", "bio", "uri", "url", "name", "image", "followers", "monthly_listeners" ] }, "source": { "type": "string" }, "preview": { "type": "boolean" }, "summary": { "type": "object", "properties": { "duration_ms": { "type": "integer" }, "explicit_count": { "type": "integer" }, "unique_artists": { "type": "integer" }, "requested_limit": { "type": "integer" }, "returned_tracks": { "type": "integer" }, "duration_formatted": { "type": "string" }, "available_top_tracks": { "type": "integer" } }, "required": [ "duration_ms", "explicit_count", "unique_artists", "requested_limit", "returned_tracks", "duration_formatted", "available_top_tracks" ] }, "top_tracks": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "uri": { "type": "string" }, "url": { "type": "string" }, "album": { "type": "object", "properties": { "id": { "type": "string" }, "url": { "type": "string" }, "name": { "type": "string" }, "release_date": { "type": "string" } }, "required": [ "id", "url", "name", "release_date" ] }, "title": { "type": "string" }, "artists": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "url": { "type": "string" }, "name": { "type": "string" } }, "required": [ "id", "url", "name" ] } }, "artwork": { "type": "string" }, "explicit": { "type": "boolean" }, "playable": { "type": "boolean" }, "position": { "type": "integer" }, "duration_ms": { "type": "integer" }, "preview_url": { "type": "string" }, "duration_formatted": { "type": "string" } }, "required": [ "id", "uri", "url", "album", "title", "artists", "artwork", "explicit", "playable", "position", "duration_ms", "preview_url", "duration_formatted" ] } }, "retrieved_at": { "type": "string" } }, "required": [ "note", "artist", "source", "preview", "summary", "top_tracks", "retrieved_at" ] } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string", "example": "https://open.spotify.com/artist/5INjqkS1o8h1imAzPqGZBb" }, "description": "Spotify URL, URI or 22-character id" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "example": 2 }, "description": "Maximum number of items to return" }, { "name": "id", "in": "query", "required": false, "schema": { "type": "string", "example": "5INjqkS1o8h1imAzPqGZBb" }, "description": "22-character Spotify artist, album, track or playlist id" } ] } }, "/api/v2/spotify/search": { "get": { "operationId": "get_api_v2_spotify_search", "tags": [ "spotify-api-v2" ], "summary": "Search Spotify tracks, albums, artists, playlists, podcasts, episodes, audiobooks, genres and users.", "description": "Search Spotify tracks, albums, artists, playlists, podcasts, episodes, audiobooks, genres and users. Price: $0.030000 USD per call on Base via x402. The live 402 challenge is the authoritative price.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.030000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "note": { "type": "string" }, "type": { "type": "string" }, "limit": { "type": "integer" }, "query": { "type": "string" }, "users": { "type": "array", "items": {} }, "albums": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "uri": { "type": "string" }, "url": { "type": "string" }, "name": { "type": "string" }, "type": { "type": "string" }, "artists": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "url": { "type": "string" }, "name": { "type": "string" } }, "required": [ "id", "url", "name" ] } }, "cover_image": { "type": "string" }, "track_count": { "type": "null" }, "release_date": { "type": "string" } }, "required": [ "id", "uri", "url", "name", "type", "artists", "cover_image", "track_count", "release_date" ] } }, "counts": { "type": "object", "properties": { "users": { "type": "integer" }, "albums": { "type": "integer" }, "genres": { "type": "integer" }, "tracks": { "type": "integer" }, "artists": { "type": "integer" }, "episodes": { "type": "integer" }, "podcasts": { "type": "integer" }, "playlists": { "type": "integer" }, "audiobooks": { "type": "integer" } }, "required": [ "users", "albums", "genres", "tracks", "artists", "episodes", "podcasts", "playlists", "audiobooks" ] }, "genres": { "type": "array", "items": {} }, "offset": { "type": "integer" }, "source": { "type": "string" }, "totals": { "type": "object", "properties": { "users": { "type": "integer" }, "albums": { "type": "integer" }, "genres": { "type": "integer" }, "tracks": { "type": "integer" }, "artists": { "type": "integer" }, "episodes": { "type": "integer" }, "podcasts": { "type": "integer" }, "playlists": { "type": "integer" }, "audiobooks": { "type": "integer" } }, "required": [ "users", "albums", "genres", "tracks", "artists", "episodes", "podcasts", "playlists", "audiobooks" ] }, "tracks": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "uri": { "type": "string" }, "url": { "type": "string" }, "album": { "type": "object", "properties": { "id": { "type": "string" }, "url": { "type": "string" }, "name": { "type": "string" }, "release_date": { "type": "string" } }, "required": [ "id", "url", "name", "release_date" ] }, "title": { "type": "string" }, "artists": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "url": { "type": "string" }, "name": { "type": "string" } }, "required": [ "id", "url", "name" ] } }, "artwork": { "type": "string" }, "explicit": { "type": "boolean" }, "playable": { "type": "boolean" }, "position": { "type": "integer" }, "duration_ms": { "type": "integer" }, "preview_url": { "type": "string" }, "release_date": { "type": "string" }, "duration_formatted": { "type": "string" } }, "required": [ "id", "uri", "url", "album", "title", "artists", "artwork", "explicit", "playable", "position", "duration_ms", "preview_url", "release_date", "duration_formatted" ] } }, "artists": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "uri": { "type": "string" }, "url": { "type": "string" }, "name": { "type": "string" }, "image": { "type": "string" } }, "required": [ "id", "uri", "url", "name", "image" ] } }, "preview": { "type": "boolean" }, "episodes": { "type": "array", "items": {} }, "podcasts": { "type": "array", "items": {} }, "playlists": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "uri": { "type": "string" }, "url": { "type": "string" }, "name": { "type": "string" }, "owner": { "type": "object", "properties": { "id": { "type": "string" }, "url": { "type": "string" }, "name": { "type": "string" }, "avatar": { "type": "null" } }, "required": [ "id", "url", "name", "avatar" ] }, "cover_image": { "type": "string" }, "description": { "type": "string" }, "track_count": { "type": "null" } }, "required": [ "id", "uri", "url", "name", "owner", "cover_image", "description", "track_count" ] } }, "audiobooks": { "type": "array", "items": {} }, "retrieved_at": { "type": "string" } }, "required": [ "note", "type", "limit", "query", "users", "albums", "counts", "genres", "offset", "source", "totals", "tracks", "artists", "preview", "episodes", "podcasts", "playlists", "audiobooks", "retrieved_at" ] } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string", "example": "daft punk" }, "description": "Spotify search query" }, { "name": "type", "in": "query", "required": false, "schema": { "type": "string", "example": "all" }, "description": "Spotify result type: all, track, album, artist or playlist" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "example": 2 }, "description": "Maximum number of items to return" } ], "security": [] } }, "/api/v2/spotify/playlist": { "get": { "operationId": "get_api_v2_spotify_playlist", "tags": [ "spotify-api-v2" ], "summary": "Spotify playlist metadata and every ordered track. There is no song limit.", "description": "Spotify playlist metadata and every ordered track. There is no song limit. Price: $0.030000 USD per call on Base via x402. The live 402 challenge is the authoritative price.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.030000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "note": { "type": "string" }, "source": { "type": "string" }, "tracks": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "uri": { "type": "string" }, "url": { "type": "string" }, "album": { "type": "object", "properties": { "id": { "type": "string" }, "url": { "type": "string" }, "name": { "type": "string" }, "release_date": { "type": "string" } }, "required": [ "id", "url", "name", "release_date" ] }, "title": { "type": "string" }, "artists": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "url": { "type": "string" }, "name": { "type": "string" } }, "required": [ "id", "url", "name" ] } }, "artwork": { "type": "string" }, "explicit": { "type": "boolean" }, "playable": { "type": "boolean" }, "position": { "type": "integer" }, "duration_ms": { "type": "integer" }, "preview_url": { "type": "string" }, "release_date": { "type": "string" }, "duration_formatted": { "type": "string" } }, "required": [ "id", "uri", "url", "album", "title", "artists", "artwork", "explicit", "playable", "position", "duration_ms", "preview_url", "release_date", "duration_formatted" ] } }, "preview": { "type": "boolean" }, "summary": { "type": "object", "properties": { "duration_ms": { "type": "integer" }, "track_count": { "type": "integer" }, "unique_albums": { "type": "integer" }, "explicit_count": { "type": "integer" }, "unique_artists": { "type": "integer" }, "returned_tracks": { "type": "integer" }, "duration_formatted": { "type": "string" }, "average_track_duration_ms": { "type": "integer" } }, "required": [ "duration_ms", "track_count", "unique_albums", "explicit_count", "unique_artists", "returned_tracks", "duration_formatted", "average_track_duration_ms" ] }, "playlist": { "type": "object", "properties": { "id": { "type": "string" }, "uri": { "type": "string" }, "url": { "type": "string" }, "name": { "type": "string" }, "owner": { "type": "object", "properties": { "id": { "type": "string" }, "url": { "type": "string" }, "name": { "type": "string" }, "avatar": { "type": "string" } }, "required": [ "id", "url", "name", "avatar" ] }, "saves": { "type": "integer" }, "playable": { "type": "boolean" }, "cover_image": { "type": "string" }, "description": { "type": "string" }, "duration_ms": { "type": "integer" }, "track_count": { "type": "integer" }, "explicit_count": { "type": "integer" }, "duration_formatted": { "type": "string" } }, "required": [ "id", "uri", "url", "name", "owner", "saves", "playable", "cover_image", "description", "duration_ms", "track_count", "explicit_count", "duration_formatted" ] }, "retrieved_at": { "type": "string" }, "album_enrichment": { "type": "object", "properties": { "limit": { "type": "integer" }, "limited": { "type": "boolean" }, "requested": { "type": "boolean" }, "enriched_tracks": { "type": "integer" } }, "required": [ "limit", "limited", "requested", "enriched_tracks" ] } }, "required": [ "note", "source", "tracks", "preview", "summary", "playlist", "retrieved_at", "album_enrichment" ] } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string", "example": "https://open.spotify.com/playlist/37i9dQZF1DXcBWIGoYBM5M" }, "description": "Spotify URL, URI or 22-character id" }, { "name": "include_albums", "in": "query", "required": false, "schema": { "type": "boolean", "example": true }, "description": "Include album context on playlist tracks" }, { "name": "album_limit", "in": "query", "required": false, "schema": { "type": "integer", "example": 10 }, "description": "Maximum number of playlist tracks to enrich with album context" }, { "name": "id", "in": "query", "required": false, "schema": { "type": "string", "example": "37i9dQZF1DXcBWIGoYBM5M" }, "description": "22-character Spotify artist, album, track or playlist id" } ], "security": [] } }, "/api/v2/spotify/album": { "get": { "operationId": "get_api_v2_spotify_album", "tags": [ "spotify-api-v2" ], "summary": "Spotify album metadata and full track list.", "description": "Spotify album metadata and full track list. Price: $0.030000 USD per call on Base via x402. The live 402 challenge is the authoritative price.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.030000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "note": { "type": "string" }, "album": { "type": "object", "properties": { "id": { "type": "string" }, "uri": { "type": "string" }, "url": { "type": "string" }, "name": { "type": "string" }, "type": { "type": "string" }, "artists": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "url": { "type": "string" }, "name": { "type": "string" } }, "required": [ "id", "url", "name" ] } }, "playable": { "type": "boolean" }, "copyrights": { "type": "array", "items": { "type": "string" } }, "cover_image": { "type": "string" }, "duration_ms": { "type": "integer" }, "track_count": { "type": "integer" }, "release_date": { "type": "string" }, "explicit_count": { "type": "integer" }, "duration_formatted": { "type": "string" } }, "required": [ "id", "uri", "url", "name", "type", "artists", "playable", "copyrights", "cover_image", "duration_ms", "track_count", "release_date", "explicit_count", "duration_formatted" ] }, "source": { "type": "string" }, "tracks": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "uri": { "type": "string" }, "url": { "type": "string" }, "album": { "type": "object", "properties": { "id": { "type": "string" }, "url": { "type": "string" }, "name": { "type": "string" }, "release_date": { "type": "string" } }, "required": [ "id", "url", "name", "release_date" ] }, "title": { "type": "string" }, "artists": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "url": { "type": "string" }, "name": { "type": "string" } }, "required": [ "id", "url", "name" ] } }, "artwork": { "type": "string" }, "explicit": { "type": "boolean" }, "playable": { "type": "boolean" }, "position": { "type": "integer" }, "duration_ms": { "type": "integer" }, "preview_url": { "type": "string" }, "release_date": { "type": "string" }, "duration_formatted": { "type": "string" } }, "required": [ "id", "uri", "url", "album", "title", "artists", "artwork", "explicit", "playable", "position", "duration_ms", "preview_url", "release_date", "duration_formatted" ] } }, "preview": { "type": "boolean" }, "summary": { "type": "object", "properties": { "duration_ms": { "type": "integer" }, "track_count": { "type": "integer" }, "explicit_count": { "type": "integer" }, "unique_artists": { "type": "integer" }, "returned_tracks": { "type": "integer" }, "duration_formatted": { "type": "string" }, "average_track_duration_ms": { "type": "integer" } }, "required": [ "duration_ms", "track_count", "explicit_count", "unique_artists", "returned_tracks", "duration_formatted", "average_track_duration_ms" ] }, "retrieved_at": { "type": "string" } }, "required": [ "note", "album", "source", "tracks", "preview", "summary", "retrieved_at" ] } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string", "example": "https://open.spotify.com/album/5WulAOx9ilWy1h8UGZ1gkI" }, "description": "Spotify URL, URI or 22-character id" }, { "name": "id", "in": "query", "required": false, "schema": { "type": "string", "example": "5WulAOx9ilWy1h8UGZ1gkI" }, "description": "22-character Spotify artist, album, track or playlist id" } ], "security": [] } }, "/api/v2/spotify/artist": { "get": { "operationId": "get_api_v2_spotify_artist", "tags": [ "spotify-api-v2" ], "summary": "Spotify artist profile and top tracks.", "description": "Spotify artist profile and top tracks. Price: $0.030000 USD per call on Base via x402. The live 402 challenge is the authoritative price.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.030000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "note": { "type": "string" }, "artist": { "type": "object", "properties": { "id": { "type": "string" }, "bio": { "type": "string" }, "uri": { "type": "string" }, "url": { "type": "string" }, "name": { "type": "string" }, "image": { "type": "string" }, "followers": { "type": "integer" }, "world_rank": { "type": "integer" }, "monthly_listeners": { "type": "integer" } }, "required": [ "id", "bio", "uri", "url", "name", "image", "followers", "world_rank", "monthly_listeners" ] }, "source": { "type": "string" }, "preview": { "type": "boolean" }, "summary": { "type": "object", "properties": { "top_tracks": { "type": "integer" }, "duration_ms": { "type": "integer" }, "explicit_count": { "type": "integer" }, "unique_artists": { "type": "integer" }, "duration_formatted": { "type": "string" } }, "required": [ "top_tracks", "duration_ms", "explicit_count", "unique_artists", "duration_formatted" ] }, "top_tracks": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "uri": { "type": "string" }, "url": { "type": "string" }, "album": { "type": "object", "properties": { "id": { "type": "string" }, "url": { "type": "string" }, "name": { "type": "string" }, "release_date": { "type": "string" } }, "required": [ "id", "url", "name", "release_date" ] }, "title": { "type": "string" }, "artists": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "url": { "type": "string" }, "name": { "type": "string" } }, "required": [ "id", "url", "name" ] } }, "artwork": { "type": "string" }, "explicit": { "type": "boolean" }, "playable": { "type": "boolean" }, "position": { "type": "integer" }, "duration_ms": { "type": "integer" }, "preview_url": { "type": "string" }, "release_date": { "type": "string" }, "duration_formatted": { "type": "string" } }, "required": [ "id", "uri", "url", "album", "title", "artists", "artwork", "explicit", "playable", "position", "duration_ms", "preview_url", "release_date", "duration_formatted" ] } }, "retrieved_at": { "type": "string" } }, "required": [ "note", "artist", "source", "preview", "summary", "top_tracks", "retrieved_at" ] } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string", "example": "https://open.spotify.com/artist/5INjqkS1o8h1imAzPqGZBb" }, "description": "Spotify URL, URI or 22-character id" }, { "name": "id", "in": "query", "required": false, "schema": { "type": "string", "example": "5INjqkS1o8h1imAzPqGZBb" }, "description": "22-character Spotify artist, album, track or playlist id" } ], "security": [] } }, "/api/v2/spotify/artist/top-tracks": { "get": { "operationId": "get_api_v2_spotify_artist_top_tracks", "tags": [ "spotify-api-v2" ], "summary": "Spotify artist top tracks with album context.", "description": "Spotify artist top tracks with album context. Price: $0.030000 USD per call on Base via x402. The live 402 challenge is the authoritative price.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.030000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "note": { "type": "string" }, "artist": { "type": "object", "properties": { "id": { "type": "string" }, "bio": { "type": "string" }, "uri": { "type": "string" }, "url": { "type": "string" }, "name": { "type": "string" }, "image": { "type": "string" }, "followers": { "type": "integer" }, "world_rank": { "type": "integer" }, "monthly_listeners": { "type": "integer" } }, "required": [ "id", "bio", "uri", "url", "name", "image", "followers", "world_rank", "monthly_listeners" ] }, "source": { "type": "string" }, "preview": { "type": "boolean" }, "summary": { "type": "object", "properties": { "duration_ms": { "type": "integer" }, "explicit_count": { "type": "integer" }, "unique_artists": { "type": "integer" }, "requested_limit": { "type": "integer" }, "returned_tracks": { "type": "integer" }, "duration_formatted": { "type": "string" }, "available_top_tracks": { "type": "integer" } }, "required": [ "duration_ms", "explicit_count", "unique_artists", "requested_limit", "returned_tracks", "duration_formatted", "available_top_tracks" ] }, "top_tracks": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "uri": { "type": "string" }, "url": { "type": "string" }, "album": { "type": "object", "properties": { "id": { "type": "string" }, "url": { "type": "string" }, "name": { "type": "string" }, "release_date": { "type": "string" } }, "required": [ "id", "url", "name", "release_date" ] }, "title": { "type": "string" }, "artists": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "url": { "type": "string" }, "name": { "type": "string" } }, "required": [ "id", "url", "name" ] } }, "artwork": { "type": "string" }, "explicit": { "type": "boolean" }, "playable": { "type": "boolean" }, "position": { "type": "integer" }, "duration_ms": { "type": "integer" }, "preview_url": { "type": "string" }, "release_date": { "type": "string" }, "duration_formatted": { "type": "string" } }, "required": [ "id", "uri", "url", "album", "title", "artists", "artwork", "explicit", "playable", "position", "duration_ms", "preview_url", "release_date", "duration_formatted" ] } }, "retrieved_at": { "type": "string" } }, "required": [ "note", "artist", "source", "preview", "summary", "top_tracks", "retrieved_at" ] } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string", "example": "https://open.spotify.com/artist/5INjqkS1o8h1imAzPqGZBb" }, "description": "Spotify URL, URI or 22-character id" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "example": 2 }, "description": "Maximum number of items to return" }, { "name": "id", "in": "query", "required": false, "schema": { "type": "string", "example": "5INjqkS1o8h1imAzPqGZBb" }, "description": "22-character Spotify artist, album, track or playlist id" } ], "security": [] } }, "/api/v2/spotify/artist/discography": { "get": { "operationId": "get_api_v2_spotify_artist_discography", "tags": [ "spotify-api-v2" ], "summary": "Spotify artist discography with complete release sections. The example response is abbreviated; the live route returns all albums, singles and EPs by default.", "description": "Spotify artist discography with complete release sections. The example response is abbreviated; the live route returns all albums, singles and EPs by default. Price: $0.030000 USD per call on Base via x402. The live 402 challenge is the authoritative price.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.030000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "note": { "type": "string" }, "artist": { "type": "object", "properties": { "id": { "type": "string" }, "bio": { "type": "string" }, "uri": { "type": "string" }, "url": { "type": "string" }, "name": { "type": "string" }, "image": { "type": "string" }, "followers": { "type": "integer" }, "world_rank": { "type": "integer" }, "monthly_listeners": { "type": "integer" } }, "required": [ "id", "bio", "uri", "url", "name", "image", "followers", "world_rank", "monthly_listeners" ] }, "source": { "type": "string" }, "preview": { "type": "boolean" }, "summary": { "type": "object", "properties": { "scope": { "type": "string" }, "albums": { "type": "integer" }, "complete": { "type": "boolean" }, "appears_on": { "type": "integer" }, "total_releases": { "type": "integer" }, "singles_and_eps": { "type": "integer" }, "appears_on_total": { "type": "integer" }, "popular_releases": { "type": "integer" }, "appears_on_complete": { "type": "boolean" } }, "required": [ "scope", "albums", "complete", "appears_on", "total_releases", "singles_and_eps", "appears_on_total", "popular_releases", "appears_on_complete" ] }, "sections": { "type": "object", "properties": { "albums": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "uri": { "type": "string" }, "url": { "type": "string" }, "type": { "type": "string" }, "year": { "type": "integer" }, "title": { "type": "string" }, "section": { "type": "string" }, "position": { "type": "integer" }, "cover_image": { "type": "string" }, "release_date": { "type": "string" } }, "required": [ "id", "uri", "url", "type", "year", "title", "section", "position", "cover_image", "release_date" ] } }, "appears_on": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "uri": { "type": "string" }, "url": { "type": "string" }, "type": { "type": "string" }, "year": { "type": "integer" }, "title": { "type": "string" }, "section": { "type": "string" }, "position": { "type": "integer" }, "cover_image": { "type": "string" }, "release_date": { "type": "string" } }, "required": [ "id", "uri", "url", "type", "year", "title", "section", "position", "cover_image", "release_date" ] } }, "singles_and_eps": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "uri": { "type": "string" }, "url": { "type": "string" }, "type": { "type": "string" }, "year": { "type": "integer" }, "title": { "type": "string" }, "section": { "type": "string" }, "position": { "type": "integer" }, "cover_image": { "type": "string" }, "release_date": { "type": "string" } }, "required": [ "id", "uri", "url", "type", "year", "title", "section", "position", "cover_image", "release_date" ] } }, "popular_releases": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "uri": { "type": "string" }, "url": { "type": "string" }, "type": { "type": "string" }, "year": { "type": "integer" }, "title": { "type": "string" }, "section": { "type": "string" }, "position": { "type": "integer" }, "cover_image": { "type": "string" }, "release_date": { "type": "string" } }, "required": [ "id", "uri", "url", "type", "year", "title", "section", "position", "cover_image", "release_date" ] } } }, "required": [ "albums", "appears_on", "singles_and_eps", "popular_releases" ] }, "retrieved_at": { "type": "string" } }, "required": [ "note", "artist", "source", "preview", "summary", "sections", "retrieved_at" ] } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string", "example": "https://open.spotify.com/artist/5INjqkS1o8h1imAzPqGZBb" }, "description": "Spotify URL, URI or 22-character id" }, { "name": "id", "in": "query", "required": false, "schema": { "type": "string", "example": "5INjqkS1o8h1imAzPqGZBb" }, "description": "22-character Spotify artist, album, track or playlist id" } ], "security": [] } }, "/api/v2/spotify/track": { "get": { "operationId": "get_api_v2_spotify_track", "tags": [ "spotify-api-v2" ], "summary": "Spotify track metadata.", "description": "Spotify track metadata. Price: $0.030000 USD per call on Base via x402. The live 402 challenge is the authoritative price.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.030000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "note": { "type": "string" }, "track": { "type": "object", "properties": { "id": { "type": "string" }, "uri": { "type": "string" }, "url": { "type": "string" }, "album": { "type": "object", "properties": { "id": { "type": "string" }, "url": { "type": "string" }, "name": { "type": "string" }, "release_date": { "type": "string" } }, "required": [ "id", "url", "name", "release_date" ] }, "title": { "type": "string" }, "artists": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "url": { "type": "string" }, "name": { "type": "string" } }, "required": [ "id", "url", "name" ] } }, "artwork": { "type": "string" }, "explicit": { "type": "boolean" }, "playable": { "type": "boolean" }, "copyrights": { "type": "array", "items": { "type": "string" } }, "duration_ms": { "type": "integer" }, "preview_url": { "type": "string" }, "release_date": { "type": "string" }, "duration_formatted": { "type": "string" } }, "required": [ "id", "uri", "url", "album", "title", "artists", "artwork", "explicit", "playable", "copyrights", "duration_ms", "preview_url", "release_date", "duration_formatted" ] }, "source": { "type": "string" }, "preview": { "type": "boolean" }, "retrieved_at": { "type": "string" } }, "required": [ "note", "track", "source", "preview", "retrieved_at" ] } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string", "example": "https://open.spotify.com/track/4whkhyXTrTgHKZzkUvdwoq" }, "description": "Spotify URL, URI or 22-character id" }, { "name": "id", "in": "query", "required": false, "schema": { "type": "string", "example": "4whkhyXTrTgHKZzkUvdwoq" }, "description": "22-character Spotify artist, album, track or playlist id" } ], "security": [] } }, "/api/v2/spotify/podcast": { "get": { "operationId": "get_api_v2_spotify_podcast", "tags": [ "spotify-api-v2" ], "summary": "Spotify podcast metadata from a podcast link.", "description": "Spotify podcast metadata from a podcast link. Price: $0.030000 USD per call on Base via x402. The live 402 challenge is the authoritative price.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.030000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "note": { "type": "string" }, "source": { "type": "string" }, "podcast": { "type": "object", "properties": { "id": { "type": "string" }, "uri": { "type": "string" }, "url": { "type": "string" }, "name": { "type": "string" }, "rating": { "type": "object", "properties": { "total": { "type": "integer" }, "average": { "type": "number" } }, "required": [ "total", "average" ] }, "topics": { "type": "array", "items": { "type": "string" } }, "explicit": { "type": "boolean" }, "playable": { "type": "boolean" }, "publisher": { "type": "string" }, "media_type": { "type": "string" }, "cover_image": { "type": "string" }, "description": { "type": "string" }, "total_episodes": { "type": "integer" } }, "required": [ "id", "uri", "url", "name", "rating", "topics", "explicit", "playable", "publisher", "media_type", "cover_image", "description", "total_episodes" ] }, "preview": { "type": "boolean" }, "retrieved_at": { "type": "string" } }, "required": [ "note", "source", "podcast", "preview", "retrieved_at" ] } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "id", "in": "query", "required": false, "schema": { "type": "string", "example": "79CkJF3UJTHFV8Dse3Oy0P" }, "description": "22-character Spotify artist, album, track or playlist id" }, { "name": "url", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Spotify URL, URI or 22-character id" } ], "security": [] } }, "/api/v2/spotify/podcast/episodes": { "get": { "operationId": "get_api_v2_spotify_podcast_episodes", "tags": [ "spotify-api-v2" ], "summary": "Spotify podcast episodes with limit and offset.", "description": "Spotify podcast episodes with limit and offset. Price: $0.030000 USD per call on Base via x402. The live 402 challenge is the authoritative price.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.030000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "note": { "type": "string" }, "limit": { "type": "integer" }, "total": { "type": "integer" }, "offset": { "type": "integer" }, "source": { "type": "string" }, "podcast": { "type": "object", "properties": { "id": { "type": "string" }, "uri": { "type": "string" }, "url": { "type": "string" }, "name": { "type": "string" }, "cover_image": { "type": "string" } }, "required": [ "id", "uri", "url", "name", "cover_image" ] }, "preview": { "type": "boolean" }, "episodes": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "uri": { "type": "string" }, "url": { "type": "string" }, "title": { "type": "string" }, "artwork": { "type": "string" }, "podcast": { "type": "object", "properties": { "id": { "type": "string" }, "url": { "type": "string" }, "name": { "type": "string" } }, "required": [ "id", "url", "name" ] }, "explicit": { "type": "boolean" }, "playable": { "type": "boolean" }, "description": { "type": "string" }, "duration_ms": { "type": "integer" }, "media_types": { "type": "array", "items": { "type": "string" } }, "preview_url": { "type": "string" }, "release_date": { "type": "string" }, "duration_formatted": { "type": "string" } }, "required": [ "id", "uri", "url", "title", "artwork", "podcast", "explicit", "playable", "description", "duration_ms", "media_types", "preview_url", "release_date", "duration_formatted" ] } }, "retrieved_at": { "type": "string" } }, "required": [ "note", "limit", "total", "offset", "source", "podcast", "preview", "episodes", "retrieved_at" ] } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "id", "in": "query", "required": false, "schema": { "type": "string", "example": "79CkJF3UJTHFV8Dse3Oy0P" }, "description": "22-character Spotify artist, album, track or playlist id" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "example": 2 }, "description": "Maximum number of items to return" }, { "name": "url", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Spotify URL, URI or 22-character id" } ], "security": [] } }, "/api/v2/spotify/episode": { "get": { "operationId": "get_api_v2_spotify_episode", "tags": [ "spotify-api-v2" ], "summary": "Spotify episode metadata from an episode link.", "description": "Spotify episode metadata from an episode link. Price: $0.030000 USD per call on Base via x402. The live 402 challenge is the authoritative price.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.030000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "note": { "type": "string" }, "source": { "type": "string" }, "episode": { "type": "object", "properties": { "id": { "type": "string" }, "uri": { "type": "string" }, "url": { "type": "string" }, "title": { "type": "string" }, "artwork": { "type": "string" }, "podcast": { "type": "object", "properties": { "id": { "type": "string" }, "url": { "type": "string" }, "name": { "type": "string" } }, "required": [ "id", "url", "name" ] }, "explicit": { "type": "boolean" }, "playable": { "type": "boolean" }, "description": { "type": "string" }, "duration_ms": { "type": "integer" }, "media_types": { "type": "array", "items": { "type": "string" } }, "preview_url": { "type": "string" }, "release_date": { "type": "string" }, "duration_formatted": { "type": "string" } }, "required": [ "id", "uri", "url", "title", "artwork", "podcast", "explicit", "playable", "description", "duration_ms", "media_types", "preview_url", "release_date", "duration_formatted" ] }, "preview": { "type": "boolean" }, "retrieved_at": { "type": "string" } }, "required": [ "note", "source", "episode", "preview", "retrieved_at" ] } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "id", "in": "query", "required": false, "schema": { "type": "string", "example": "2jMJRxwPQPErrwRGo8duQQ" }, "description": "22-character Spotify artist, album, track or playlist id" }, { "name": "url", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Spotify URL, URI or 22-character id" } ], "security": [] } }, "/api/v2/spotify/audiobook": { "get": { "operationId": "get_api_v2_spotify_audiobook", "tags": [ "spotify-api-v2" ], "summary": "Spotify audiobook metadata from an audiobook link.", "description": "Spotify audiobook metadata from an audiobook link. Price: $0.030000 USD per call on Base via x402. The live 402 challenge is the authoritative price.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.030000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "note": { "type": "string" }, "source": { "type": "string" }, "preview": { "type": "boolean" }, "audiobook": { "type": "object", "properties": { "id": { "type": "string" }, "uri": { "type": "string" }, "url": { "type": "string" }, "price": { "type": "object", "properties": { "amount": { "type": "number" }, "currency": { "type": "string" }, "formatted": { "type": "string" } }, "required": [ "amount", "currency", "formatted" ] }, "title": { "type": "string" }, "rating": { "type": "object", "properties": { "total": { "type": "integer" }, "average": { "type": "number" } }, "required": [ "total", "average" ] }, "authors": { "type": "array", "items": { "type": "string" } }, "explicit": { "type": "boolean" }, "language": { "type": "string" }, "playable": { "type": "boolean" }, "narrators": { "type": "array", "items": { "type": "string" } }, "publisher": { "type": "string" }, "cover_image": { "type": "string" }, "description": { "type": "string" }, "duration_ms": { "type": "integer" }, "release_date": { "type": "string" }, "chapters_count": { "type": "integer" }, "duration_formatted": { "type": "string" } }, "required": [ "id", "uri", "url", "price", "title", "rating", "authors", "explicit", "language", "playable", "narrators", "publisher", "cover_image", "description", "duration_ms", "release_date", "chapters_count", "duration_formatted" ] }, "retrieved_at": { "type": "string" } }, "required": [ "note", "source", "preview", "audiobook", "retrieved_at" ] } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "id", "in": "query", "required": false, "schema": { "type": "string", "example": "0Db3QPOPFO0SYx0TGG0mim" }, "description": "22-character Spotify artist, album, track or playlist id" }, { "name": "url", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Spotify URL, URI or 22-character id" } ], "security": [] } }, "/api/v2/spotify/audiobook/chapters": { "get": { "operationId": "get_api_v2_spotify_audiobook_chapters", "tags": [ "spotify-api-v2" ], "summary": "Spotify audiobook chapters with limit and offset.", "description": "Spotify audiobook chapters with limit and offset. Price: $0.030000 USD per call on Base via x402. The live 402 challenge is the authoritative price.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.030000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "note": { "type": "string" }, "limit": { "type": "integer" }, "total": { "type": "integer" }, "offset": { "type": "integer" }, "source": { "type": "string" }, "preview": { "type": "boolean" }, "chapters": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "uri": { "type": "string" }, "url": { "type": "string" }, "title": { "type": "string" }, "artwork": { "type": "string" }, "explicit": { "type": "boolean" }, "playable": { "type": "boolean" }, "position": { "type": "integer" }, "audiobook": { "type": "object", "properties": { "id": { "type": "string" }, "url": { "type": "string" }, "title": { "type": "string" } }, "required": [ "id", "url", "title" ] }, "description": { "type": "string" }, "duration_ms": { "type": "integer" }, "preview_url": { "type": "null" }, "duration_formatted": { "type": "string" } }, "required": [ "id", "uri", "url", "title", "artwork", "explicit", "playable", "position", "audiobook", "description", "duration_ms", "preview_url", "duration_formatted" ] } }, "audiobook": { "type": "object", "properties": { "id": { "type": "string" }, "uri": { "type": "string" }, "url": { "type": "string" }, "title": { "type": "string" }, "cover_image": { "type": "string" } }, "required": [ "id", "uri", "url", "title", "cover_image" ] }, "retrieved_at": { "type": "string" } }, "required": [ "note", "limit", "total", "offset", "source", "preview", "chapters", "audiobook", "retrieved_at" ] } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "id", "in": "query", "required": false, "schema": { "type": "string", "example": "0Db3QPOPFO0SYx0TGG0mim" }, "description": "22-character Spotify artist, album, track or playlist id" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "example": 2 }, "description": "Maximum number of items to return" }, { "name": "url", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Spotify URL, URI or 22-character id" } ], "security": [] } }, "/api/v2/spotify/genres": { "get": { "operationId": "get_api_v2_spotify_genres", "tags": [ "spotify-api-v2" ], "summary": "Search Spotify genres by keyword.", "description": "Search Spotify genres by keyword. Price: $0.030000 USD per call on Base via x402. The live 402 challenge is the authoritative price.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.030000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "note": { "type": "string" }, "query": { "type": "string" }, "total": { "type": "integer" }, "genres": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "uri": { "type": "string" }, "name": { "type": "string" }, "image": { "type": "string" } }, "required": [ "id", "uri", "name", "image" ] } }, "source": { "type": "string" }, "preview": { "type": "boolean" }, "retrieved_at": { "type": "string" } }, "required": [ "note", "query", "total", "genres", "source", "preview", "retrieved_at" ] } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string", "example": "pop" }, "description": "Spotify search query" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "example": 2 }, "description": "Maximum number of items to return" }, { "name": "url", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Spotify URL, URI or 22-character id" }, { "name": "id", "in": "query", "required": false, "schema": { "type": "string" }, "description": "22-character Spotify artist, album, track or playlist id" } ], "security": [] } }, "/api/v2/spotify/user": { "get": { "operationId": "get_api_v2_spotify_user", "tags": [ "spotify-api-v2" ], "summary": "Spotify public user profile and public playlists.", "description": "Spotify public user profile and public playlists. Price: $0.030000 USD per call on Base via x402. The live 402 challenge is the authoritative price.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.030000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "note": { "type": "string" }, "user": { "type": "object", "properties": { "id": { "type": "string" }, "uri": { "type": "string" }, "url": { "type": "string" }, "image": { "type": "string" }, "username": { "type": "string" }, "display_name": { "type": "string" }, "playlists_count": { "type": "integer" }, "public_playlists": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "uri": { "type": "string" }, "url": { "type": "string" }, "name": { "type": "string" }, "followers": { "type": "integer" }, "cover_image": { "type": "null" } }, "required": [ "id", "uri", "url", "name", "followers", "cover_image" ] } } }, "required": [ "id", "uri", "url", "image", "username", "display_name", "playlists_count", "public_playlists" ] }, "source": { "type": "string" }, "preview": { "type": "boolean" }, "retrieved_at": { "type": "string" } }, "required": [ "note", "user", "source", "preview", "retrieved_at" ] } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "id", "in": "query", "required": false, "schema": { "type": "string", "example": "spotify" }, "description": "22-character Spotify artist, album, track or playlist id" }, { "name": "url", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Spotify URL, URI or 22-character id" } ], "security": [] } }, "/api/v2/spotify/search/podcasts": { "get": { "operationId": "get_api_v2_spotify_search_podcasts", "tags": [ "spotify-api-v2" ], "summary": "Search Spotify podcasts by keyword.", "description": "Search Spotify podcasts by keyword. Price: $0.030000 USD per call on Base via x402. The live 402 challenge is the authoritative price.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.030000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "note": { "type": "string" }, "type": { "type": "string" }, "limit": { "type": "integer" }, "query": { "type": "string" }, "total": { "type": "integer" }, "offset": { "type": "integer" }, "source": { "type": "string" }, "preview": { "type": "boolean" }, "podcasts": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "uri": { "type": "string" }, "url": { "type": "string" }, "name": { "type": "string" }, "publisher": { "type": "string" }, "media_type": { "type": "string" }, "cover_image": { "type": "string" } }, "required": [ "id", "uri", "url", "name", "publisher", "media_type", "cover_image" ] } }, "retrieved_at": { "type": "string" } }, "required": [ "note", "type", "limit", "query", "total", "offset", "source", "preview", "podcasts", "retrieved_at" ] } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string", "example": "huberman" }, "description": "Spotify search query" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "example": 1 }, "description": "Maximum number of items to return" }, { "name": "url", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Spotify URL, URI or 22-character id" }, { "name": "id", "in": "query", "required": false, "schema": { "type": "string" }, "description": "22-character Spotify artist, album, track or playlist id" } ], "security": [] } }, "/api/v2/spotify/search/episodes": { "get": { "operationId": "get_api_v2_spotify_search_episodes", "tags": [ "spotify-api-v2" ], "summary": "Search Spotify podcast episodes by keyword.", "description": "Search Spotify podcast episodes by keyword. Price: $0.030000 USD per call on Base via x402. The live 402 challenge is the authoritative price.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.030000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "note": { "type": "string" }, "type": { "type": "string" }, "limit": { "type": "integer" }, "query": { "type": "string" }, "total": { "type": "integer" }, "offset": { "type": "integer" }, "source": { "type": "string" }, "preview": { "type": "boolean" }, "episodes": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "uri": { "type": "string" }, "url": { "type": "string" }, "title": { "type": "string" }, "artwork": { "type": "string" }, "podcast": { "type": "object", "properties": { "id": { "type": "string" }, "url": { "type": "string" }, "name": { "type": "string" } }, "required": [ "id", "url", "name" ] }, "explicit": { "type": "boolean" }, "playable": { "type": "boolean" }, "description": { "type": "string" }, "duration_ms": { "type": "integer" }, "release_date": { "type": "string" }, "duration_formatted": { "type": "string" } }, "required": [ "id", "uri", "url", "title", "artwork", "podcast", "explicit", "playable", "description", "duration_ms", "release_date", "duration_formatted" ] } }, "retrieved_at": { "type": "string" } }, "required": [ "note", "type", "limit", "query", "total", "offset", "source", "preview", "episodes", "retrieved_at" ] } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string", "example": "dopamine" }, "description": "Spotify search query" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "example": 1 }, "description": "Maximum number of items to return" }, { "name": "url", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Spotify URL, URI or 22-character id" }, { "name": "id", "in": "query", "required": false, "schema": { "type": "string" }, "description": "22-character Spotify artist, album, track or playlist id" } ], "security": [] } }, "/api/v2/spotify/search/audiobooks": { "get": { "operationId": "get_api_v2_spotify_search_audiobooks", "tags": [ "spotify-api-v2" ], "summary": "Search Spotify audiobooks by keyword.", "description": "Search Spotify audiobooks by keyword. Price: $0.030000 USD per call on Base via x402. The live 402 challenge is the authoritative price.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.030000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "note": { "type": "string" }, "type": { "type": "string" }, "limit": { "type": "integer" }, "query": { "type": "string" }, "total": { "type": "integer" }, "offset": { "type": "integer" }, "source": { "type": "string" }, "preview": { "type": "boolean" }, "audiobooks": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "uri": { "type": "string" }, "url": { "type": "string" }, "title": { "type": "string" }, "authors": { "type": "array", "items": { "type": "string" } }, "cover_image": { "type": "string" }, "description": { "type": "string" }, "release_date": { "type": "string" } }, "required": [ "id", "uri", "url", "title", "authors", "cover_image", "description", "release_date" ] } }, "retrieved_at": { "type": "string" } }, "required": [ "note", "type", "limit", "query", "total", "offset", "source", "preview", "audiobooks", "retrieved_at" ] } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string", "example": "atomic habits" }, "description": "Spotify search query" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "example": 1 }, "description": "Maximum number of items to return" }, { "name": "url", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Spotify URL, URI or 22-character id" }, { "name": "id", "in": "query", "required": false, "schema": { "type": "string" }, "description": "22-character Spotify artist, album, track or playlist id" } ], "security": [] } }, "/api/v2/spotify/search/users": { "get": { "operationId": "get_api_v2_spotify_search_users", "tags": [ "spotify-api-v2" ], "summary": "Search Spotify public user profiles by keyword.", "description": "Search Spotify public user profiles by keyword. Price: $0.030000 USD per call on Base via x402. The live 402 challenge is the authoritative price.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.030000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "note": { "type": "string" }, "type": { "type": "string" }, "limit": { "type": "integer" }, "query": { "type": "string" }, "total": { "type": "integer" }, "users": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "uri": { "type": "string" }, "url": { "type": "string" }, "image": { "type": "string" }, "username": { "type": "string" }, "display_name": { "type": "string" } }, "required": [ "id", "uri", "url", "image", "username", "display_name" ] } }, "offset": { "type": "integer" }, "source": { "type": "string" }, "preview": { "type": "boolean" }, "retrieved_at": { "type": "string" } }, "required": [ "note", "type", "limit", "query", "total", "users", "offset", "source", "preview", "retrieved_at" ] } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string", "example": "huberman" }, "description": "Spotify search query" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "example": 1 }, "description": "Maximum number of items to return" }, { "name": "url", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Spotify URL, URI or 22-character id" }, { "name": "id", "in": "query", "required": false, "schema": { "type": "string" }, "description": "22-character Spotify artist, album, track or playlist id" } ], "security": [] } }, "/api/v2/spotify/artist/playlists": { "get": { "operationId": "get_api_v2_spotify_artist_playlists", "tags": [ "spotify-api-v2" ], "summary": "Spotify playlists owned by or associated with an artist.", "description": "Spotify playlists owned by or associated with an artist. Price: $0.030000 USD per call on Base via x402. The live 402 challenge is the authoritative price.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.030000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "note": { "type": "string" }, "total": { "type": "integer" }, "artist": { "type": "object", "properties": { "id": { "type": "string" }, "uri": { "type": "string" }, "url": { "type": "string" }, "name": { "type": "string" } }, "required": [ "id", "uri", "url", "name" ] }, "source": { "type": "string" }, "preview": { "type": "boolean" }, "complete": { "type": "boolean" }, "returned": { "type": "integer" }, "playlists": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "uri": { "type": "string" }, "url": { "type": "string" }, "name": { "type": "string" }, "owner": { "type": "object", "properties": { "url": { "type": "null" }, "name": { "type": "string" } }, "required": [ "url", "name" ] }, "followers": { "type": "null" }, "cover_image": { "type": "string" }, "description": { "type": "string" } }, "required": [ "id", "uri", "url", "name", "owner", "followers", "cover_image", "description" ] } }, "retrieved_at": { "type": "string" } }, "required": [ "note", "total", "artist", "source", "preview", "complete", "returned", "playlists", "retrieved_at" ] } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string", "example": "https://open.spotify.com/artist/5INjqkS1o8h1imAzPqGZBb" }, "description": "Spotify URL, URI or 22-character id" }, { "name": "id", "in": "query", "required": false, "schema": { "type": "string", "example": "5INjqkS1o8h1imAzPqGZBb" }, "description": "22-character Spotify artist, album, track or playlist id" } ], "security": [] } }, "/api/v2/spotify/artist/related": { "get": { "operationId": "get_api_v2_spotify_artist_related", "tags": [ "spotify-api-v2" ], "summary": "Spotify related artists for an artist.", "description": "Spotify related artists for an artist. Price: $0.030000 USD per call on Base via x402. The live 402 challenge is the authoritative price.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.030000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "note": { "type": "string" }, "total": { "type": "integer" }, "artist": { "type": "object", "properties": { "id": { "type": "string" }, "uri": { "type": "string" }, "url": { "type": "string" }, "name": { "type": "string" } }, "required": [ "id", "uri", "url", "name" ] }, "source": { "type": "string" }, "artists": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "uri": { "type": "string" }, "url": { "type": "string" }, "name": { "type": "string" }, "image": { "type": "string" } }, "required": [ "id", "uri", "url", "name", "image" ] } }, "preview": { "type": "boolean" }, "complete": { "type": "boolean" }, "returned": { "type": "integer" }, "retrieved_at": { "type": "string" } }, "required": [ "note", "total", "artist", "source", "artists", "preview", "complete", "returned", "retrieved_at" ] } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string", "example": "https://open.spotify.com/artist/5INjqkS1o8h1imAzPqGZBb" }, "description": "Spotify URL, URI or 22-character id" }, { "name": "id", "in": "query", "required": false, "schema": { "type": "string", "example": "5INjqkS1o8h1imAzPqGZBb" }, "description": "22-character Spotify artist, album, track or playlist id" } ], "security": [] } }, "/api/v2/spotify/artist/discovered-on": { "get": { "operationId": "get_api_v2_spotify_artist_discovered_on", "tags": [ "spotify-api-v2" ], "summary": "Spotify playlists that surface an artist.", "description": "Spotify playlists that surface an artist. Price: $0.030000 USD per call on Base via x402. The live 402 challenge is the authoritative price.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.030000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "note": { "type": "string" }, "total": { "type": "integer" }, "artist": { "type": "object", "properties": { "id": { "type": "string" }, "uri": { "type": "string" }, "url": { "type": "string" }, "name": { "type": "string" } }, "required": [ "id", "uri", "url", "name" ] }, "source": { "type": "string" }, "preview": { "type": "boolean" }, "complete": { "type": "boolean" }, "returned": { "type": "integer" }, "playlists": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "uri": { "type": "string" }, "url": { "type": "string" }, "name": { "type": "string" }, "owner": { "type": "object", "properties": { "url": { "type": "null" }, "name": { "type": "string" } }, "required": [ "url", "name" ] }, "followers": { "type": "null" }, "cover_image": { "type": "string" }, "description": { "type": "string" } }, "required": [ "id", "uri", "url", "name", "owner", "followers", "cover_image", "description" ] } }, "retrieved_at": { "type": "string" } }, "required": [ "note", "total", "artist", "source", "preview", "complete", "returned", "playlists", "retrieved_at" ] } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string", "example": "https://open.spotify.com/artist/5INjqkS1o8h1imAzPqGZBb" }, "description": "Spotify URL, URI or 22-character id" }, { "name": "id", "in": "query", "required": false, "schema": { "type": "string", "example": "5INjqkS1o8h1imAzPqGZBb" }, "description": "22-character Spotify artist, album, track or playlist id" } ], "security": [] } }, "/api/v2/spotify/artist/featuring": { "get": { "operationId": "get_api_v2_spotify_artist_featuring", "tags": [ "spotify-api-v2" ], "summary": "Spotify playlists featuring an artist.", "description": "Spotify playlists featuring an artist. Price: $0.030000 USD per call on Base via x402. The live 402 challenge is the authoritative price.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.030000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "note": { "type": "string" }, "total": { "type": "integer" }, "artist": { "type": "object", "properties": { "id": { "type": "string" }, "uri": { "type": "string" }, "url": { "type": "string" }, "name": { "type": "string" } }, "required": [ "id", "uri", "url", "name" ] }, "source": { "type": "string" }, "preview": { "type": "boolean" }, "complete": { "type": "boolean" }, "returned": { "type": "integer" }, "playlists": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "uri": { "type": "string" }, "url": { "type": "string" }, "name": { "type": "string" }, "owner": { "type": "object", "properties": { "url": { "type": "null" }, "name": { "type": "string" } }, "required": [ "url", "name" ] }, "followers": { "type": "null" }, "cover_image": { "type": "string" }, "description": { "type": "string" } }, "required": [ "id", "uri", "url", "name", "owner", "followers", "cover_image", "description" ] } }, "retrieved_at": { "type": "string" } }, "required": [ "note", "total", "artist", "source", "preview", "complete", "returned", "playlists", "retrieved_at" ] } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string", "example": "https://open.spotify.com/artist/5INjqkS1o8h1imAzPqGZBb" }, "description": "Spotify URL, URI or 22-character id" }, { "name": "id", "in": "query", "required": false, "schema": { "type": "string", "example": "5INjqkS1o8h1imAzPqGZBb" }, "description": "22-character Spotify artist, album, track or playlist id" } ], "security": [] } }, "/api/v2/spotify/track/similar-albums": { "get": { "operationId": "get_api_v2_spotify_track_similar_albums", "tags": [ "spotify-api-v2" ], "summary": "Spotify albums similar to a track.", "description": "Spotify albums similar to a track. Price: $0.030000 USD per call on Base via x402. The live 402 challenge is the authoritative price.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.030000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "note": { "type": "string" }, "total": { "type": "integer" }, "track": { "type": "object", "properties": { "id": { "type": "string" }, "uri": { "type": "string" }, "url": { "type": "string" } }, "required": [ "id", "uri", "url" ] }, "albums": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "uri": { "type": "string" }, "url": { "type": "string" }, "name": { "type": "string" }, "type": { "type": "string" }, "artists": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "url": { "type": "string" }, "name": { "type": "string" } }, "required": [ "id", "url", "name" ] } }, "cover_image": { "type": "string" }, "track_count": { "type": "integer" }, "release_date": { "type": "string" } }, "required": [ "id", "uri", "url", "name", "type", "artists", "cover_image", "track_count", "release_date" ] } }, "source": { "type": "string" }, "preview": { "type": "boolean" }, "complete": { "type": "boolean" }, "returned": { "type": "integer" }, "retrieved_at": { "type": "string" } }, "required": [ "note", "total", "track", "albums", "source", "preview", "complete", "returned", "retrieved_at" ] } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string", "example": "https://open.spotify.com/track/4whkhyXTrTgHKZzkUvdwoq" }, "description": "Spotify URL, URI or 22-character id" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "example": 2 }, "description": "Maximum number of items to return" }, { "name": "id", "in": "query", "required": false, "schema": { "type": "string", "example": "4whkhyXTrTgHKZzkUvdwoq" }, "description": "22-character Spotify artist, album, track or playlist id" } ], "security": [] } }, "/api/v1/permits": { "get": { "operationId": "get_api_v1_permits", "tags": [ "us-building-permits-api" ], "summary": "Search permit events for a city.", "description": "Search permit events for a city. Price: $0.010000 USD per call on Base via x402. The live 402 challenge is the authoritative price.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.010000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "city": { "type": "string" }, "note": { "type": "string" }, "results": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string" }, "status": { "type": "string" }, "address": { "type": "string" }, "issued_at": { "type": "string" }, "permit_number": { "type": "string" } }, "required": [ "type", "status", "address", "issued_at", "permit_number" ] } } }, "required": [ "city", "note", "results" ] } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "city", "in": "query", "required": false, "schema": { "type": "string", "example": "austin" }, "description": "City name" }, { "name": "query", "in": "query", "required": false, "schema": { "type": "string", "example": "roof" }, "description": "Search query" } ] } } }, "x-apistead-payments": { "primary": "x402", "network": "eip155:8453", "asset": "USDC", "settlement": "direct_to_provider", "note": "The agent pays the provider's payTo wallet directly. APIStead does not custody funds. x402 with USDC on Base is the only rail; there is no card checkout or subscription billing.", "guide": "https://x402.apistead.qd.je/api" }, "x-apistead-catalogue": { "total": 10, "providers": 1, "categories": [ "Address & Location", "Compliance", "Media", "Public Records", "Verification", "Weather & Geospatial" ], "generated_at": "2026-11-14T03:56:30.585Z", "note": "Public catalogue is served by APIStead. The 402 challenge on each provider route is the authoritative price quote." } }