Are.na API reference
Get public Are.na channels and blocks as JSON: every link, image and note in a channel, with its source and dates. Search channels, read profiles and see where a block is connected.
The Are.na API has 9 endpoints, called the same way: POST /execute with the endpoint ID as capability and its fields as input, or pin Are.na in the MCP server and call each one as a tool. The data comes back as JSON in results[0].data, with what the call cost in billing.credits_charged.
The inputs you send most are username, block_id and slug. Prices run from 1 credit to 1.5 credits per call, and a failed call costs nothing.
Endpoints
Open an endpoint for its input, the fields it returns and the request in cURL, Python and Node.js.
| Endpoint | What it returns | Price |
|---|---|---|
arena.channel.blocks-list |
List the blocks in a public channel, page by page: each link, image or text with its title, source URL, class and the date it was added. | 1 credit |
arena.channel.get |
Get a public channel by its name or URL: title, status, how many blocks and channels it holds, and when it was created and updated. | 1.5 credits |
arena.block.get |
Get one block by its ID or URL: title, description, source, class and dates. | 1.5 credits |
arena.search |
Search public Are.na channels and profiles by keyword, a page at a time. | 1.5–3 credits |
arena.explore.get |
Get the most recently published public blocks and channels. | 1.5–3 credits |
arena.block.connections-list |
List the public channels a block is connected to, newest first. | 1.5 credits |
arena.profile.get |
Get a public Are.na profile or group: name, bio and how many channels and followers it has. | 1.5 credits |
arena.profile.channels-list |
List every public channel of a profile. | 1.5 credits |
arena.profile.blocks-list |
List the public blocks a profile created or added, page by page. | 1.5–3 credits |
What to know
- Public content only Everything comes from public channels, blocks and profiles. Private and closed channels are not read.
- Blocks are links, images and text Each block has a class, such as Link, Image or Text, and the source it came from when it has one.
- Large channels come in pages Channel and profile blocks return one page at a time, with the total and whether more pages follow.
- Search finds channels and profiles Keyword search covers channels and profiles. To read blocks, open a channel.
Something missing or unclear? Ask the team that builds the Are.na endpoints.