planetfitness.com 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.
curl -X GET 'https://api.parse.bot/scraper/92ca16a3-5e2d-4281-8441-fb4dbbf2922f/search_clubs?limit=3&query=New+York' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for Planet Fitness clubs by city name, state name, or ZIP code. Returns a list of matching clubs with location, amenities, equipment, and basic info. The upstream API geocodes the query to find nearby clubs.
| 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'). Two-letter state codes may produce unexpected results (e.g. 'CA' resolves to Canada). |
{
"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:2811e3f9-c285-11e8-999a-a511d4663031",
"name": "Manhattan (Herald Square), NY",
"slug": "manhattan-herald-square-ny",
"status": "OPEN",
"location": {
"city": "New York",
"address": "215 W 35th St, New York, NY 10001",
"latitude": "40.751890",
"longitude": "-73.991166",
"stateCode": "NY",
"postalCode": "10001"
},
"pfClubId": "0841",
"amenities": {
"classic": [
"ClassicAccess",
"FreeICFT",
"MobileApp"
],
"blackCard": [
"BCRecip",
"FreeICFT",
"BCVirtualFT"
]
},
"telephone": "+1 (555) 012-3456",
"equipments": {
"Cardio": [
"TREADMILL",
"ELLIPTICAL"
],
"Strength": [
"SELECTORIZEDSTRENGTHMACHINES"
]
}
}
],
"total": 277
},
"status": "success"
}
}About the planetfitness.com 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.
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.
- 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 | 250 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.