{"name":"CraftGenie public API","plan_links":{"about":"To give your user a finished, interactive factory, write a plan link (no tools, key or POST needed): it plans the factory and redirects to its short /p/ page with the machines, raw inputs and power. Give it to the user as is. Each game’s page, /games/{game}/factory, lists item slugs to plan.","pattern":"https://craftgenie.io/plan/{game}?make={item}:{amount},{item}:{amount}","rules":["game: the game’s slug from GET /api/v1/games (factorio, core-keeper). Its name works too (Factorio, core keeper, dsp).","make: what to make, item:amount, comma-separated, up to 20. The item is its slug (electronic-circuit) or its name: case, spaces or underscores, plurals and small typos are forgiven.","amount: 60/min (or /s, /h) is a rate; a bare 60 is a total. When any target has a rate, bare numbers are per minute too. Leave it out for 1: a minute in factory games, in total in batch games such as Palworld.","prefer, allow, block (optional): recipes by key or name, comma-separated, as in POST /api/v1/plan; allow=all allows every alternate recipe.","mode=rate or mode=total (optional): how bare numbers read. energy=off (optional): leave power and fuel out.","A link that resolves redirects to the plan’s short /p/… page, the same plan and the same link POST /api/v1/plan gives for that body. One that does not (an unknown or ambiguous name) opens a “Did you mean…?” page that links the corrected plan links."],"examples":[{"title":"Satisfactory: 10 heavy modular frames, 10 computers and 4 supercomputers a minute","url":"https://craftgenie.io/plan/satisfactory?make=heavy-modular-frame:10/min,computer:10/min,supercomputer:4/min"},{"title":"Factorio: 60 electronic circuits a minute","url":"https://craftgenie.io/plan/factorio?make=electronic-circuit:60/min"},{"title":"Factorio: two targets, by name, one a second","url":"https://craftgenie.io/plan/factorio?make=Automation_Science_Pack:1/s,iron-gear-wheels:30/min"},{"title":"Factorio: plastic from advanced oil processing, without power","url":"https://craftgenie.io/plan/factorio?make=plastic-bar:30/min&prefer=advanced-oil-processing&energy=off"},{"title":"Satisfactory: computers and heavy modular frames, every alternate allowed","url":"https://craftgenie.io/plan/satisfactory?make=computer:5/min,heavy-modular-frame:2/min&allow=all"},{"title":"Satisfactory: 60 iron plates a minute","url":"https://craftgenie.io/plan/satisfactory?make=iron-plate:60/min"},{"title":"Palworld: 100 Pal Spheres (a total)","url":"https://craftgenie.io/plan/palworld?make=pal-sphere:100"},{"title":"Palworld: 50 nails and 20 ingots","url":"https://craftgenie.io/plan/palworld?make=nails:50,ingot:20"},{"title":"Dyson Sphere Program: 30 processors a minute","url":"https://craftgenie.io/plan/dyson-sphere-program?make=processor:30/min"},{"title":"Core Keeper: 20 copper bars","url":"https://craftgenie.io/plan/core-keeper?make=copper-bar:20"}],"docs":"https://craftgenie.io/developers#plan-links"},"version":"1.0.0","docs":"https://craftgenie.io/developers","openapi":"https://craftgenie.io/api/v1/openapi.json","mcp":"https://craftgenie.io/mcp","endpoints":["GET /api/v1/games","GET /api/v1/games/{game}","GET /api/v1/games/{game}/items?q=","GET /api/v1/games/{game}/items/{item}","GET /api/v1/games/{game}/recipes?item=&role=","GET /api/v1/games/{game}/recipes/{recipe}","POST /api/v1/plan","GET /api/v1/plans?sort=popular|new&game=","GET /api/v1/plans/{slug}","POST /api/v1/shares (API key)"],"limits":{"per_minute":{"read":{"anonymous":60,"key":600},"plan":{"anonymous":10,"key":60}},"shares_per_hour":{"key":30},"plan":{"bodyBytes":32768,"targets":20,"prefer":200,"allow":2000,"block":2000,"grids":8,"rate":1000000,"quantity":10000000},"plan_timeout_seconds":10},"licensing":"Each game has its own data license. Every answer about a game carries it in \"license\": credit the data with \"attribution\", and where commercial_use is false, use the data for non-commercial purposes only, under \"terms\".","examples":[{"title":"List the games","method":"GET","path":"/api/v1/games"},{"title":"Find an item","method":"GET","path":"/api/v1/games/factorio/items?q=circuit"},{"title":"What makes an item, and what uses it","method":"GET","path":"/api/v1/games/factorio/items/electronic-circuit"},{"title":"One recipe, by key or id","method":"GET","path":"/api/v1/games/factorio/recipes/advanced-oil-processing"},{"title":"Plan 60 electronic circuits a minute","method":"POST","path":"/api/v1/plan","body":{"game":"factorio","targets":[{"item":"electronic-circuit","rate":60}]}},{"title":"Plan with alternates and two grids","method":"POST","path":"/api/v1/plan","body":{"game":"satisfactory","targets":[{"item":"heavy-modular-frame","rate":5}],"options":{"recipes":{"allow":"all"},"grids":[{"name":"Main"},{"name":"Smelting","stations":["smelter","foundry"]}]}}},{"title":"Plan a total, in a batch game","method":"POST","path":"/api/v1/plan","body":{"game":"palworld","targets":[{"item":"pal-sphere","quantity":100}]}},{"title":"Save a plan as a share link (API key)","method":"POST","path":"/api/v1/shares","body":{"game":"factorio","targets":[{"item":"electronic-circuit","rate":60}],"name":"Green circuits"},"auth":true}]}