Trademo APItrademo.com ↗
Access Trademo trade data via API: country directories, company search, sanctions lists, PEP lists, and global trade indices for 200+ countries.
What is the Trademo API?
The Trademo API provides 5 endpoints covering global trade intelligence, including company search with shipment value rankings, sanctions and PEP compliance lists, and import/export indices for major trading nations. The search_companies endpoint returns company IDs, slugs, and shipment value metrics by keyword, while get_countries_list covers 200+ countries with direct links to buyers and manufacturers directories.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/20109aa3-5544-473d-9fba-56ed64f112a8/get_countries_list' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace trademo-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.trademo_api import Trademo, Country, Company, SanctionsCategory, PepCategory, TradeIndex
trademo = Trademo()
# Search for companies by name
for company in trademo.companies.search(query="samsung"):
print(company.label, company.company_id, company.value)
# List all sanctions categories
for category in trademo.sanctionscategories.list():
print(category.category_name, category.lists_count, category.entities_count)
# List PEP categories
for pep in trademo.pepcategories.list():
print(pep.category_name, pep.url)
# List global trade indices
for index in trademo.tradeindexes.list():
print(index.index_name, index.description)
# List available countries
for country in trademo.countries.list():
print(country.country_name, country.buyers_url, country.manufacturers_url)
Get the list of countries available on Trademo with links to their buyers and manufacturers directories. Returns all available countries (200+). Each country entry provides URLs for browsing buyers and manufacturers registered in that country.
No input parameters required.
{
"type": "object",
"fields": {
"items": "array of country objects with country_name, buyers_url, manufacturers_url"
},
"sample": {
"data": {
"items": [
{
"buyers_url": "https://www.trademo.com/united-states/buyers",
"country_name": "United States",
"manufacturers_url": "https://www.trademo.com/united-states/manufacturers"
},
{
"buyers_url": "https://www.trademo.com/mexico/buyers",
"country_name": "Mexico",
"manufacturers_url": "https://www.trademo.com/mexico/manufacturers"
}
]
},
"status": "success"
}
}About the Trademo API
Country and Company Discovery
The get_countries_list endpoint returns every country available on Trademo, including country_name, buyers_url, and manufacturers_url — giving you direct links to buyer and manufacturer directory pages for each territory. For company lookups, search_companies accepts a query string (e.g. 'apple', 'walmart') and returns matching results with label (company name), company_id, company_slug, mongo_id, and a value field representing the company's shipment value ranking metric. This makes it straightforward to resolve a company name to its Trademo identifier for downstream use.
Compliance: Sanctions and PEP Lists
get_sanctions_lists and get_pep_lists both return categorized compliance data. Each response item includes a category_name, description, lists_count, entities_count, and a url pointing to the full category on Trademo. Sanctions categories cover major international screening programs; PEP categories cover Politically Exposed Persons organized by region or program type. The entities_count field lets you quickly gauge the scale of each list before navigating to it.
Global Trade Indices
get_global_trade_indices returns import and export index data for major trading countries including the US, Russia, Mexico, Brazil, and Vietnam. Each record includes index_name, description, and a url for the full index details. This endpoint is useful for tracking relative trade activity signals across key economies without building your own data pipeline against raw trade records.
The Trademo API is a managed, monitored endpoint for trademo.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when trademo.com 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 trademo.com 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?+
- Build a supplier discovery tool that maps manufacturers by country using
buyers_urlandmanufacturers_urlfromget_countries_list. - Automate company name resolution to Trademo IDs using
search_companiesbefore enriching records with trade profile data. - Screen counterparties against sanctions programs by pulling category metadata and entity counts from
get_sanctions_lists. - Identify politically exposed persons in a due diligence workflow using
get_pep_listscategory data and entity counts. - Monitor trade activity trends across the US, Brazil, Vietnam, and other key economies using
get_global_trade_indices. - Populate a compliance dashboard with sanctions and PEP list coverage counts to surface gaps in screening programs.
- Generate country-level trade directories by pairing
get_countries_listoutput with company search results filtered by origin.
| 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 | 100 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 Trademo have an official developer API?+
What does `search_companies` return beyond a company name?+
search_companies returns label (company name), company_id, company_slug, mongo_id, and a value field representing a shipment value ranking metric. The company_slug and company_id can be used to construct profile URLs or reference companies in other queries. It does not return full company profiles, contact details, or shipment history directly.How granular is the sanctions and PEP data returned?+
category_name, description, lists_count, and entities_count, plus a URL to view the full list on Trademo. Individual entity records — names, aliases, nationalities, designating authorities — are not returned by these endpoints. You can fork this API on Parse and revise it to add an endpoint that fetches entity-level detail from within a given category.Does the API cover trade indices for countries beyond the US, Russia, Mexico, Brazil, and Vietnam?+
get_global_trade_indices returns data for those five countries. Indices for other major economies are not included. You can fork this API on Parse and revise it to add coverage for additional countries if Trademo surfaces them.