Google Maps Spend Card Keys

info

This returns the spend rate for up to ten credit cards based on the Google Maps business name or category name

HTTP REQUEST

GET /creditcard-spend-googlemaps-cardkeys/{googleMapsBusinessName}/{googleMapsCategoryName}/{cardKey1}/{cardKey2}/{cardKey3}/{cardKey4}/{cardKey5}/{cardKey6}/{cardKey7}/{cardKey8}/{cardKey9}/{cardKey10}

RESPONSE

[
  {
    "cardkey": "afcu-securedvisa",
    "cardName": "America First Credit Union Secured Visa",
    "cardIssuer": "America First Credit Union",
    "earnRate": 0.0,
    "isBonusRate": 0,
    "baseSpendAmount": 0.0,
    "baseSpendEarnType": "",
    "baseSpendEarnCurrency": "",
    "googleMapsBusinessName": "Town & Country Market Shoreline",
    "googleMapsCategoryName": "Grocery store"
  },
  {
    "cardkey": "amex-deltagold",
    "cardName": "Delta SkyMiles® Gold American Express",
    "cardIssuer": "American Express",
    "earnRate": 2.0,
    "isBonusRate": 1,
    "baseSpendAmount": 1.0,
    "baseSpendEarnType": "Delta SkyMiles",
    "baseSpendEarnCurrency": "Airline",
    "googleMapsBusinessName": "Town & Country Market Shoreline",
    "googleMapsCategoryName": "Grocery store"
  },
  {
    "cardkey": "chase-freedomflex",
    "cardName": "Chase Freedom Flex®",
    "cardIssuer": "Chase",
    "earnRate": 1.0,
    "isBonusRate": 0,
    "baseSpendAmount": 1.0,
    "baseSpendEarnType": "Cash",
    "baseSpendEarnCurrency": "Cash",
    "googleMapsBusinessName": "Town & Country Market Shoreline",
    "googleMapsCategoryName": "Grocery store"
  },
  {
    "cardkey": "comenity-aaadaily",
    "cardName": "AAA Daily Advantage Visa Signature®",
    "cardIssuer": "Comenity",
    "earnRate": 5.0,
    "isBonusRate": 1,
    "baseSpendAmount": 1.0,
    "baseSpendEarnType": "Cash",
    "baseSpendEarnCurrency": "Cash",
    "googleMapsBusinessName": "Town & Country Market Shoreline",
    "googleMapsCategoryName": "Grocery store"
  },
  {
    "cardkey": "comenity-aaatravel",
    "cardName": "AAA Travel Advantage Visa Signature®",
    "cardIssuer": "Comenity",
    "earnRate": 5.0,
    "isBonusRate": 1,
    "baseSpendAmount": 1.0,
    "baseSpendEarnType": "Cash",
    "baseSpendEarnCurrency": "Cash",
    "googleMapsBusinessName": "Town & Country Market Shoreline",
    "googleMapsCategoryName": "Grocery store"
  },
  {
    "cardkey": "creditone-platinumx5",
    "cardName": "Credit One Platinum X5 Visa",
    "cardIssuer": "Credit One",
    "earnRate": 5.0,
    "isBonusRate": 1,
    "baseSpendAmount": 1.0,
    "baseSpendEarnType": "Cash",
    "baseSpendEarnCurrency": "Cash",
    "googleMapsBusinessName": "Town & Country Market Shoreline",
    "googleMapsCategoryName": "Grocery store"
  },
  {
    "cardkey": "usalliance-visasig",
    "cardName": "USALLIANCE Financial Visa Signature",
    "cardIssuer": "USALLIANCE Financial",
    "earnRate": 6.0,
    "isBonusRate": 1,
    "baseSpendAmount": 2.0,
    "baseSpendEarnType": "USALLIANCE Financial Rewards",
    "baseSpendEarnCurrency": "Flex point",
    "googleMapsBusinessName": "Town & Country Market Shoreline",
    "googleMapsCategoryName": "Grocery store"
  }
]

Response Attributes

NAME	TYPE	DESCRIPTION
cardKey	string	Rewards Credit Card API unique card key
cardName	string	Name of credit card
cardIssuer	string	Issuing bank
earnRate	number	Points earned per dollar spend
isBonusRate	bit	Is the rate higher than the base rate? (0=no, 1=yes)
baseSpendAmount	number	Base points earned per dollar spend
baseSpendEarnType	string	Redemption program (e.g. American AAdvantage)
baseSpendEarnCurrency	string	Spend earning currenty type (rewards, miles, cashback, crypto, points)
googleMapsBusinessName	string	Google Maps business name
googleMapsCategoryName	string	Google Maps category/primaryType

Notes

• earnRate is approximate and can very from bank to bank as well as how the business is cateogorized

Path Parameters

NAME	TYPE	DESCRIPTION	REQUIRED
businessName	string	Google Maps business name	Yes
categoryName	string	Google Maps category/primaryType	Yes
cardKey1	string	unique Rewards CC key ID	Yes
cardKey2	string	unique Rewards CC key ID	Yes
cardKey3	string	unique Rewards CC key ID	Yes
cardKey4	string	unique Rewards CC key ID	Yes
cardKey5	string	unique Rewards CC key ID	Yes
cardKey6	string	unique Rewards CC key ID	Yes
cardKey7	string	unique Rewards CC key ID	Yes
cardKey8	string	unique Rewards CC key ID	Yes
cardKey9	string	unique Rewards CC key ID	Yes
cardKey10	string	unique Rewards CC key ID	Yes

Notes

• All ten card keys are required - if not all ten are requested then leave "cardKey5", etc in the URL

  • Example from the above JSON sample request:

    HTTP REQUEST

    GET /creditcard-spend-googlemaps-cardkeys/Town%2520%2526%2520Country%2520Market%2520Shoreline/Grocery%2520store/usalliance-visasig/chase-freedomflex/comenity-aaadaily/comenity-aaatravel/creditone-platinumx5/afcu-securedvisa/amex-deltagold/cardkey8/cardkey9/cardkey10/

• businessName and categoryName must be URL encoded

  • Reference here: https://www.w3schools.com/tags/ref_urlencode.ASP
  • For spaces use %20 (not +)

• All three parameters are required

• In the image below the parameter values

  • cardKey: amex-hilton
  • businessName: Town%20%26%20Country%20Market%20Shoreline
  • categoryName: Grocery%20store

Google Maps Business Page

Google Maps API

• Refer to the Place Details API endpoint and the Place ID identifier

• Example: https://places.googleapis.com/v1/places/ChIJw7F5Gd8QkFQRFFAvvucJr94?fields=id,displayName&key=API_KEY

• Use value in primaryTypeDisplayName / text

RESPONSE

[
  {
  "id": "ChIJw7F5Gd8QkFQRFFAvvucJr94",
  "displayName": {
    "text": "Town & Country Market Shoreline",
    "languageCode": "en"
  },
  "primaryTypeDisplayName": {
    "text": "Grocery Store",
    "languageCode": "en-US"
  }
  }
]

Data Source(s)

Bank websites, Google Maps