Skip to main content

Every award, verified and celebrated

Sign in

Trophies API

Base URL https://launchtrophies.com/api/v1. Machine-readable: OpenAPI 3.1. Each operation is also an MCP tool with the same name.

Trophy cabinets, awards and their verification, leaderboards, Hall of Fame, programmes to enter

GET/api/v1/trophies/cabinets

Search trophy cabinets. Trophy cabinets (one per product) ranked by award points, optionally filtered by a search term, category slug or country. Points come from awards only; nothing paid adds a point.

MCP tool list_trophy_cabinets · public, no sign-in · paginated

InputWhereTypeDescription
qquerystringSearch company name
categoryquerystringTop-level category slug
countryquerystringISO country code
pagequeryintegerPage number (1-based) (default 1)
per_pagequeryintegerItems per page (default 20)
curl "https://launchtrophies.com/api/v1/trophies/cabinets"

GET/api/v1/trophies/cabinets/{slug}

One trophy cabinet. Every published award in a cabinet with its issuer, year, placing and verification level (verified = the company is named on the issuer's own page; evidence = a page is linked but does not name it independently; self = no readable page). Pages are re-checked weekly.

MCP tool get_trophy_cabinet · public, no sign-in

InputWhereTypeDescription
slug requiredpathstringCabinet slug
curl "https://launchtrophies.com/api/v1/trophies/cabinets/example-slug"

GET/api/v1/trophies/leaderboards

Trophy leaderboard. Cabinets ranked by award points for the week, month, year or all time, optionally by category or country. Also see Hall of Fame. Paid placements never add points.

MCP tool trophy_leaderboard · public, no sign-in

InputWhereTypeDescription
periodquerystringweek, month, year or all (one of: week, month, year, all)
categoryquerystringTop-level category slug
countryquerystringISO country code
curl "https://launchtrophies.com/api/v1/trophies/leaderboards"

GET/api/v1/trophies/hall-of-fame/{year}

Hall of Fame for a year. The year's inductees (most award points that year). final=false while the year is still running.

MCP tool hall_of_fame · public, no sign-in

InputWhereTypeDescription
year requiredpathintegerYear
curl "https://launchtrophies.com/api/v1/trophies/hall-of-fame/1"

GET/api/v1/trophies/programmes

Award programmes. Award programmes in the directory. open=true gives the 'awards you can enter' calendar: programmes whose entry deadline has not passed, soonest first. listed_by_organiser marks paid organiser listings.

MCP tool list_award_programmes · public, no sign-in · paginated

InputWhereTypeDescription
openquerybooleanOnly programmes still open for entries
pagequeryintegerPage number (1-based) (default 1)
per_pagequeryintegerItems per page (default 20)
curl "https://launchtrophies.com/api/v1/trophies/programmes"

GET/api/v1/trophies/my-cabinets

Your trophy cabinets. The cabinets of the companies you own, with every award (any status) and its verification level.

MCP tool my_trophy_cabinets · needs account:read

curl "https://launchtrophies.com/api/v1/trophies/my-cabinets" \
  -H "Authorization: Bearer $API_KEY"

POST/api/v1/trophies/cabinets/{slug}/awards

Add an award you won elsewhere (by URL). Adds an external award to your cabinet from the organiser's page. We read the page (robots.txt respected), keep only facts written on it, and set the verification level; the award appears in a minute or two (poll get_trophy_cabinet or my_trophy_cabinets). Free cabinets hold a limited number of external awards; Pro is unlimited.

MCP tool add_external_award · needs listings:write · accepts Idempotency-Key

InputWhereTypeDescription
slug requiredpathstringCabinet slug
url requiredbodystringAddress of the award page naming your company
titlebodystringAward name (optional; read from the page otherwise)
curl -X POST "https://launchtrophies.com/api/v1/trophies/cabinets/example-slug/awards" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "\u2026"}'
Need help?