Kongpanions

Kongpanions are original characters that players on Kongregate can collect by earning "badges of the day" each week. A single badge of the day during a calendar week earns the regular Kongpanion, while earning 5 badges of the day within a week will upgrade it to the "shiny" version of the character. While these are fun items to show off on your profile, we've also put together a simple API that allows games to find out what Kongpanions a player has collected and incorporate them within the game.

Example: Shiny Kongbot and regular Puff Catty

Overview

Developers can integrate Kongpanions that users have earned into their games. You can see an example of this in Please Don't Eat Me, in which the player can equip Kongpanions to improve stats and join them in flight.

Structurally, a Kongpanion is very simple - it has a name and single image, with an alternate image for the shiny version. The value, strengths, and attributes of each Kongpanion are entirely open to you the developer to interpret. We also are tracking tags on Kongpanions, which will become more useful as a filtering method once the Kongpanion library grows.

Note that at this time there is no guarantee that a player will have at least one Kongpanion. If you detect that a player has none, you should let them know and provide a link to http://www.kongregate.com/kongpanions so they can go and earn one right away.

Accessing Kongpanions

You can use the following HTTP APIs to obtain Kongpanion data. These endpoints can be accessed via AJAX, Flash, and Unity clients as well:

Kongpanions: Get a list of all Kongpanions
Kongpanions - User: Get a list of Kongpanions for a user