Fetch the complete documentation index at: https://docs.tcgplayer.com/llms.txt. Use this file to discover all available pages before exploring further.

# External Kickbacks API

Run this script to determine if TCGplayer is running and active kickback and it's details

[block:api-header]
{
  "title": "How do I implement?"
}
[/block]

The URL is listed here:

<https://kickbacks-api.tcgplayer.com/Kickbacks?api-version=1.0>

You will want to run a script that calls this endpoint approximately once an hour and save the results to a database in order to reference for your site/page/application.

[block:api-header]
{
  "title": "What will it return?"
}
[/block]

As an affiliate utilizing this endpoint, you will be able to see the following info:

* Active dates and times of the kickback, in Eastern Standard Time
* Percentage for the active kickback
* What the kickback applies to (product lines, product types)

The call will return "NULL" if the is currently no active kickback. Examples are below.

[block:code]
{
  "codes": [
    {
      "code": "{\n\t\"startDateTime\": \"06/14/2019 12:00:00\",\n\t\"endDateTime\": \"06/17/2019 22:00:00\",\n\t\"percent\": \"5.00\",\n\t\"productTypes\": [\n\t\t\"Singles\"\n\t],\n\t\"productLines\": [\n\t\t\"Bakugan TCG\",\n\t\t\"Cardfight Vanguard\",\n\t\t\"Dice Masters\",\n\t\t\"Dragoborne\",\n\t\t\"Dragon Ball Super CCG\",\n\t\t\"Dragon Ball Z TCG\",\n\t\t\"Exodus TCG\",\n\t\t\"Final Fantasy TCG\",\n\t\t\"Force of Will\",\n\t\t\"Future Card BuddyFight\",\n\t\t\"Lightseekers TCG\",\n\t\t\"Magic\",\n\t\t\"MetaX TCG\",\n\t\t\"Munchkin CCG\",\n\t\t\"My Little Pony CCG\",\n\t\t\"Pokemon\",\n\t\t\"Star Wars Destiny\",\n\t\t\"The Caster Chronicles\",\n\t\t\"Transformers TCG\",\n\t\t\"Universal Fighting System\",\n\t\t\"Warhammer Age of Sigmar Champions TCG\",\n\t\t\"Weiss Schwarz\",\n\t\t\"WoW\",\n\t\t\"YuGiOh\",\n\t\t\"Zombie World Order TCG\"\n\t]\n}",
      "language": "json",
      "name": "Kickback Example"
    }
  ]
}
[/block]

[block:code]
{
  "codes": [
    {
      "code": "{\n\t\"startDateTime\": null,\n\t\"endDateTime\": null,\n\t\"percent\": null,\n\t\"productTypes\": null,\n\t\"productLines\": null\n}",
      "language": "json",
      "name": "No Kickback Example"
    }
  ]
}
[/block]

[block:api-header]
{
  "title": "How can I utilize this?"
}
[/block]

We typically see a 30%-40% increase in affiliate revenue when kickbacks are running and your community is made aware of it. Some examples of how you can use this data and inform your audience include:

* Activating graphics or text with the current sale percentage next to TCGplayer links or prices
* Updating prices to reflect kickback percentage
* Changing ad space to include new kickback advertisement (provided by TCGplayer)