Skip to content
DroidBazaar

API & MCP

DroidBazaar's data is available to developers and AI agents, read-only and free. Every specification and compatibility carries its source URL and the date it was checked. Please link back to the DroidBazaar page given in each url field.

REST API v1

Base URL https://droidbazaar.com/api/v1. JSON responses, CORS enabled, no key needed. Limit: 120 requests per minute per IP (see the X-RateLimit-* headers). The full description is in openapi.json (OpenAPI 3.1).

Endpoints
EndpointReturns
GET /robotsRobot models; filters category, brand, status, sort and min_<spec>/max_<spec>
GET /robots/{brand}/{model}Robot with sourced specifications, links and variants
GET /robots/{brand}/{model}/partsParts compatible with the robot (its family included)
GET /robots/{brand}/{model}/where-to-buy?region=Dealers, distributors and service companies, by country or EU
GET /robots/{brand}/{model}/issuesKnown issues reported by owners, most confirmed first
GET /robots/{brand}/{model}/pricesSourced prices (list, store, second-hand, rental) and second-hand statistics
GET /brandsBrands
GET /brands/{slug}Brand with its robots
GET /partsParts; filters category, robot=brand/model, maker
GET /parts/{slug}Part with specs and compatibility levels
GET /listingsLive marketplace listings
GET /listings/{id}One listing (contact happens on the website)
GET /needsOpen needs: what buyers are looking for
GET /newsNews summaries with their original source
GET /guidesGuides on how robots and their parts work
GET /guides/{slug}A guide as plain text with figure credits and further reading
GET /companiesCompanies: component makers, dealers, service providers…
GET /search?q=Search robots, brands, categories, parts, companies, news, listings and needs

Example: batteries for the Unitree Go2

curl "https://droidbazaar.com/api/v1/parts?category=battery&robot=unitree/go2"

Errors

{ "error": { "code": "invalid_request", "message": "category: Invalid option…" } }

MCP server for AI agents

Connect an MCP client (Claude and others) to https://droidbazaar.com/api/mcp (Streamable HTTP, no authentication). Tools: search_robots, get_robot, get_robot_prices, get_robot_issues, compare_robots, search_parts, check_part_compatibility, search_listings, get_listing, search_needs, search_news and search_companies. They are read-only.

{
  "mcpServers": {
    "droidbazaar": { "type": "http", "url": "https://droidbazaar.com/api/mcp" }
  }
}

Good to know

  • Listings and needs contain no contact details: people contact each other on the website.
  • Compatibility levels: official (the maker says so, with source), verified, seller claimed and community (unchecked).
  • Manufacturers who want to update their data can list their company.