buysellvoucher.com APIbuysellvoucher.com ↗
Search, inspect, and purchase gift cards on BuySellVouchers via API. Access product details, seller info, stock, pricing, and wallet balances across 4 endpoints.
curl -X GET 'https://api.parse.bot/scraper/f0afc833-6bcd-4078-9acf-46e0f46c2dbb/search_products?query=Amazon' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for gift cards and vouchers by keyword. Returns a list of matching products with their category, slug, and listing URL.
| Param | Type | Description |
|---|---|---|
| query | string | Search keyword to filter products. |
{
"type": "object",
"fields": {
"count": "integer total number of products returned",
"products": "array of product objects each containing name, category, slug, and url"
},
"sample": {
"data": {
"count": 24,
"products": [
{
"url": "https://www.buysellvouchers.com/en/products/view/Gift_cards-Amazon_Gift_cards/bc129363438373/",
"name": "Amazon.au 10 AUD | Australia10Sold$7.43Buy now",
"slug": "bc129363438373",
"category": "Gift_cards-Amazon_Gift_cards"
}
]
},
"status": "success"
}
}About the buysellvoucher.com API
The BuySellVouchers API provides 4 endpoints to search, inspect, and programmatically purchase gift cards and vouchers from buysellvoucher.com. The search_products endpoint lets you query the catalog by keyword and returns each result's name, category, slug, and listing URL. From there you can retrieve full listing details — including price, stock status, and seller name — and proceed to initiate a purchase with integrated payment routing.
Catalog Search and Product Lookup
The search_products endpoint accepts an optional query string and returns a count plus an array of product objects, each containing name, category, slug, and url. These category and slug values are the keys you pass into get_product_details to retrieve listing-level data: title, price (a USD string), stock (availability text), and seller (the merchant's display name). This two-step pattern — search then detail — mirrors the site's browse-and-inspect flow.
Purchase Flow
Once you have a slug and category, you can call initiate_purchase with a delivery email, an optional quantity, and a currency_id to select your payment method. Supported currency IDs include 216 for USDT TRC20 and 253 for USDC Polygon. The endpoint returns a message and a payment_page_url where the transaction is completed. This is the only endpoint that writes state, so treat it accordingly in test environments.
Wallet Balance
The get_balance endpoint takes no parameters and returns a balances object reflecting the current state of your account wallet. This is useful for pre-purchase checks or reconciliation workflows, particularly when automating bulk buying across multiple listings.
Data Scope and Freshness
All product data — pricing, stock text, and seller identity — reflects what is present on the listing at query time. The API does not expose historical price data, review counts, or seller ratings beyond the seller name field. Category and slug values from search_products results are the canonical identifiers for downstream calls, so store them if you need to re-query a known product without repeating a search.
- Monitor gift card availability and price changes by polling
get_product_detailsfor specific slugs - Build a gift card comparison tool by running
search_productsqueries for multiple brands and collecting price fields - Automate bulk gift card purchasing workflows using
initiate_purchasewith USDT or USDC payment options - Check wallet balance before initiating purchases to ensure sufficient funds via
get_balance - Index the BuySellVouchers catalog by category using
search_productsto power an internal gift card directory - Alert when a specific product's
stockfield changes from out-of-stock to available
| 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 BuySellVouchers have an official developer API?+
What does `get_product_details` return beyond the search results?+
search_products returns only name, category, slug, and url. Calling get_product_details with the matching category and slug adds price (a USD string with dollar sign), stock (availability text), title (the full listing title), and seller (the seller's display name).Does the API expose seller ratings or review counts?+
seller name, price, stock, and title at the listing level, but no seller reputation scores or buyer review counts. You can fork the API on Parse and revise it to add an endpoint covering seller profile data if that field becomes accessible.Can I retrieve voucher codes or delivery details after a completed purchase?+
initiate_purchase returns a message and a payment_page_url to complete the transaction, but post-purchase voucher code retrieval is not covered by the current endpoints. You can fork the API on Parse and revise it to add an order-status or delivery endpoint.Are there pagination controls for `search_products` results?+
search_products endpoint returns a count and a flat products array without pagination parameters like page or limit in the current spec. If the catalog query returns a large result set, you cannot currently page through it in chunks. You can fork the API on Parse and revise it to add pagination support.