giftcards.com APIgiftcards.com ↗
Access GiftCards.com product data via API. Search gift cards by keyword, paginate results, and retrieve active discounts and promotional rules across brands.
curl -X GET 'https://api.parse.bot/scraper/bc97929b-0f5a-4876-9c35-f79451afc3a4/search_gift_cards?page=1&limit=3&query=starbucks' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for gift cards by keyword. Returns a paginated list of gift card products with their names, brands, categories, available amounts, and variant details.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| limit | integer | Maximum number of results per page. |
| query | string | Search keyword (e.g. 'amazon', 'starbucks', 'visa'). Empty string returns all products. |
{
"type": "object",
"fields": {
"products": "array of gift card product objects with name, brand_name, url_key, sku, currency, base_image, giftcard_amounts, categories, badges, and variants",
"total_count": "integer total number of matching products",
"total_pages": "integer total number of pages",
"current_page": "integer current page number"
},
"sample": {
"data": {
"products": [
{
"sku": "ZJTSJR1N9WK1JBWBQG3686G40C",
"name": "Starbucks",
"badges": [],
"url_key": "starbucks-gift-card",
"currency": "USD",
"variants": [
{
"product": {
"sku": "07675006121",
"name": "Starbucks Gift Card",
"giftcard_amounts": [
{
"value": 50
},
{
"value": 100
},
{
"value": 250
}
]
}
}
],
"base_image": "https://www.giftcards.com/content/dam/bhn/live/nam/us/en/catalog-assets/product-images/07675006121/07675006121_82516_master.png/_jcr_content/renditions/cq5dam.web.1280.1280.jpeg",
"brand_name": "Starbucks®",
"categories": [
{
"name": "Occasions",
"url_key": "occasions"
},
{
"name": "Most Popular Gift Cards",
"url_key": "most-popular-gift-cards"
}
],
"giftcard_amounts": []
}
],
"total_count": 66,
"total_pages": 22,
"current_page": 1
},
"status": "success"
}
}About the giftcards.com API
The GiftCards.com API exposes 2 endpoints that cover product search and discount discovery across the GiftCards.com catalog. search_gift_cards returns paginated results with names, brands, available denominations, categories, and variant details, while get_discounted_cards surfaces cards that currently carry active promotions, badges, and sales rules — giving you the data needed to compare gift card pricing and deals programmatically.
Search Gift Cards
The search_gift_cards endpoint accepts a query string (e.g. 'amazon', 'visa', 'starbucks'), along with page and limit integers for pagination. Every product object in the products array includes name, brand_name, url_key, sku, currency, base_image, giftcard_amounts, categories, and badges. The total_count, total_pages, and current_page fields let you iterate through the full catalog — passing an empty string for query returns all available products.
Discounted and Promotional Cards
get_discounted_cards returns only cards with active promotions. Each result includes name, brand_name, badges, and sales_rules. The sales_rules array contains the specific conditions and discount parameters attached to that card at the time of the request, making it straightforward to identify which brands are currently running deals and what the promotion details look like.
Data Shape and Coverage
Response objects from search_gift_cards include giftcard_amounts, which lists the denominations available for each product. The categories field reflects how GiftCards.com classifies each product (e.g. retail, restaurant, entertainment), and badges indicate featured or promoted status. These fields are consistent across both endpoints, so a card returned by get_discounted_cards can be cross-referenced against search_gift_cards results using sku or url_key.
- Monitor which gift card brands currently have active discounts using
sales_rulesfromget_discounted_cards. - Build a gift card search widget that queries by brand name and paginates through results using
pageandlimit. - Track available denominations for specific cards by inspecting
giftcard_amountsacross search results. - Categorize gift card inventory by brand and category using the
categoriesandbrand_namefields. - Alert users when a specific brand (e.g. 'amazon') appears in discounted card results by periodically polling
get_discounted_cards. - Aggregate gift card catalog data by iterating all pages with an empty
queryand collectingskuandbase_imagefields. - Compare badge and promotion status between search results and discounted cards using the shared
badgesfield.
| 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 GiftCards.com have an official developer API?+
What does `get_discounted_cards` return, and how does it differ from `search_gift_cards`?+
get_discounted_cards returns only cards with active promotions and includes a sales_rules array detailing the promotion conditions for each card. It takes no input parameters. search_gift_cards, by contrast, covers the full catalog and supports keyword filtering and pagination, but its results may include cards with no active discount.Does the API return individual gift card purchase links or checkout URLs?+
url_key and sku identifiers that correspond to product pages on GiftCards.com, but direct checkout or purchase URLs are not included as response fields. You can fork this API on Parse and revise it to construct or expose full product URLs if needed.Can I filter search results by category or denomination?+
search_gift_cards endpoint accepts a query keyword string but does not expose dedicated category or amount filter parameters. The categories and giftcard_amounts fields are present in the response, so you can filter results client-side after retrieval. You can fork this API on Parse and revise it to add server-side filtering by those fields.