creature

Spore API

Typists

Share

Home  |   Gallery  |   Documentation  |   Forum

To make your own Spore Apps start here. The quick reference sheet below lists all the web services and data available to you. Download our sample code and extend it to build your own apps. You can always head over to the forum to discuss ideas and ask questions.


Sample Code

The Spore API is cross platform. You can develop an application using Spore data in the environment of your choice. We have some libraries and samples for popular platforms to get you started. Click on the icons to to get going!





Quick Reference Sheets

These are handy cut-out lists of all the Spore API web services.

Cut along the dashed lines  



REST Service

Stats: Get daily stats about Spore.com
http://www.spore.com/rest/stats

Creature Stats: Get various stats like height, diet, abilities etc. for a creature, if you know it's asset Id
http://www.spore.com/rest/creature/<CreatureAssetId>
http://www.spore.com/rest/creature/500267423060

Profile Info: Get profile pic, tagline, user id and creation date for a username
http://www.spore.com/rest/user/<Username>
http://www.spore.com/rest/user/MaxisDangerousYams

Assets for User: Get asset id, name, creation date, type, parent and rating for a list of assets created by a user
http://www.spore.com/rest/assets/user/<Username>/<StartIndex>/<Length>
http://www.spore.com/rest/assets/user/MaxisCactus/0/3

Sporecasts for User: Get id, name, tags, subscription count, rating etc. for Sporecasts subscribed to by a user
http://www.spore.com/rest/sporecasts/<Username>
http://www.spore.com/rest/sporecasts/MaxisMichael

Assets for Sporecast: Get asset id, and name for assets in a sporecast
http://www.spore.com/rest/assets/sporecast/<Sporecast Id>/<StartIndex>/<Length>
http://www.spore.com/rest/assets/sporecast/500190457259/2/3

Achievements for User: Get number of achievements for user and a list of achievement ids and unlock-dates
http://www.spore.com/rest/assets/achievements/<Username>/<StartIndex>/<Length>
http://www.spore.com/rest/achievements/MaxisLucky/0/5

Info about an asset: For a given asset id, get name, description, tags, 10 latest comments, type, parent, rating, creation date and author name/id
http://www.spore.com/rest/asset/<AssetId>
http://www.spore.com/rest/asset/500005649853

Comments for an asset: For a given asset id, get a list of comments, sender names and comment dates
http://www.spore.com/rest/comments/<AssetId>/<StartIndex>/<Length>
http://www.spore.com/rest/comments/500226147573/0/5

Buddies for user: For a given username, get a list of buddy names and ids and total buddy count
http://www.spore.com/rest/users/buddies/<Username>/<StartIndex>/<Length>
http://www.spore.com/rest/users/buddies/MaxisDangerousYams/0/10

Who has added a user as a buddy: For a given username, get the list of users who have added that username as a buddy.
http://www.spore.com/rest/users/subscribers/<Username>/<StartIndex>/<Length>
http://www.spore.com/rest/users/subscribers/MaxisDangerousYams/0/10

Special Searches: List creations for a given view.
View Types are: TOP_RATED, TOP_RATED_NEW, NEWEST, FEATURED, MAXIS_MADE, RANDOM, CUTE_AND_CREEPY
For each asset you get id, name, author, creation date, rating, type and parent
http://www.spore.com/rest/assets/search/<ViewType>/<StartIndex>/<Length>
http://www.spore.com/rest/assets/search/TOP_RATED/0/2
http://www.spore.com/rest/assets/search/TOP_RATED_NEW/0/2
http://www.spore.com/rest/assets/search/NEWEST/0/2
http://www.spore.com/rest/assets/search/FEATURED/0/5
http://www.spore.com/rest/assets/search/MAXIS_MADE/0/7
http://www.spore.com/rest/assets/search/RANDOM/0/4
http://www.spore.com/rest/assets/search/CUTE_AND_CREEPY/0/8
Optionally, you can specify an asset type
Asset types are: UFO, CREATURE, BUILDING, VEHICLE
http://www.spore.com/rest/assets/search/<ViewType>/<StartIndex>/<Length>/<AssetType>
http://www.spore.com/rest/assets/search/FEATURED/0/5/UFO
http://www.spore.com/rest/assets/search/TOP_RATED_NEW/0/5/CREATURE
http://www.spore.com/rest/assets/search/RANDOM/0/5/BUILDING

