# TradeWind AI API 2.0 Documentation

## Docs
- 根目录 [Reference](https://docs.trade-wind.co/en/91149901f0.md): 
- 根目录 [Agentic Tasks](https://docs.trade-wind.co/en/91149902f0.md): 
- 根目录 [(Waterfall) Company Search ](https://docs.trade-wind.co/en/91149903f0.md): 
- 根目录 [(Waterfall) People Search](https://docs.trade-wind.co/en/91149904f0.md): 
- 根目录 [Email Verificatioin](https://docs.trade-wind.co/en/91149905f0.md): 
- 根目录 [Customs Record Search](https://docs.trade-wind.co/en/91149906f0.md): 
- 根目录 [Health](https://docs.trade-wind.co/en/91149907f0.md): 
- 根目录 [Metrics](https://docs.trade-wind.co/en/91149908f0.md): 

## API Docs
- 根目录 > Reference [(Agent) Country and Language Codes Reference (No authentication required)](https://docs.trade-wind.co/en/488458547e0.md): Agent task request field reference: mapping of search country ("country"), search-engine country code ("cr"), language ("lang"), and time zone ("zone"). Please call this API to consult the reference before invoking the (agent) task creation API.
- 根目录 > Reference [(Waterfall) Retrieve Industry references](https://docs.trade-wind.co/en/488458548e0.md): When the industry parameter is used below, retrieve it from this endpoint; you only need to call it once and store the result, as it does not change dynamically.
- 根目录 > Reference [(Waterfall) Retrieve Technology technical references](https://docs.trade-wind.co/en/488458549e0.md): If the technologies parameter is used, retrieve it from this endpoint. A single request is sufficient—cache it, as it will not change dynamically.
- 根目录 > Agentic Tasks [(Agent) Task Creation](https://docs.trade-wind.co/en/488458550e0.md): Create an agent-mode lead-generation task (asynchronous). Integrates 100+ global data channels (customs, social media, trade shows, search engines, corporate contact databases, tenders/bids, yellow pages, maps, independent websites, etc.) and intelligently filters potential customers and partners based on company profiles. Searches typically complete in 1-2 hours. Call the task list API to retrieve the task execution status (whether the search is complete).
- 根目录 > Agentic Tasks [(Agent) Task List](https://docs.trade-wind.co/en/488458551e0.md): Retrieve the list of created agent tasks. Use the task data API to obtain task results (leads and contact information).
- 根目录 > Agentic Tasks [(Agent) Task Data](https://docs.trade-wind.co/en/488458552e0.md): Retrieve agent task details, including company and contact information. Call the contact details endpoint to obtain detailed personal information and phone numbers.
- 根目录 > (Waterfall) Company Search  [(Waterfall) Company Search ](https://docs.trade-wind.co/en/488458553e0.md): Waterfall-mode company search (real-time), integrating global data sources such as Apollo, Hunter, RocketReach, Google Map, and Storelead, performs waterfall-style retrieval and offers two return modes: First Match (single-source priority matching) and Aggregate (multi-source data aggregation), leveraging the strengths of multiple sources. Subsequent results (company name or domain) can be used to call the (waterfall) company details API to obtain detailed company information.
- 根目录 > (Waterfall) Company Search  [(Waterfall) Company Enrichment ](https://docs.trade-wind.co/en/488458554e0.md): Waterfall-style real-time company detail query that integrates global data sources such as Apollo, Hunter, and Snovio, performs cascading retrieval, and offers two response modes: First Match (single-source priority matching) and Aggregate (multi-source data aggregation), leveraging the strengths of multiple sources.
- 根目录 > (Waterfall) People Search [(Waterfall) Contact Search](https://docs.trade-wind.co/en/488458555e0.md): Waterfall-mode contact search (real-time) integrates global data providers such as Apollo, Hunter, RocketReach, and Snovio to perform waterfall-style retrieval, offering two data return modes: First Match (single-source priority matching) and Aggregate (multi-source data aggregation), leveraging the strengths of multiple sources. Subsequently, using the returned name, domain, or LinkedIn URL, call the (waterfall) contact details API to obtain detailed contact information.
- 根目录 > (Waterfall) People Search [(Waterfall) Contact Enrichment](https://docs.trade-wind.co/en/488458556e0.md): Real-time contact detail search in waterfall mode, integrating global data sources such as Apollo, Hunter, Snovio, and RocketReach. Performs waterfall-style retrieval and offers two response modes: First Match (single-source priority matching) and Aggregate (multi-source data aggregation), leveraging the strengths of multiple providers.
- 根目录 > Email Verificatioin [Batch Task Result Query (Email Verification)](https://docs.trade-wind.co/en/488458557e0.md): Retrieve batch email verification task results.
- 根目录 > Customs Record Search [(Customs) Country Reference](https://docs.trade-wind.co/en/488458558e0.md): Customs Data API request field reference: customs country/region reference list. Retrieve and cache this list once; it does not change dynamically. Before invoking the Customs Data API, call this endpoint to consult the reference.
- 根目录 > Customs Record Search [Retrieve customs data list](https://docs.trade-wind.co/en/488458559e0.md): Retrieve a list of customs data.
- 根目录 > Customs Record Search [Retrieve list of customs companies](https://docs.trade-wind.co/en/488458560e0.md): Retrieve a list of customs companies.
- 根目录 > Customs Record Search [Retrieve a company's customs status](https://docs.trade-wind.co/en/488458561e0.md): Retrieve customs company status.
- 根目录 > Customs Record Search [Retrieve customs company details](https://docs.trade-wind.co/en/488458562e0.md): Retrieve customs company details.
- 根目录 > Customs Record Search [Retrieve customs company trade trends](https://docs.trade-wind.co/en/488458563e0.md): Retrieve customs company trade trends.
- 根目录 > Customs Record Search [Retrieve a company's customs import and export records](https://docs.trade-wind.co/en/488458564e0.md): Retrieve a company's customs import and export records.
- 根目录 > Customs Record Search [Retrieve customs trade partner records for a company](https://docs.trade-wind.co/en/488458565e0.md): Retrieve customs company trade partner records.
- 根目录 > Customs Record Search [Retrieve customs HS code records for companies](https://docs.trade-wind.co/en/488458566e0.md): Retrieve customs HS code records for a company.
- 根目录 > Customs Record Search [Retrieve list of products purchased or supplied by a customs company](https://docs.trade-wind.co/en/488458567e0.md): Retrieve the list of products procured and supplied by a customs company.
- 根目录 > Customs Record Search [Retrieve trade regions for a customs company](https://docs.trade-wind.co/en/488458568e0.md): Retrieve the customs company's trade regions.
- 根目录 > Customs Record Search [Retrieve statistics for customs, companies, and trade ports](https://docs.trade-wind.co/en/488458569e0.md): Retrieve customs company trade port statistics.
- 根目录 > Customs Record Search [(Customs) Intelligent Mail Search (Legacy)](https://docs.trade-wind.co/en/488458570e0.md): (Customs) Intelligent Mail Search (Legacy)
- 根目录 > Customs Record Search [List of companies matching the company name](https://docs.trade-wind.co/en/488458571e0.md): List of companies matching the company name.
- 根目录 > Customs Record Search [List of contacts matched to the company](https://docs.trade-wind.co/en/488458572e0.md): List of contacts for the matched company.
- 根目录 > Customs Record Search [Retrieve customs procurement trends](https://docs.trade-wind.co/en/488458573e0.md): Retrieve customs procurement trends.
- 根目录 > Customs Record Search [Retrieve global customs regional distribution map](https://docs.trade-wind.co/en/488458574e0.md): Retrieve the global regional distribution map of customs.
- 根目录 > Customs Record Search [Retrieve customs transactions for Chinese suppliers](https://docs.trade-wind.co/en/488458575e0.md): Retrieve customs transactions for Chinese suppliers.
- 根目录 > Customs Record Search [Retrieve customs merchant transactions](https://docs.trade-wind.co/en/488458576e0.md): Retrieve customs merchant transactions.
- 根目录 > Customs Record Search [Retrieve Customs Merchant Transactions (New)](https://docs.trade-wind.co/en/488458577e0.md): Retrieve customs merchant transactions (new).
- 根目录 > Health [GET API liveness probe](https://docs.trade-wind.co/en/488458578e0.md): API liveness probe. Returns HTTP 200 to indicate the API is available.
- 根目录 > Metrics [GET API Operational Metrics](https://docs.trade-wind.co/en/488458579e0.md): Operational monitoring metrics