Planet Fitness APIplanetfitness.com ↗
Search Planet Fitness gym locations by city, state, or ZIP. Get hours, amenities, equipment lists, membership plans, and coordinates for any US club.
What is the Planet Fitness API?
The Planet Fitness API covers all 4 endpoints needed to find and inspect US gym locations, from a quick ZIP code search to a full national rollup across all 51 state-level regions. The search_clubs endpoint returns club IDs, slugs, coordinates, amenities, and equipment for any city, state name, or postal code query. get_club_detail expands a single slug into operating hours, membership offers, crowd meter data, and holiday hours.
curl -X GET 'https://api.parse.bot/scraper/92ca16a3-5e2d-4281-8441-fb4dbbf2922f/search_clubs?limit=10&query=New+York' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace planetfitness-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.planet_fitness_club_locator_api import PlanetFitness, ClubSummary, Club, StateCode, ClubNotFound
pf = PlanetFitness()
# Search for clubs near a ZIP code
for club in pf.clubsummaries.search(query="10001"):
print(club.name, club.telephone, club.location.city, club.location.state_code)
# Navigate from summary to full detail
detail = club.details()
print(detail.hours.working_days[0].time, detail.status)
# Inspect equipment and amenities
print(detail.equipment.strength, detail.amenities.black_card)
# Check membership offers
for offer in detail.offers:
print(offer.title, offer.display_price.amount, offer.display_price.frequency, offer.is_black_card)
# Get all clubs in Rhode Island using the StateCode enum
for club in pf.clubsummaries.by_state(state_code=StateCode.RI):
print(club.name, club.slug, club.location.postal_code)
# Direct club lookup by slug
club = pf.clubs.get(slug="conway-ar")
print(club.name, club.phone, club.location.address)
Full-text geocoded search for Planet Fitness clubs by city name, state name, or ZIP code. The upstream API geocodes the query string to coordinates and returns nearby clubs sorted by distance. Each result includes location, amenities, equipment categories, and operational status. Queries using two-letter state codes may resolve to non-US locations (e.g. 'CA' to Canada); use the full state name or get_clubs_by_state for unambiguous state-level queries.
| Param | Type | Description |
|---|---|---|
| limit | integer | Maximum number of results to return. |
| queryrequired | string | Search query - city name (e.g. 'Los Angeles'), state name (e.g. 'Texas'), or ZIP code (e.g. '10001'). |
{
"type": "object",
"fields": {
"clubs": "array of club objects with id, name, slug, status, telephone, location, amenities, equipments",
"total": "integer total count of matching clubs"
},
"sample": {
"data": {
"clubs": [
{
"id": "pfx:clubs:0aeb6d23-c285-11e8-999a-a511d4663031",
"name": "Manhattan (Canal St), NY",
"slug": "manhattan-canal-st-ny",
"status": "OPEN",
"location": {
"city": "New York",
"address": "370 Canal St, New York, NY 10013-2206",
"latitude": "40.720692",
"longitude": "-74.004363",
"stateCode": "NY",
"postalCode": "10013-2206"
},
"pfClubId": "0843",
"amenities": {
"classic": [
"ClassicAccess",
"FreeICFT",
"MobileApp"
],
"blackCard": [
"BCRecip",
"FreeICFT",
"BCVirtualFT"
]
},
"telephone": "+1 (555) 012-3456",
"equipments": {
"Cardio": [
"TREADMILL",
"ELLIPTICAL",
"ROWER"
],
"Strength": [
"SELECTORIZEDSTRENGTHMACHINES",
"CABLETOWERS"
],
"Functional": [
"FUNCTIONALACCESSORIES"
]
}
}
],
"total": 278
},
"status": "success"
}
}About the Planet Fitness API
Searching and Listing Clubs
The search_clubs endpoint accepts a query string — a city name, full state name, or ZIP code — and returns a clubs array alongside a total count. Each club object includes an id, name, slug, status, telephone, and a location object with city, address, state code, postal code, latitude, and longitude. Amenity and equipment arrays are included at the list level, so you can filter results without making a follow-up request. The optional limit parameter caps result size.
Club Detail
Pass any slug from search results to get_club_detail to retrieve the full record. The hours object breaks down workingDays and weekends schedules separately. The offers array lists membership plan objects with pricing details. The amenities object distinguishes between classic and blackCard tiers. Equipment is split across Strength, Cardio, and Functional arrays. A crowd_meter field returns current or historical capacity data where available.
State-Level and National Coverage
get_clubs_by_state accepts a two-letter state_code (validated against all 50 states plus DC) and returns every club in that state with the same object shape as search_clubs. For full national coverage, get_all_locations queries all 51 regions and returns a states object keyed by state code, each holding condensed club records (name, slug, address, coordinates), plus a total_clubs integer. This endpoint is intentionally heavier and best suited for bulk ingestion or index building rather than real-time queries.
The Planet Fitness API is a managed, monitored endpoint for planetfitness.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when planetfitness.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official planetfitness.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a gym-finder map using latitude/longitude from
search_clubsfiltered by ZIP code - Compare Classic vs. Black Card amenities across clubs in a metro area using the
amenitiesobject fromget_club_detail - Aggregate all US Planet Fitness locations into a database using
get_all_locationsfor offline analysis - Display club operating hours and holiday schedules in a third-party fitness app via
get_club_detail - Populate a state directory page by iterating
get_clubs_by_statefor each state code - Filter clubs by available equipment type (Strength, Cardio, Functional) before recommending locations to users
- Track membership plan options and offer structures by club using the
offersarray fromget_club_detail
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Planet Fitness have an official public developer API?+
What does the `crowd_meter` field in `get_club_detail` actually contain?+
crowd_meter field returns capacity data for the club where available. Its shape is either an object or an array depending on the club. Not every location populates this field, so your code should handle null or empty values.Does the API cover Canadian or international Planet Fitness locations?+
get_clubs_by_state is validated against the 50 US states plus DC, and get_all_locations queries those same 51 regions. International locations are not currently covered. You can fork this API on Parse and revise it to add queries targeting non-US regions.Can I retrieve user reviews or check-in history for a club?+
What is the difference between the `clubs` array in `search_clubs` versus the condensed records in `get_all_locations`?+
search_clubs and get_clubs_by_state return full club objects including amenities, equipment, status, and telephone. get_all_locations returns condensed records containing only name, slug, address, and coordinates — enough for index building but not for amenity-level filtering without a follow-up get_club_detail call.