POST
https://api.milda.ai/v1/trade-data/shipment-suppliersShipment Suppliers
application/json01
Description
Trade Data — Shipment Suppliers
POST /v1/trade-data/shipment-suppliers
Ranked list of shipment suppliers (exporters that ship to the candidate company), 10 per page. Use this to see who the company sources from.
Request
candidate_id(required) — from acandidatesresult.page_no(optional, default1) — page number; 10 suppliers per page.
Response
List of suppliers, ranked by trade volume. Each item includes: rank, id, name, domain, country {name, code, name_cn}, total_export_value, total_shipments, total_export_quantity, total_weight, import_countries, export_countries, loading_ports, unloading_ports, products.
Returns 204 No Content when the page has no suppliers.
Credits
Charged a flat fee per page (data credits).
02
Headers
nameinreqdescription
tokenheaderyesAPI token. Issued per account; check it with GET /v1/credit-usage.
03
Request body
TradePartnersRequestTradePartnersRequesttypereq2 fields
candidate_idstringyescandidate_id from a candidates result.
page_nointeger—Page number (10 partners per page).min 1 · default 1
04
Responses
200 Successful Response422 Validation Error