traded.co APItraded.co ↗
Access commercial real estate deals, broker leaderboards, hotel transactions, VC rounds, and awards from Traded.co via 9 structured API endpoints.
// select an endpoint above
About the traded.co API
The Traded.co API exposes 9 endpoints covering commercial real estate transactions, broker leaderboards, venture capital deals, news, and awards. The get_deals endpoint returns paginated deal cards filterable by state, asset type, transaction type, date range, and price range — each record including address, sale price, loan amount, broker profiles, and property metadata. Companion endpoints handle hotel-specific deals, full deal detail, VC funding rounds, and ranked broker categories.
Deal Data
The get_deals endpoint returns a count plus an array of deal summaries. Each summary carries id, slug, link, title, address, salePrice, loanAmount, transactionType, properties, and profiles. Filters include state (lowercase slug like 'new-york' or 'national'), asset_type ('multifamily', 'office', 'retail', 'industrial', 'hotel', 'mixed-use'), transaction_type ('sale', 'loan', 'lease'), date_range, and price_range. get_deal_detail and get_deal_by_link expand a single deal into full detail: buyers, sellers, lenders, brokers (with count and profileDealCompanies), profiles, assetType, and articleTitle. Pass the slug plus the path segments state, asset_type, and transaction_type to get_deal_detail, or pass the raw link field (e.g. 'deals/new-york/office/sale/example-deal-slug') to get_deal_by_link.
Brokers, Leaderboards, and Awards
get_leaderboards returns a leaderBoardResolver object with named category arrays: bigBoxers, builders, dealJunkie, hotDeals, leaseShark, loanShark, officeIanados, rentRollers, risingTalent, unicorn, and whales. Pagination is controlled via page and limit parameters; the state filter uses title-case values like 'New York' or 'National'. get_awards surfaces the same category structure (whales, unicorn, builders, hotDeals, bigBoxers, loanShark, dealJunkie, leaseShark, rentRollers, risingTalent) drawn from the awards page rather than the live leaderboard feed.
VC Deals and News
get_vc_deals returns a deals array of VC transaction objects (fields: id, articleTitle, caption, publishedAt, slug, totalDeals) alongside articlesData for VC interview and article blogs and proptechData for proptech blog content. get_news returns a data array of CRE news articles, each with id, title, slug, author, status, publishedAt, image, and tags. Neither news endpoint accepts filter parameters in the current spec. get_hotel_deals is a convenience wrapper around the deal feed restricted to asset_type: hotel, returning the same count and deals shape as get_deals.
- Track recent multifamily or office sales in a specific state using
get_dealswithasset_typeandstatefilters - Pull full buyer, seller, broker, and lender details for a known deal via
get_deal_by_linkusing thelinkfield from a listing - Build a broker performance dashboard by fetching ranked leaderboard categories from
get_leaderboardsfiltered to a target market - Monitor hotel transaction volume across all markets with
get_hotel_deals - Aggregate proptech funding rounds and VC deal metadata using
get_vc_deals - Surface CRE award winners by category (whales, unicorn, risingTalent) from
get_awardsfor industry recognition tracking - Feed a CRE news digest with structured article objects from
get_newsincluding publication date, author, and tags
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Traded.co offer an official developer API?+
How do leaderboard categories differ between `get_leaderboards` and `get_awards`?+
get_leaderboards is paginated and accepts a state filter (title-case, e.g. 'New York'), returning live ranked broker data across categories like whales, dealJunkie, and risingTalent. get_awards returns the same category names but pulls from the awards page — it takes no filter parameters, so it always returns the full national awards dataset.Can I filter news articles or VC deals by date, tag, or market?+
get_news and get_vc_deals return their full datasets without filter parameters. Both endpoints do include publishedAt and tags fields in responses, so client-side filtering is possible. You can fork this API on Parse and revise it to add server-side filter parameters for those endpoints.What deal path information do I need to call `get_deal_detail`?+
get_deal_detail requires the slug field and optionally accepts state, asset_type, and transaction_type slugs to construct the deal path. All three path segments are returned as part of the link field in get_deals results, so you can also pass the full link directly to get_deal_by_link instead.Does the API expose individual broker profile pages or historical broker deal history?+
profiles arrays within deal responses and as ranked entries within leaderboard and award categories — there is no standalone broker-profile endpoint. You can fork this API on Parse and revise it to add a dedicated broker profile endpoint using the profile slugs already present in deal responses.