Ape Apps

My Colony Sector Map API

Brandon Stecklein
@bastecklein@accounts.ape-apps.com
Published August 12, 2025

In My Colony, every colony in the game is assigned to a sector on an X,Y coordinate grid, and within each sector is another sub-grid containing an X,Y layout of all colonies within that sector. This API lets you drill down and get info for all colonies within a sector. To get information on the overall galactic sector map, see the Populated Sectors API.

Sample endpoint

https://mc1.my-colony.com/api.php?pf=3&g=1&sx=0&sy=0&limit=100&ind=1

The sx and sy parameters are rquired, and represent the sector location on the overall galactic map, as returned from the Populated Sectors API. The limit parameter will limit the number of results returned, and the ind parameter will limit results to independent colonies only, if set to 1 (there will be MANY more non-independent colonies, from players who only start the game once or twice and then never return).

Sample Output

[
    {
        "name": "United Earth",
        "charter": "earth",
        "capitol": "1",
        "population": "267123984",
        "maptype": "Earthlike",
        "theme": "#1565C0",
        "x": "0",
        "y": "0"
    },
    {
        "name": "Deutsch Republic",
        "charter": "hS4XnXVlUv",
        "capitol": "1",
        "population": "62206174",
        "maptype": "Forest World",
        "theme": "#b71c1c",
        "x": "-18",
        "y": "-641"
    }
]

For questions/issues/suggestions regarding the API, please sign in to the official Ape Apps Discord channel.

Join the Discord