giftcardgranny.com APIgiftcardgranny.com ↗
Access Gift Card Granny's full catalog via API: search gift cards, browse categories, fetch discounts, and retrieve merchant ratings and denominations.
curl -X GET 'https://api.parse.bot/scraper/45e00f31-3f3d-4f1e-a5fe-1b70bbdaca24/search_gift_cards?page=0&limit=5&query=target' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for gift cards by brand or keyword using Algolia search. Returns paginated results with merchant details including categories, types, and discount information.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number (0-indexed). |
| limit | integer | Number of results per page. |
| query | string | Search keyword (e.g., 'target', 'starbucks'). Omitting returns all available gift cards. |
{
"type": "object",
"fields": {
"hits": "array of merchant objects with name, relativeUrl, categories, types, discount info",
"page": "current page number (0-indexed)",
"nbHits": "total number of matching results",
"nbPages": "total number of pages"
},
"sample": {
"data": {
"hits": [
{
"name": "Target",
"types": [
"plastic",
"egift"
],
"popular": true,
"categories": [
"Back to School",
"Birthday",
"Department Stores"
],
"egift_rank": 1,
"merchantId": 48,
"relativeUrl": "/buy-gift-cards/target/",
"discount_rank": null,
"gift_cards_rank": 1,
"max_cash_back_percentage": 0,
"promo_discount_percentage": null
}
],
"page": 0,
"nbHits": 5,
"nbPages": 1
},
"status": "success"
}
}About the giftcardgranny.com API
The Gift Card Granny API exposes 7 endpoints covering the platform's full gift card catalog, including merchant metadata, category listings, current discount percentages, and featured deals. Use search_gift_cards to query by brand keyword and receive paginated merchant objects with discount info, or call get_gift_card_detail to retrieve denominations, ratings, and full merchant metadata for any specific brand slug.
Search and Catalog Access
The search_gift_cards endpoint accepts a query string (e.g., 'target' or 'starbucks'), a 0-indexed page parameter, and a limit for page size. The response includes a hits array of merchant objects — each carrying name, relativeUrl, categories, types, and promo_discount_percentage — along with nbHits and nbPages for pagination. Omitting the query parameter returns the full catalog.
Brand Detail and Category Browsing
get_gift_card_detail takes a brand_slug (e.g., 'dutch-brothers-coffee') and returns the brand's full URL, rating, rating_count, available denominations as dollar-amount strings, and a complete merchant metadata object including category and rank fields. To browse by vertical, call list_all_categories first — it returns each category's name and merchant count — then pass that exact name to browse_gift_cards_by_category, which returns a filtered, paginated hits array.
Discounts and Featured Deals
get_discounted_gift_cards returns merchants sorted by discount_rank, with each object including a promo_discount_percentage field that reflects the current best available discount. get_granny_deals fetches the homepage-featured promotions as an array of deal objects containing brand_slug, discount percentage, and a full URL — useful for surfacing time-sensitive offers.
Card Activation
The activate_card POST endpoint accepts a 16-digit card_number and 3-digit cvv and returns an html_response_preview reflecting the activation result. This covers Gift Card Granny-issued cards only.
- Build a browser extension that surfaces the best
promo_discount_percentagefor a retailer before checkout - Aggregate daily deal alerts using
get_granny_dealsto notify users of new homepage promotions - Populate a gift card comparison tool using
search_gift_cardsresults including merchant categories and types - Display available
denominationsalongside ratings fromget_gift_card_detailon a gift recommendation app - Build a category-filtered gift card directory using
list_all_categoriescounts andbrowse_gift_cards_by_categoryhits - Track discount rank changes over time by polling
get_discounted_gift_cardsand storingdiscount_rankvalues
| 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 Gift Card Granny have an official developer API?+
What does `get_gift_card_detail` return beyond what search results include?+
get_gift_card_detail adds fields not present in search results: the denominations array (e.g., ['$5', '$25', '$50']), rating as an average star value, and rating_count. The merchant object also includes rank fields that are absent from the paginated search hits.Does the API expose individual seller listings or secondary-market pricing for gift cards?+
How is pagination handled across endpoints?+
search_gift_cards and browse_gift_cards_by_category endpoints accept both page and limit parameters. get_discounted_gift_cards accepts page but not a configurable limit. Every paginated response includes nbHits and nbPages so you can calculate total result counts before iterating.Does the API return historical discount data or only current offers?+
promo_discount_percentage and discount_rank fields in get_discounted_gift_cards and get_granny_deals reflect what is active at the time of the request. No historical pricing or discount trend data is exposed. You can fork this API on Parse and add a persistence layer or scheduled polling endpoint to track changes over time.