Install Jentic One Beta

Connect the Pinkbike API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Pinkbike API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fpinkbike.com%2Fpinkbike" | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fpinkbike.com%2Fpinkbike" | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Pinkbike API.

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

GET STARTED

Start building with Pinkbike API

Explore with Jentic One

View OpenAPI Document

Use Cases

Patterns agents use Pinkbike API for, with concrete tasks.

★ 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.

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.

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.

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.

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

25 endpoints — pinkbike is the world's largest mountain biking community and marketplace.

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

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

Why Jentic?

What agents get from Jentic-routed access to this vendor.

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 isolation

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.

Intent-based discovery

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.

FAQs

Specific to using Pinkbike API through Jentic.

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.

Pinkbike API

Name: Pinkbike API
Brand: Pinkbike API
Availability: InStock

Social MediaSocial ManagementapiKey25 EndpointsREST

For 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.

Use for: I need to find mountain bike trails near Vancouver with jump features, Show me the latest bike reviews for enduro mountain bikes, Find used full-suspension bikes for sale under $3000 in California, Get upcoming mountain bike races and events in British Columbia

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

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.

Jentic One on Github View OpenAPI Document