A JSON API for planetary interaction data: which planet types yield which raw materials, what each PI commodity is made from, the planets in a system, and a search for the nearest systems that have the planets you need. It's the same data and search as the Planet Finder, which you might find easier if you only want to look something up.
Everything is a GET to https://www.fuzzwork.co.uk/api/planets.php with an action parameter. Responses are JSON, can be fetched cross-origin (CORS is open), and are cached for an hour.
Planet types
https://www.fuzzwork.co.uk/api/planets.php?action=types
The eight planet types that support PI, with the raw materials (P0) each can extract. The typeID is the one used everywhere else in this API, and in the SDE.
[{"typeID": 2016, "name": "Barren", "materials": [{"typeID": 2268, "typeName": "Aqueous Liquids"}, ...]}, ...]
Commodities
https://www.fuzzwork.co.uk/api/planets.php?action=commodities&tier=1
Every PI commodity from P0 to P4. tier is optional (0-4) and filters the list.
inputs: the typeIDs the commodity's schematic takesrawMaterials: the P0 typeIDs it's ultimately made from, all the way down the chainplanetTypes(P0 only): the planet types it can be extracted from
{"typeID": 2393, "typeName": "Bacteria", "tier": 1, "tierName": "P1", "inputs": [2073], "rawMaterials": [2073]}
Planets in a system
https://www.fuzzwork.co.uk/api/planets.php?action=system&system=Dodixie
system is a solar system name or ID. You get the system's security, constellation, region, star, piAllowed (see below) and a planets list, in orbit order. Each planet has the same fields as in the planet lookup below, without the solarSystem block.
Planet lookup
https://www.fuzzwork.co.uk/api/planets.php?action=planets&planets=Jita IV,40169266,Dodixie 10
planets is a comma-separated list of up to 100 planets. Each can be an itemID, the name as it is in the SDE (Jita 4) or as the client shows it (Jita IV); case doesn't matter. Results come back in the order you asked for them. Anything that isn't a planet goes into notFound rather than failing the whole request.
{
"planets": [
{
"itemID": 40009082,
"itemName": "Jita 4",
"celestialIndex": 4,
"typeID": 13,
"typeName": "Gas",
"orbitAU": 3.009,
"radiusKm": 18890,
"temperature": 184.3,
"moons": 12,
"belts": 0,
"stations": 10,
"piMaterials": [{"typeID": 2268, "typeName": "Aqueous Liquids"}, ...],
"solarSystem": {
"solarSystemID": 30000142,
"solarSystemName": "Jita",
"security": 0.9459,
"securityDisplay": "0.9",
"constellationName": "Kimotoro",
"regionName": "The Forge",
"piAllowed": false
}
}
],
"notFound": []
}
stations counts NPC stations orbiting the planet or one of its moons. temperature is in Kelvin, and is null where the SDE doesn't have one. piMaterials is empty for planet types with no PI (shattered planets).
System search
Finds the nearest systems to origin that have at least one planet of every type in types, and at least one planet that can extract every raw material the commodities in commodity are made from. Pick a P4 and it works out the whole chain.
| Parameter | Default | |
|---|---|---|
origin |
Starting system, name or ID. Required. | |
types |
Planet typeIDs, from action=types |
|
commodity |
Commodity typeIDs, any tier, from action=commodities |
|
maxjumps |
10 | 0-50 |
route |
0 | 1 to only route through high sec |
sec |
any | high, low or null: the security of the systems returned |
station |
0 | 1 to only return systems with an NPC station |
limit |
50 | 1-200 |
types and commodity take a comma-separated list (types=2016,2063) or repeated parameters (types[]=2016&types[]=2063).
Results are sorted by jumps, then name. Each has the system, region, jumps, total planets and stations, a count for every PI planet type in planetTypes, and in rawMaterials how many planets can extract each raw material you need. limitReached tells you there may be more. query echoes back what was searched for, with rawMaterials the P0 typeIDs your commodities came down to.
Systems without PI
A handful of systems don't allow colonising planets: Jita, Amarr, Dodixie, Rens and some of their neighbours. CCP doesn't put this in the SDE, so the list comes from the EVE University wiki. Those systems have piAllowed: false, and the search leaves them out of results and lists them in excludedNoPI instead, so you can see what was dropped.
Errors
Bad parameters get a 400 and {"error": "..."} saying what's wrong. An unknown system is a 404. A search from a system with no route data (usually route=1 from outside high sec) is a 422.
If you find this handy, or want it extended, let me know.

