IPFS Pubsub API
The Pubsub API from IPFS — 4 operation(s) for pubsub.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/ipfs:ipfs-pubsub-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: IPFS RPC Pubsub API
version: v0
description: When a Kubo IPFS node is running as a daemon, it exposes an HTTP RPC API that allows you to control the node and run the same commands you can from the command line.
x-providerName: IPFS
x-logo:
url: https://raw.githubusercontent.com/ipfs/ipfs-docs/55fe8bc6a53ba3b9023951fb4b432efbbc81fba5/docs/.vuepress/public/images/ipfs-logo.svg
servers:
- description: Local IPFS node
url: http://localhost:5001
- description: Local IPFS node
url: http://127.0.0.1:5001
- description: Infura hosted IPFS node
url: https://ipfs.infura.io:5001
tags:
- name: Pubsub
paths:
/api/v0/pubsub/ls:
post:
operationId: pubsub/ls
description: List subscribed topics by name.
externalDocs:
url: https://docs.ipfs.tech/reference/kubo/rpc/#api-v0-pubsub-ls
deprecated: true
parameters: []
responses:
'200':
description: Successful response
content:
application/json:
example:
Strings:
- <string>
tags:
- Pubsub
summary: Pubsub/ls
x-summary-source: derived
/api/v0/pubsub/peers:
post:
operationId: pubsub/peers
description: List peers we are currently pubsubbing with.
externalDocs:
url: https://docs.ipfs.tech/reference/kubo/rpc/#api-v0-pubsub-peers
deprecated: true
parameters:
- name: arg
in: query
description: Topic to list connected peers of.
schema:
type: string
responses:
'200':
description: Successful response
content:
application/json:
example:
Strings:
- <string>
tags:
- Pubsub
summary: Pubsub/peers
x-summary-source: derived
/api/v0/pubsub/pub:
post:
operationId: pubsub/pub
description: Publish data to a given pubsub topic.
externalDocs:
url: https://docs.ipfs.tech/reference/kubo/rpc/#api-v0-pubsub-pub
deprecated: true
parameters:
- name: arg
in: query
description: Topic to publish to (multibase encoded when sent over HTTP RPC).
required: true
schema:
type: string
requestBody:
description: Argument `data` is of file type. This endpoint expects one or several files (depending on the command) in the body of the request as 'multipart/form-data'.
content: {}
responses:
'200':
description: Successful response
tags:
- Pubsub
summary: Pubsub/pub
x-summary-source: derived
/api/v0/pubsub/sub:
post:
operationId: pubsub/sub
description: Subscribe to messages on a given topic.
externalDocs:
url: https://docs.ipfs.tech/reference/kubo/rpc/#api-v0-pubsub-sub
deprecated: true
parameters:
- name: arg
in: query
description: Name of topic to subscribe to (multibase encoded when sent over HTTP RPC).
required: true
schema:
type: string
responses:
'200':
description: Successful response
content:
application/json:
example:
data: <string>
from: <string>
seqno: <string>
topicIDs:
- <string>
tags:
- Pubsub
summary: Pubsub/sub
x-summary-source: derived
externalDocs:
url: https://docs.ipfs.tech/reference/kubo/rpc/