Upload API

Tools and sites can upload NFOs to NFOmation automatically. You need a key: request one below. We don't ask for your name or email. You get the key straight away, and it starts working once we've approved it. Uploads through the API follow the same rules as the upload form and the terms of use.

Uploading

Send the file as multipart/form-data in a field called nfo, with your key in the Authorization header:

curl -H "Authorization: Bearer YOUR_KEY" -F "nfo=@release.nfo" https://nfomation.net/api/v1/upload

On success you get 201 Created and the links to the new NFO:

{
    "ok": true,
    "name": "1700000000.release.nfo",
    "url": "https://nfomation.net/info/1700000000.release.nfo",
    "image": "https://nfomation.net/nfo.white/1700000000.release.nfo.png",
    "image_dark": "https://nfomation.net/nfo.black/1700000000.release.nfo.png",
    "download": "https://nfomation.net/download/1700000000/release.nfo"
}

If something goes wrong you get "ok": false and an "error" message, with an HTTP status such as 401 (missing or unknown key), 403 (key not approved yet, or revoked), 413 (over 300K), 415 (not an NFO or text file), 422 (links to a blocked site) or 429 (too many uploads).

Checking your key

curl -H "Authorization: Bearer YOUR_KEY" https://nfomation.net/api/v1/status

"status" is pending (waiting for approval), active or revoked. Requests that aren't approved within 30 days are deleted.

Limits

Request a key