{"uid":"cap_H5FpgI2oK4CITJ5zq4AdO","slug":"padelmaps-bulk-clubs-by-country-1c864c31","name":"PadelMaps Bulk Clubs by Country","description":"Get all active clubs in a country with full fields","url":"https://padelmaps.org/api/x402/clubs/bulk","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","bodyType","body"],"properties":{"body":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","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."}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","properties":{"type":{"type":"string"},"example":{"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"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.25","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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_WnlUo5JZcguXtdA4_eJQg","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.25","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns all active padel clubs in a given country with full field details including location, facilities, and contact info","exampleAgentPrompt":"Can you pull the full list of all active padel clubs in Spain from PadelMaps, including their addresses, facilities, and contact details?","exampleUseCases":[{"title":"National padel venue directory","prompt":"I need a complete list of every active padel club in Italy with their full details — addresses, facilities, phone numbers, everything. Can you get that from PadelMaps?"},{"title":"Country-level padel market research","prompt":"I'm researching the padel market in France. Can you fetch all the active padel clubs there with full details so I can analyze how many courts and venues exist?"},{"title":"Travel padel planning by country","prompt":"I'm visiting Germany next month and want to know all the padel clubs that are active there. Can you get me the complete list with locations and contact info?"}],"resultDescription":"A bulk dataset of all active padel clubs in the specified country, each record containing full fields such as club name, address, GPS coordinates, available courts, facilities, contact details, and operating status.","failureModes":["Invalid or unsupported country code returns an error or empty result","Country not covered by PadelMaps returns empty dataset","Payment failure via x402 protocol blocks access","Rate limiting if called too frequently","Stale data if clubs have recently closed or opened"],"whenToPreferThis":"Use this endpoint when you need a comprehensive, country-wide snapshot of all active padel clubs rather than searching city-by-city. Ideal for market research, building directories, or seeding a database. Prefer this over the city-level endpoint when you need national coverage in a single call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:31:59.078Z","isFirstParty":false}