IPFS Ninja

Easily upload images, PDFs, and JSON files to IPFS and get a permanent content identifier (CID) with instant gateway access.

What is IPFS?

The InterPlanetary File System (IPFS) is a decentralized, peer-to-peer storage protocol. IPFS breaks files into smaller chunks, distributes them across the network, and assigns each file a unique content identifier (CID) based on its contents.

This means:

• Distributed storage — your files are stored across multiple nodes for improved reliability.
• Content addressing — the CID is derived from the file content itself, ensuring immutability.
• Network-wide accessibility — anyone with the CID can retrieve the file from any IPFS node.

What IPFS Ninja does

IPFS Ninja is a managed service that lets you upload files and pin existing content on IPFS through a simple REST API. No need to run your own IPFS node.

• Upload new files — send any file via POST /upload/new and get a permanent CID
• Pin existing CIDs — already have content on IPFS? Pin it to our cluster via POST /pin to ensure it stays available
• Access via gateway — all pinned content is accessible at ipfs.ninja/ipfs/<CID>
• Custom metadata — attach key-value pairs to uploads and pins for organization and filtering
• Signed upload tokens — generate time-limited tokens for client-side uploads without exposing your API key
• IPNS mutable names — create stable names that point to changing CIDs via IPNS API, with up to 10 names per account
• Image optimization — resize, convert, and compress images on-the-fly via gateway URL parameters

Dashboard

Track uploads, storage, and gateway bandwidth from your personal dashboard.

Gateway access

Every uploaded file is accessible through the IPFS Ninja gateway, which acts as a bridge between the decentralized IPFS network and traditional web browsers.

The gateway URL follows this pattern:

https://ipfs.ninja/ipfs/<CID>

TIP

Your files are also accessible from any public IPFS gateway (e.g. dweb.link, w3s.link) using the same CID — the IPFS network is decentralized.

Nirvana plan users get a dedicated gateway at their own subdomain (<slug>.gw.ipfs.ninja) that only serves files pinned to their account — with optional token-based access control and origin restrictions.

Supported file types

Type	Formats	Input
JSON	Any valid JSON object or array	string / object
Images	PNG, JPG, WebP, GIF, TIFF, SVG	base64
PDFs	Standard PDF documents	base64
HTML	HTML documents	base64
Any	Any file (binary, text, video, etc.)	base64

All file types are accepted. The type is auto-detected and recorded for your reference.

Security

Gateway responses include security headers (Content-Security-Policy: sandbox, X-Content-Type-Options: nosniff, X-Frame-Options: DENY) that prevent browsers from executing scripts in served content.

Size limits

Limit	Value
Max payload per request	6 MB (API Gateway limit)
Total storage (Dharma)	1 GB
Total storage (Bodhi)	10 GB
Total storage (Nirvana)	100 GB

Use cases

NFT metadata & assets

Store NFT metadata JSON and associated images with permanent, immutable CIDs.

Static resource hosting

Host images, documents, and data files for web and mobile applications.

Verifiable data sharing

Share data with content-addressed provenance — recipients can verify nothing was tampered with.