{"uid":"cap_Xln9IOC1QaSi1os8jDFT4","slug":"onchainexpat-clubs-bulk-lookup-56a0825a","name":"OnchainExpat Clubs Bulk Lookup","description":"Pay-per-request AI, crypto, proxy, and utility APIs using x402 protocol","url":"https://x402.onchainexpat.com/api/x402/clubs/bulk?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","required":["country"],"properties":{"limit":{"type":"integer","description":"Max results (default: 1000, max: 5000)"},"country":{"type":"string","description":"Country slug, e.g., 'spain'. Call /api/x402/countries ($0.01) for valid slugs and club counts."}}},"responseSchema":{"type":"object","properties":{"clubs":{"type":"array","description":"id, name, address, coordinates, phone, website, rating, court counts, public_url"},"count":{"type":"integer","description":"Clubs returned in this response"},"total":{"type":"integer","description":"Clubs available; compare with count to detect truncation"},"fields":{"type":"string","description":"'core' for this tier, 'full' for /clubs/bulk/full"},"country":{"type":"string"},"truncated":{"type":"boolean"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.25","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.25/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_1eBoEjYjOuwUdgyHnEFAG","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.25","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a bulk list of clubs filtered by country, up to 5000 results per call","exampleAgentPrompt":"Can you pull up to 2000 clubs listed in Spain from the OnchainExpat clubs directory?","exampleUseCases":[{"title":"Expat club discovery by country","prompt":"Get me the full list of clubs available in Portugal — up to 5000 results — so I can see what's out there for expats."},{"title":"Country-specific club inventory audit","prompt":"Fetch all clubs in Germany, limit it to 1000 results, so I can review the full directory for that country."},{"title":"Bulk club data for app population","prompt":"I need to pull the complete club list for Thailand, up to 5000 entries, to populate my expat community app."}],"resultDescription":"A JSON array of club records for the specified country, up to the requested limit (max 5000). Each record likely includes club identifiers, names, and metadata relevant to the country context.","failureModes":["Invalid country slug returns an error or empty result — use /api/x402/countries to get valid slugs","Limit exceeding 5000 may be capped or rejected","Missing country parameter may return global results or an error","Payment failure via x402 protocol results in 402 response with no data"],"whenToPreferThis":"Use this endpoint when you need a large batch of club data for a specific country in a single call, especially when you need up to 5000 records. Prefer this over paginated single-record lookups when doing bulk data ingestion, directory population, or country-level analysis.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-19T06:34:17.836Z","isFirstParty":false,"canonicalSlug":"onchainexpat-clubs-bulk-lookup-56a0825a"}