Traded APItraded.co ↗
Access commercial real estate deals, broker leaderboards, VC transactions, and awards from Traded.co via 8 structured endpoints with filters for state, asset type, and more.
What is the Traded API?
The Traded.co API exposes 8 endpoints covering commercial real estate deal data, broker leaderboards, venture capital transactions, news, and awards from Traded.co. The get_deals endpoint alone returns deal cards with fields including salePrice, loanAmount, transactionType, closingDate, and broker metadata, and supports filtering by state, asset type, transaction type, date range, and price range. Detail endpoints return buyers, sellers, and full broker profile arrays for individual transactions.
curl -X GET 'https://api.parse.bot/scraper/d1d81861-1a32-4c3b-9348-266dc20d0557/get_deals?state=florida&asset_type=multifamily&transaction_type=sale' \ -H 'X-API-Key: $PARSE_API_KEY'
Fetch a paginated list of commercial real estate deals with optional filters for state, asset type, transaction type, date range, price range, and sorting. Returns deal cards with metadata including address, price, brokers, and property details.
| Param | Type | Description |
|---|---|---|
| state | string | State or market filter as a lowercase slug (e.g. 'national', 'colorado', 'new-york', 'florida', 'texas'). |
| sort_by | string | Sort order for results. Omitting uses default (most recent). |
| asset_type | string | Asset type filter as lowercase slug. Omitting returns all asset types. |
| date_range | string | Date range filter (e.g. 'Past Week', 'Past Month'). Omitting returns all dates. |
| price_range | string | Price range filter. Omitting returns all price ranges. |
| transaction_type | string | Transaction type filter as lowercase slug. Omitting returns all transaction types. |
{
"type": "object",
"fields": {
"count": "integer total number of matching deals",
"deals": "array of deal summary objects with id, slug, link, title, address, properties, salePrice, loanAmount, transactionType, closingDate, articleTitle"
}
}About the Traded API
Deal Listings and Detail
The get_deals endpoint returns a paginated list of commercial real estate deals with a count integer and a deals array. Each deal object includes id, slug, link, title, address, properties, salePrice, loanAmount, transactionType, and closingDate. You can filter by state (e.g. 'new-york', 'texas', 'national'), asset_type, transaction_type, date_range, and price_range. To retrieve full deal data, pass the slug to get_deal_detail or pass the link field directly to get_deal_by_link. The detail response adds buyers, sellers, brokers (with count and profileDealCompanies), and a profiles array of individual broker records.
Leaderboards and Awards
get_leaderboards returns ranked broker data across 11 named categories: bigBoxers, builders, dealJunkie, hotDeals, leaseShark, loanShark, officeIanados, rentRollers, risingTalent, unicorn, and whales. Each category contains broker profiles with deal counts and volume. Results support page, limit, and state (title case, e.g. 'New York') parameters. get_awards returns the same category structure sourced from the Traded.co awards page, returning arrays for each category independently.
VC Deals and News
get_vc_deals returns a deals array of venture capital and proptech transactions, each with id, articleTitle, caption, publishedAt, and slug, plus articlesData and proptechData objects containing associated blog content. get_news returns a data array of CRE news articles with id, title, slug, author, status, publishedAt, image, and tags. Neither endpoint accepts filter parameters.
Hotel Deals
get_hotel_deals is a convenience endpoint that scopes results to hotel asset type. It accepts an optional state slug and returns the same count and deals array shape as get_deals, making it straightforward to track hotel transaction activity by market without constructing an asset type filter manually.
The Traded API is a managed, monitored endpoint for traded.co — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when traded.co changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official traded.co API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Monitor new CRE deal closings by state and asset type using
get_dealswithstateandasset_typefilters - Build broker performance dashboards by pulling ranked profiles from
get_leaderboardscategories likewhalesorrisingTalent - Track hotel market activity across specific states using
get_hotel_dealswith astateslug - Enrich a deal record with full buyer, seller, and broker profile data using
get_deal_by_linkfrom a listing'slinkfield - Aggregate proptech funding rounds and VC transactions using the
dealsandproptechDatafields fromget_vc_deals - Surface CRE news articles with publication dates and tags using
get_newsfor a content feed or alert system - Cross-reference annual broker award winners by category using
get_awardsfor industry recognition tracking
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Traded.co have an official developer API?+
How do I retrieve full buyer and seller detail for a deal?+
get_deals to retrieve deal summaries, which include a link and slug per record. Pass the link value to get_deal_by_link, or pass slug plus optional state, asset_type, and transaction_type slugs to get_deal_detail. Both return buyers, sellers, brokers, and a profiles array not present in the listing response.Can I filter `get_leaderboards` results by city or zip code?+
state parameter on get_leaderboards accepts market-level slugs in title case (e.g. 'New York', 'Florida', 'National'). Sub-market filtering by city or zip code is not currently supported. You can fork this API on Parse and revise it to add a more granular geographic filter endpoint.Do `get_news` or `get_vc_deals` support date or tag filtering?+
get_news returns the latest published articles with publishedAt and tags fields you can filter client-side. get_vc_deals returns all available VC and proptech records at once. You can fork this API on Parse and revise it to add date-range or tag filter parameters to those endpoints.What does the `get_awards` endpoint return that `get_leaderboards` does not?+
get_awards returns data sourced from Traded.co's awards page rather than the live leaderboard feed, with results structured as flat arrays keyed by category (e.g. whales, unicorn, leaseShark). Unlike get_leaderboards, it does not accept state, page, or limit parameters, so it always returns the full awards dataset.