canonical: https://jentic.com/apis/pinkbike.com/pinkbike

# Pinkbike API

Pinkbike is the world's largest mountain biking community and marketplace. The API provides access to trail databases, bike reviews, classified listings, photo galleries, forum discussions, and event calendars. Built for bike shops, trail organizations, gear manufacturers, and cycling apps to integrate mountain bike content, marketplace data, and community features into their platforms.

## For AI agents

Access mountain bike trail data, gear reviews, classified listings, photo galleries, and community discussions from Pinkbike. Supports 25 endpoints covering trails, products, marketplace, and events.

## Scope

Does not provide GPS navigation, ride tracking, or bike park lift tickets - use for trail discovery, gear research, marketplace browsing, and community content only.

## Capabilities

- Search and retrieve mountain bike trail listings with location, difficulty, features, and user ratings
- Access bike and gear reviews with ratings, specs, photos, and community feedback
- Query classified listings for bikes, frames, components, and accessories with pricing and location
- Retrieve photo galleries and video content from riders and events worldwide
- Access forum discussions, comments, and community posts by topic and region
- Get event listings for races, bike parks, festivals, and group rides by location and date
- Retrieve bike specifications, geometry data, and manufacturer information

## Use cases

### Trail Discovery and Trip Planning

Build trail discovery apps and trip planning tools using Pinkbike's comprehensive trail database. The API returns trail locations, difficulty ratings, feature tags (jumps, drops, flow, technical), elevation profiles, and user reviews. Apps can filter trails by region, difficulty, and bike type (XC, trail, enduro, downhill) and display trailhead coordinates, photos, and recent condition reports.

Example prompt: Search for intermediate-level trails within 50km of Squamish, BC that feature flow trails and jumps, then retrieve detailed trail info including GPS coordinates, photos, and recent reviews

### Gear Marketplace Integration

Integrate Pinkbike's buy/sell marketplace into bike shop websites, inventory systems, or price comparison tools. The API provides classified listings with bike specs, component details, asking prices, seller location, and photos. Bike shops can monitor market pricing, source used inventory, and automate price alerts for customers looking for specific models.

Example prompt: Query classified listings for Santa Cruz Nomad frames in size Large, filter by price range $2000-$4000, and retrieve listing details including seller location, condition, and photo URLs

### Product Review Aggregation

Aggregate Pinkbike's professional and community bike reviews for comparison tools, purchase decision apps, or manufacturer analytics. The API returns review content, numerical ratings, pros/cons, specifications, and community comments. Manufacturers can track sentiment and feature feedback; retailers can recommend bikes based on review scores and use cases.

Example prompt: Retrieve all reviews for 2024 enduro bikes with 160-180mm travel, extract average ratings, key features, and pros/cons to build a comparison table

### Event and Race Calendar Integration

Display mountain bike events, races, and bike park calendars in regional cycling apps, club websites, or athlete training platforms. The API returns event dates, locations, categories (XC, enduro, downhill), registration links, and results. Athletes can discover local races, plan travel to bike festivals, and track results across the season.

Example prompt: List all enduro and downhill races in the Pacific Northwest for the next 3 months, then retrieve event details including venue, registration deadline, and category information

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/v1/trails` | Search trails by location and difficulty |
| GET | `/v1/trails/{trailId}` | Get detailed trail information |
| GET | `/v1/reviews` | List bike and gear reviews |
| GET | `/v1/classifieds` | Search marketplace listings |
| GET | `/v1/events` | Query events and races by date and location |
| GET | `/v1/photos` | Retrieve photo galleries |
| GET | `/v1/news` | Get latest mountain bike news |

## Key resources

- **Trails** — Mountain bike trail listings with location, difficulty, features, and user ratings
- **Reviews** — Professional and community reviews for bikes, components, and gear
- **Classifieds** — Buy/sell marketplace listings for bikes, frames, and components
- **Photos** — User-submitted photo galleries from trails, events, and bike builds
- **Forums** — Community discussions, technical advice, and regional ride reports
- **Events** — Race calendar, bike festivals, and group ride listings
- **News** — Industry news, product launches, and event coverage

## Why Jentic

- **Setup:** Wiring Pinkbike by hand means managing its API key header, paging through trails and classifieds listings, and handling retries yourself. Through Jentic you install once, import Pinkbike from the API Directory, store the API key once, and your agent calls it.
- **Permission scoping:** Pinkbike's endpoints are read-only lookups over trails, reviews, classifieds, events, and news, so you limit the agent to the operations it needs, such as searching trails or browsing classifieds. Because you pick the allowed operations, the agent reads content and does nothing that writes.
- **Credential handling:** Your Pinkbike API key is stored once, encrypted, by your own Jentic One instance and injected as a header at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'find mountain bike trails near me' or 'search used bikes for sale', and Jentic returns the matching Pinkbike operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Strava API** — Activity tracking and social fitness platform with ride analytics and segment leaderboards
- **JCDecaux Bike API** — JCDecaux's bike-share API delivers real-time cycle station and availability data, pairing with Pinkbike's biking community feeds.

## FAQ

### What authentication does the Pinkbike API use?

The API uses API key authentication passed as a header (X-API-Key) or query parameter. API keys are obtained by registering an application in the Pinkbike developer portal. Through Jentic, API keys are stored encrypted and injected automatically - they never appear in agent prompts or logs.

### Can I search trails by geographic location?

Yes. GET `/v1/trails` accepts latitude/longitude coordinates and radius parameters to return nearby trails. You can also filter by difficulty level, bike type, features (jumps, drops, flow), and elevation gain. Trail responses include GPS coordinates, trailhead directions, and distance.

### What are the rate limits for the Pinkbike API?

The API enforces 1000 requests per hour per API key for read operations (trails, reviews, classifieds) and 100 requests per hour for write operations (comments, ratings). Rate limit headers (X-RateLimit-Limit, X-RateLimit-Remaining) are included in responses.

### Can I access user-submitted photos and galleries?

Yes. GET `/v1/photos` returns photo galleries filtered by trail, event, bike model, or user. Each photo includes URLs for multiple resolutions, captions, tags, and upload date. You can embed photos in your app with proper attribution to the photographer.

### Is the Pinkbike API free?

Pinkbike offers a free tier with 10,000 API calls per month for personal projects and open-source apps. Commercial use requires a paid Developer plan starting at $49/month with higher rate limits and priority support. All tiers include access to trails, reviews, and marketplace data.

### Can I post classified listings via the API?

Yes, but posting requires user OAuth authentication in addition to the API key. Users must authorize your app to post on their behalf. The API supports creating listings with title, description, price, location, category, and photos. Moderation rules and listing fees apply per Pinkbike's marketplace policies.

### Can I limit what my agent is allowed to do with the Pinkbike API?

Yes. Because you run Jentic One yourself, your own rules decide which Pinkbike operations and credentials your agent may use. The Pinkbike API is read-only lookups over trails, reviews, classifieds, events, and news, so you can allow just the operations the agent needs, such as searching trails or browsing classifieds, and withhold the rest. With those limits in place the agent only reads the content you have approved and cannot perform anything beyond it.