Skip to content

Developer API

Embed robot recommendations in your product

The same rules-based matcher that powers PickTheRobot.com — warehouse, cleaning, and restaurant categories. Send facility inputs, get robot type fit, acquisition guidance, ranked vendors, and tracked outbound links.

Pricing

Paid API access. Start with Starter for pilots, upgrade to Pro for higher volume and richer response fields. Each subscription includes one API key with its own monthly quota — subscribe again for separate keys (e.g. dev and production).

Starter

$49/mo

Billed monthly · cancel anytime

  • 2,000 match calls / month (business + home)
  • 30 requests / minute
  • Up to 3 vendors or home models per match
  • Up to 50 rows in catalog APIs
  • No attribution required
  • Core business match results and ranked vendors
  • Home vacuum shortlist from floors, pets, mop, budget
  • Summary cleaning ROI on business match responses

Pro

$149/mo

Billed monthly · cancel anytime

  • 10,000 match calls / month (business + home)
  • 60 requests / minute
  • Up to 5 vendors or home models per match
  • Up to 200 rows in catalog APIs
  • No attribution required
  • Runner-up and alternate business robot matches
  • Vendor scores and extended explanations
  • Full cleaning ROI breakdown
  • Home vacuum score breakdowns
  • Extended vendor and home catalog fields

Quick start

Every request requires an API key. Subscribe, copy your key from the success page, then send JSON (see scripts/api-samples/). Use /api/v1/match for business robots and /api/v1/home/match for home vacuums — separate catalogs.

# Business (warehouse / cleaning / restaurant)
curl -X POST https://picktherobot.com/api/v1/match \
  -H "Content-Type: application/json" \
  -H "X-API-Key: ptr_starter_your_key_here" \
  --data-binary "@match-cleaning.json"

# Home robot vacuums
curl -X POST https://picktherobot.com/api/v1/home/match \
  -H "Content-Type: application/json" \
  -H "X-API-Key: ptr_starter_your_key_here" \
  --data-binary "@match-home-vacuum.json"

Endpoints

POST /api/v1/match

Business matcher (warehouse, cleaning, restaurant)

POST /api/v1/home/match

Home robot vacuum matcher (floors, pets, mop, budget)

GET /api/v1/home/products

Browse the home vacuum SKU catalog

GET /api/v1/vendors

Browse the business vendor catalog by category and region

GET /api/v1/openapi.json

Machine-readable OpenAPI 3.1 specification

View reference

FAQ

Who is the API for?
Software teams embedding robot recommendations — business (warehouse, commercial cleaning, restaurant) or home robot vacuums — in apps, dealer sites, consulting portals, or internal workflows.
How is the API priced?
Starter ($49/mo) and Pro ($149/mo). Every request requires a valid API key from an active subscription.
Starter vs Pro?
Starter is for pilots and light embeds: lower volume and core match fields. Pro adds higher limits, runner-up business matches, vendor score breakdowns, full cleaning ROI, and home vacuum score detail.
Can I have more than one API key?
Yes. Each subscription is one API key with its own rate limits and monthly quota. Need separate keys for dev and production, or for different products? Subscribe once per key. Use the recovery link on each success page if you need to rotate a key without affecting your others.
Is ranking pay-to-win?
No. The same rules-based scoring engine powers the website. Sponsored vendors only receive a small boost when they already match the profile. Paid tiers unlock volume and data depth, not placement.
Home vacuums vs business robots?
They are separate endpoints and catalogs. Use POST /api/v1/home/match for home robot vacuums and POST /api/v1/match for warehouse, commercial cleaning, or restaurant. Both share the same monthly match quota.
How do vendor clicks work?
Business vendor links in API responses route through our tracked /out redirect with UTM parameters. Home product clickUrl values may be retailer affiliate links — use them as returned. Pass affiliateLocale (US or UK) on POST /home/match or locale on GET /home/products to pick Amazon.com / Amazon.co.uk; rankings do not change.
Do failed requests count against my quota?
No. Rate limits and monthly match quotas apply only to successful responses.
How do I authenticate?
Send your API key in the X-API-Key header or as a Bearer token on every request. Keys are issued on the success page after Stripe checkout.
Need more than Pro?
Email hello@picktherobot.com for high-volume or custom integration needs.

Ready to integrate?

Pick a plan, get your API key, and explore the OpenAPI spec.

Open API reference