Cut along the dashed lines  



Static Data

Asset Data: Get XML and PNGs for an asset id http://www.spore.com/static/<DataType>/<subId1>/<subId2>/<subId3>/<AssetId>.<format>
This can get you 3 types of data:
XML: http://www.spore.com/static/model/500/226/147/500226147573.xml
Large PNG: http://www.spore.com/static/image/500/226/147/500226147573_lrg.png
Small PNG: http://www.spore.com/static/thumb/500/226/147/500226147573.png
The URL format is as follows:
<DataType> is "model" for XML, "image" for large PNG and "thumb" for small PNG.
<subIds> are just 3 digit partitions of the asset id like so: 500 226 147 573
<AssetId> is the full id, so in this case: 500226147573
<format> is the file type, png or xml. Note: For the large PNG, append "_lrg" to the asset id.

Achievement Icon: Get the official Spore achievement icon for a given achievement id
http://www.spore.com/static/war/images/achievements/<AchievementId>.png
http://www.spore.com/static/war/images/achievements/0x0cc8b2c9!0x0625c63e.png

Achievement Text: Look up the official Spore achievement name and text in an XML map file
http://www.spore.com/data/achievements.xml

Part Info: Look up part name, icon filename and other properties for part id
Only creature blocks (no limbs):
http://www.spore.com/data/blocks/creatureblockmap.xml
Only creature limbs:
http://www.spore.com/data/blocks/limbblockmap.xml
Only building blocks:
http://www.spore.com/data/blocks/buildingblockmap.xml
Only vehicle blocks:
http://www.spore.com/data/blocks/vehicleblockmap.xml
All the blocks:
http://www.spore.com/data/blocks/blockmap.xml

Part Icon:
Using the filename for a part with a given id, you can retrieve it's icon.
For part with id 0x0f4d021b, filename is "ce_grasper_radial_02" The URL is:
http://www.spore.com/data/blocks/thumbs/ce_grasper_radial_02.png
Note: if the filename is "ce_grasper_radial_02-symmetric" or "ce_grasper_radial_02-center", just ignore the "-symmetric" or "-center" part and use "ce_grasper_radial_02".

Paint Info: Look up paint icon file name for a paint id
http://www.spore.com/data/paints/paintmap.xml

Paint Icon:
Using the filename for a part with a given id, you can retrieve it's icon.
For paint with id 0x18890fd2, filename is "BE_zany_37" The URL is:
http://www.spore.com/data/paints/thumbs/BE_zany_37.png

Cut along the dashed lines  



RSS Feeds

Assets for User: Get a feed of all the assets for user. Asset name, description, type, creation date, PNG and XML links are included
http://www.spore.com/atom/assets/user/<Username>
http://www.spore.com/atom/assets/user/MaxisDangerousYams

Events for User: Get a feed of recent events for user
http://www.spore.com/atom/events/user/<Username>
http://www.spore.com/atom/events/user/MaxisCactus

Events for Asset: Get a feed of recent events for given asset id
http://www.spore.com/atom/events/asset/<AssetId>
http://www.spore.com/atom/events/asset/500000009281

Sporecast Feed: Get a feed of all the assets in a sporecast, date they were added and links to PNG and XML
http://www.spore.com/atom/sporecast/<SporecastId>
http://www.spore.com/atom/sporecast/500048806066

Special Searches: List creations for a given view.
View Types are: TOP_RATED, TOP_RATED_NEW, NEWEST, FEATURED, MAXIS_MADE, RANDOM, CUTE_AND_CREEPY
http://www.spore.com/atom/assets/view/<ViewType>/<StartIndex>/<Length>
http://www.spore.com/atom/assets/view/TOP_RATED/0/10
http://www.spore.com/atom/assets/view/TOP_RATED_NEW/0/10
http://www.spore.com/atom/assets/view/FEATURED/0/10
http://www.spore.com/atom/assets/view/CUTE_AND_CREEPY/0/3
http://www.spore.com/atom/assets/view/MAXIS_MADE/0/5
http://www.spore.com/atom/assets/view/RANDOM/0/20
http://www.spore.com/atom/assets/view/NEWEST/0/20