Mlem API

randommlem - returns one random mlem image in JSON.

https://mlem.tech/api/randommlem

Parameters:
tag - tag of mlem
minwidth - minimum width
maxwidth - maximum width
minheight - minimum height
maxheight - maximum height
orientation - image orientation: square, landscape, portrait
brightness - image brightness: dark or bright (experimental)

API call and response examples:

https://mlem.tech/api/randommlem

{
    "id": 700,
    "url": "https:\/\/mlem.tech\/mlems\/1581090323950.jpg",
    "width": 2976,
    "height": 3968,
    "orientation": "portrait",
    "brightness": "dark",
    "tags": [
        "Cat",
        "Kitten"
    ],
    "code": 200
}

https://mlem.tech/api/randommlem?tag=Cat

{
    "id": 5206,
    "url": "https:\/\/mlem.tech\/mlems\/1586653792128.jpg",
    "width": 720,
    "height": 1280,
    "orientation": "portrait",
    "brightness": "bright",
    "tags": [
        "Cat"
    ],
    "code": 200
}

https://mlem.tech/api/randommlem?minwidth=700&maxwidth=1000&minheight=700&maxheight=1000

{
    "id": 636,
    "url": "https:\/\/mlem.tech\/mlems\/1580919949497.jpg",
    "width": 750,
    "height": 750,
    "orientation": "square",
    "brightness": "dark",
    "tags": [
        "Cow"
    ],
    "code": 200
}

https://mlem.tech/api/randommlem?orientation=square&brightness=dark

{
    "id": 2735,
    "url": "https:\/\/mlem.tech\/mlems\/1584116472217.jpg",
    "width": 1200,
    "height": 1200,
    "orientation": "square",
    "brightness": "dark",
    "tags": [
        "Cat",
        "Kitten"
    ],
    "code": 200
}

newmlem - returns one most recently published mlem image in JSON.

https://mlem.tech/api/newmlem

No parameters

API call and response example:

https://mlem.tech/api/newmlem

{
    "id": 11307,
    "url": "https:\/\/mlem.tech\/mlems\/1606179147267.jpg",
    "width": 3024,
    "height": 4032,
    "orientation": "portrait",
    "brightness": "dark",
    "tags": [
        "Cat"
    ],
    "code": 200
}

mlemid - returns one mlem image by id in JSON.

https://mlem.tech/api/randommlem?mlemid=[id]

Parameters:
mlemid - mlem id

API call and response example:

https://mlem.tech/api/randommlem?mlemid=1

{
    "id": 1,
    "url": "https:\/\/mlem.tech\/mlems\/1575713370775.jpg",
    "width": 608,
    "height": 960,
    "orientation": "portrait",
    "brightness": "dark",
    "tags": [
        "Lamb",
        "Valais blacknose sheep",
        "Sheep"
    ],
    "code": 200
}

tags - returns all tags in JSON.

https://mlem.tech/api/tags

No parameters

API call and response example:
https://mlem.tech/api/tags
```
[
    "Aardvark",
    "Anteater",
    "Bat",
    "Bat-eared fox",
    "Bear"
]
```
Amount of tags in response example is limited to reduce length of the example.

MlemAPI docs