beveragetradenetwork.com APIbeveragetradenetwork.com ↗
Access brands, buying leads, company directory, membership pricing, and competition results from Beverage Trade Network via a structured JSON API.
curl -X GET 'https://api.parse.bot/scraper/9218f040-e661-49cc-8a33-68804c4edae5/search_brands?page=1&query=whiskey' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for brands on Beverage Trade Network by name. Returns paginated results filtered by keyword. The search matches brand/product names and may return limited results for niche queries.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| query | string | Keyword to search in brand names (e.g. 'vodka', 'wine'). Empty string returns all brands. |
{
"type": "object",
"fields": {
"page": "integer, the current page number",
"query": "string, the search query used",
"brands": "array of brand objects with name, country, category, and url"
},
"sample": {
"data": {
"page": 1,
"query": "vodka",
"brands": [
{
"url": "/en/brands/vodka-1/italy-112/vodka-8065.htm",
"name": "Vodka",
"country": "Italy",
"category": "Vodka"
},
{
"url": "/en/brands/vodka-1/united-states-231/vodka-7132.htm",
"name": "Vodka",
"country": "United States",
"category": "Vodka"
}
]
},
"status": "success"
}
}About the beveragetradenetwork.com API
The Beverage Trade Network API exposes 5 endpoints covering the core data layers of beveragetradenetwork.com: brand search, active buying leads, a company directory, membership pricing, and competition results. The search_brands endpoint accepts keyword and pagination inputs and returns each brand's name, country, category, and URL. The get_buying_leads endpoint surfaces the product and buyer country for each procurement request currently listed on the marketplace.
Brand and Company Discovery
The search_brands endpoint accepts a query string (e.g. 'vodka', 'wine') and an optional page integer for pagination. Results return an array of brand objects, each containing name, country, category, and url. Passing an empty string as query returns all available brands. The get_companies endpoint works similarly — paginate through wineries, distilleries, and importers, with each company object exposing name, type, country, and url.
Buying Leads and Marketplace Activity
The get_buying_leads endpoint returns paginated buying leads from the marketplace. Each lead object includes product (what the buyer is seeking), buyer_country (the buyer's location), and full_title (the complete listing title). This makes it practical to filter procurement opportunities by region or product category in your own application. No additional filters beyond page are supported in the current endpoint.
Pricing and Competition Results
The get_pricing endpoint takes no inputs and returns a pricing_plans array with each plan's name, price, and currency — covering both seller and buyer membership tiers. The get_competition_results endpoint accepts an optional event_id parameter (a year or event identifier) and returns a results array. Results are scoped to competitions hosted via Beverage Trade Network, such as the Sommeliers Choice Awards.
- Build a brand discovery tool filtered by beverage category and country of origin using
search_brands. - Monitor active procurement opportunities by polling
get_buying_leadsfor new product requests by buyer country. - Map the global distribution of wineries and distilleries by iterating
get_companiesand grouping bycountry. - Benchmark membership pricing tiers before signing up as a seller or buyer using
get_pricing. - Track award standings across competition years by querying
get_competition_resultswith differentevent_idvalues. - Aggregate brand and company data for a beverage industry CRM or lead-qualification pipeline.
- Cross-reference buying leads against the company directory to identify potential supplier matches.
| 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 Beverage Trade Network offer an official developer API?+
What does `get_buying_leads` return and can I filter leads by product category?+
product, buyer_country, and full_title. The endpoint only accepts a page integer; there is no server-side filter for product category or country. You would need to filter the returned array client-side.Does the `get_competition_results` endpoint return individual scores or just rankings?+
results array scoped to the event identified by event_id. The response schema is not deeply structured beyond that array — individual medal scores, judge details, and per-wine breakdowns are not currently exposed. You can fork this API on Parse and revise it to add a more detailed results endpoint if that data is available on the source page.Is contact information (email, phone) included for companies or brands?+
get_companies endpoint returns name, type, country, and url, while search_brands returns name, country, category, and url. Direct contact details are not in the current response fields. You can fork this API on Parse and revise it to add contact data if it is exposed on individual company or brand profile pages.How far back do buying leads go — is there a date field?+
get_buying_leads endpoint does not include a date or timestamp field on lead objects. It reflects the leads currently visible in the marketplace listing. Historical lead archives are not covered by the current endpoint.