Buysellvoucher APIbuysellvoucher.com ↗
Search, retrieve details, and programmatically purchase gift cards and vouchers listed on BuySellVouchers.com via a structured JSON API.
What is the Buysellvoucher API?
The BuySellVouchers API exposes 4 endpoints covering product search, listing details, wallet balance retrieval, and purchase initiation for gift cards and vouchers on buysellvouchers.com. The search_products endpoint returns matching listings with their name, category, slug, and URL in a single unpaginated response, while get_product_details delivers per-listing price, stock status, seller name, and title using the category and slug values from search results.
curl -X GET 'https://api.parse.bot/scraper/f0afc833-6bcd-4078-9acf-46e0f46c2dbb/search_products?query=Amazon' \ -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 buysellvoucher-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.
"""Walkthrough: BuySellVouchers SDK — search gift cards and view product details."""
from parse_apis.buysellvouchers_api import BuySellVouchers, Product, ProductDetails, ProductNotFound
client = BuySellVouchers()
# Search for Amazon gift cards — limit caps total items fetched
for product in client.products.search(query="Amazon", limit=5):
print(product.name, product.category, product.slug)
# Drill-down: take one product and get its full details
product = client.products.search(query="Steam", limit=1).first()
if product:
details = product.details()
print(details.title, details.price, details.seller, details.stock)
# Typed error handling for a product that doesn't exist
try:
bad_product = Product(_api=client, slug="nonexistent123", category="Invalid-Category")
bad_product.details()
except ProductNotFound as exc:
print(f"Product not found: {exc}")
print("exercised: products.search / product.details / ProductNotFound error handling")
Search for gift cards and vouchers by keyword. Returns a list of matching products with their name, category, slug, and listing URL. Results are not paginated — a single request returns all matches for the query. Each product's category and slug can be passed to get_product_details to retrieve pricing and stock.
| Param | Type | Description |
|---|---|---|
| query | string | Search keyword to filter products by name (e.g. 'Amazon', 'Netflix', 'Steam', 'Google Play'). |
{
"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/2980135373432333/",
"name": "Amazon Gift card USA 500 USD",
"slug": "2980135373432333",
"category": "Gift_cards-Amazon_Gift_cards"
},
{
"url": "https://www.buysellvouchers.com/en/products/view/Gift_cards-Amazon_Gift_cards/2a67132393835323/",
"name": "100$ Amazon gift card Stockable",
"slug": "2a67132393835323",
"category": "Gift_cards-Amazon_Gift_cards"
}
]
},
"status": "success"
}
}About the Buysellvoucher API
Search and Browse Listings
The search_products endpoint accepts an optional query string and returns all matching gift card and voucher products in one response — no pagination handling required. Each item in the products array includes a name, category slug, product slug, and a direct url to the listing. The count field gives the total number of matches. The category and slug fields from these results are the required inputs for the detail endpoint.
Product Details and Availability
get_product_details takes a slug (e.g. '2a67132393835323') and a category (e.g. 'Gift_cards-Amazon_Gift_cards') and returns structured data for that specific listing: title, price (a dollar-prefixed string or null), stock (availability text or null), and seller (seller name or null). Fields not present on the original listing return null rather than being omitted, so response shapes are consistent.
Wallet Balance and Purchase Flow
get_balance returns the current wallet balances object with no required inputs — useful for checking available funds before initiating a transaction. initiate_purchase accepts a slug, category, buyer email, optional quantity, and an optional currency_id (216 for USDT TRC20, 253 for USDC Polygon). On success it returns a message string and a payment_page_url to complete the transaction.
Data Scope and Behavior
All product data reflects what is available on public and authenticated listing pages of buysellvouchers.com. Search results are returned in full without page-by-page iteration. Price and stock fields can be null when a listing does not display those values. The purchase endpoint initiates a transaction but does not confirm delivery — the returned payment_page_url is where payment is completed.
The Buysellvoucher API is a managed, monitored endpoint for buysellvoucher.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when buysellvoucher.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 buysellvoucher.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?+
- Monitor gift card prices across categories by polling
get_product_detailsfor tracked slugs - Build a deal-alert tool that runs
search_productsfor specific brands and flags listings below a target price - Automate bulk voucher purchasing workflows using
initiate_purchasewith USDT or USDC payment - Check wallet balance via
get_balancebefore queuing a batch of purchase requests - Aggregate stock availability across multiple product slugs to detect when out-of-stock cards are replenished
- Index gift card category and seller data from search results for comparison or resale analytics
- Route purchase delivery to the correct email programmatically by passing
emailininitiate_purchase
| 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 BuySellVouchers have an official developer API?+
What does `search_products` return, and is the result set paginated?+
products array and a count integer. Each object contains name, category, slug, and url. Results are not paginated — all matches for the query are returned in a single response, so no page or offset parameter is needed.Can the API return transaction history or delivery status after a purchase?+
initiate_purchase) and returns a payment_page_url, but does not expose order history, delivery confirmation, or post-payment status. You can fork this API on Parse and revise it to add an endpoint covering order tracking if that data becomes accessible.Are seller ratings or reviews available through `get_product_details`?+
get_product_details returns title, price, stock, and seller name. Seller reputation scores or buyer reviews are not included in the response. You can fork this API on Parse and revise it to add a seller-detail endpoint if that data is needed.What happens when a field like price or stock is missing from a listing?+
get_product_details returns null for fields not present on the listing — for example, price will be null rather than omitted if the listing does not display a price. This keeps the response shape consistent regardless of how complete the original listing is.