Pinata

Pinata is an IPFS pinning and dedicated-gateway provider with a Files API, IPFS Pinning Service API, dedicated Gateways, Groups, and Workspaces. Built around IPFS CIDs with JWT-authenticated REST APIs and an SDK.

4 APIs 0 Features

Web3IPFSStorageGateway

APIs

Pinata Files API

REST API for uploading, listing, organizing, and deleting files pinned to IPFS or stored privately. Supports public and private (Submarine) modes, signed URLs, and Groups.

Pinata IPFS Pinning Service API

Implementation of the IPFS Pinning Service API standard for compatibility with go-ipfs / kubo and js-ipfs clients.

Pinata Dedicated Gateway

Dedicated IPFS HTTP gateway endpoint per account for content retrieval with custom subdomain, access controls, and analytics.

Pinata Groups API

REST API for organizing CIDs into named Groups with bulk add/remove operations.

Collections

Pinata API

OPEN

Pricing Plans

Pinata Plans Pricing

5 plans

PLANS

Rate Limits

Pinata Rate Limits

2 limits

RATE LIMITS

FinOps

Pinata Finops

FINOPS

Resources

👥

GitHubOrganization

Sources

opencollection: 1.0.0
info:
  name: Pinata API
  version: 3.0.0
request:
  auth:
    type: bearer
    token: '{{bearerToken}}'
items:
- info:
    name: Auth
    type: folder
  items:
  - info:
      name: Test API authentication
      type: http
    http:
      method: GET
      url: https://api.pinata.cloud/data/testAuthentication
    docs: 'Validates the Bearer token supplied in the Authorization header by

      returning a fixed success message when the credentials are valid.

      '
- info:
    name: Files
    type: folder
  items:
  - info:
      name: Upload a file
      type: http
    http:
      method: POST
      url: https://api.pinata.cloud/v3/files
      body:
        type: multipart-form
        data:
        - name: file
          type: text
          value: ''
        - name: network
          type: text
          value: ''
        - name: name
          type: text
          value: ''
        - name: group_id
          type: text
          value: ''
        - name: keyvalues
          type: text
          value: ''
    docs: 'Uploads a file to Pinata, pinning it to either the public IPFS

      network or to private storage depending on the `network` parameter.

      This endpoint is served from uploads.pinata.cloud.

      '
  - info:
      name: List files on a network
      type: http
    http:
      method: GET
      url: https://api.pinata.cloud/v3/files/:network
      params:
      - name: network
        value: ''
        type: path
      - name: limit
        value: ''
        type: query
      - name: pageToken
        value: ''
        type: query
      - name: name
        value: ''
        type: query
      - name: cid
        value: ''
        type: query
      - name: group
        value: ''
        type: query
    docs: 'Returns a paginated list of files pinned on the specified Pinata

      network ("public" or "private").

      '
  - info:
      name: Get a file by ID
      type: http
    http:
      method: GET
      url: https://api.pinata.cloud/v3/files/:network/:id
      params:
      - name: network
        value: ''
        type: path
      - name: id
        value: ''
        type: path
    docs: Get a file by ID
  - info:
      name: Delete a file by ID
      type: http
    http:
      method: DELETE
      url: https://api.pinata.cloud/v3/files/:network/:id
      params:
      - name: network
        value: ''
        type: path
      - name: id
        value: ''
        type: path
    docs: Delete a file by ID
bundled: true