Welcome to the GiftCard Calculator API! This API allows you to programmatically access gift card options based on specific parameters like service cost, payment interval, and gift card type. Integrate our API into your applications to find the best gift card deals for digital subscriptions and services.
To use the GiftCard Calculator API, you need to obtain a unique API key. Please send an email to contact@giftcard-calculator.com with the subject line "API Key Request" and include the following information:
We will review your request and respond with your API key within 1-2 business days.
All API requests must include your API key as a query parameter named api_key. Requests without a valid API key will be rejected.
All API requests are made to the following base URL:
https://www.giftcard-calculator.com/api.phpGET /api.php
Retrieve gift card options based on specified parameters.
string): Your unique API key.string): The type of gift card you're interested in. Examples:
apple_usspotify_denetflix_frfloat): The amount you need to pay for the service (e.g., monthly subscription fee).string): Payment interval for the service. Valid values:
monthly (default)yearlystring): Name of the service you want to pay for (e.g., "Netflix").string): Language code for the response. Valid values:
en_usd (default)en_gbpdefresitptnlResponses are returned in JSON format.
string): The gift card type specified in the request.float): The service cost specified in the request.string): The payment interval specified in the request.string): The service name specified in the request.string): Currency symbol for prices (e.g., USD, GBP, EUR).array): Array of gift card options. Each option includes:
float): Balance of the gift card in local currency.float): Price of the gift card in Euros.string): URL to purchase the gift card.string): Image URL of the gift card.string): Provider of the gift card (e.g., "Kinguin").integer): Number of months the gift card covers.float): Remaining balance after usage.float): Effective price in Euros based on used balance.string): Monthly cost in the selected currency.If an error occurs, the API returns a JSON object with an error field containing the error message.
{
"error": "Error message here."
}
Retrieve gift card options for paying for Spotify with a monthly cost of €9.99 using German gift cards.
Request:
GET https://www.giftcard-calculator.com/api.php?api_key=YOUR_API_KEY&giftcardType=spotify_de&serviceCost=9.99&paymentInterval=monthly&serviceName=Spotify&language=en_usd
Parameters:
api_key: Your API key.giftcardType: spotify_deserviceCost: 9.99paymentInterval: monthlyserviceName: Spotifylanguage: en_usd{
"giftcardType": "spotify_de",
"serviceCost": 9.99,
"paymentInterval": "monthly",
"serviceName": "Spotify",
"currency": "USD",
"results": [
{
"balanceLocal": 10,
"priceEuro": 9.60,
"link": "https://provider.com/buy/spotify_de_10",
"image": "https://www.giftcard-calculator.com/images/spotify_de_10.png",
"provider": "Kinguin",
"months": 1,
"remainingBalance": 0.01,
"effectivePriceEuro": 9.60,
"monthlyCost": "10.56"
},
{
"balanceLocal": 30,
"priceEuro": 27.00,
"link": "https://provider.com/buy/spotify_de_30",
"image": "https://www.giftcard-calculator.com/images/spotify_de_30.png",
"provider": "G2A",
"months": 3,
"remainingBalance": 0.03,
"effectivePriceEuro": 27.00,
"monthlyCost": "9.90"
}
// Additional results...
]
}
Request:
GET https://www.giftcard-calculator.com/api.php?giftcardType=spotify_de&serviceCost=9.99
Response:
{
"error": "API key is required."
}
Request:
GET https://www.giftcard-calculator.com/api.php?api_key=INVALID_KEY&giftcardType=spotify_de&serviceCost=9.99
Response:
{
"error": "Invalid API key."
}
Request:
GET https://www.giftcard-calculator.com/api.php?api_key=YOUR_API_KEY&serviceCost=9.99
Response:
{
"error": "Parameter \"giftcardType\" is required."
}
. as the decimal separator for all monetary values.By using the GiftCard Calculator API, you agree to:
We reserve the right to suspend or terminate access for users who violate these terms.
If you have questions, need support, or wish to request additional features, please contact us:
We are here to help and typically respond within 1-2 business days.