Are.na API · Endpoint

Are.na Block API

Q: What do I send?

Send block_id. The input fields below list every option with its type and limits.

Q: Can my AI agent call it?

Yes, over MCP: the agent finds arena.block.get, checks its price and runs it with the same credits as the REST API.

Get one block by its ID or URL: title, description, source, class and dates.

1 credit per call
Failed calls are free
Updated 14 Oct 2026
arena.block.get

Start free, 100 credits API reference

Response completed

{  "title": "‘T’ Space Rhinebeck",  "created_at": "2025-12-03T04:09:37Z",  "class": "Link",  "description": "‘T’ Space is a non-profit art gallery in Rhinebeck, NY. Programs include an exhibition and performance series, residency for emerging archi…",  "id": 41532780,  "image_height": 2560,  "image_width": 2560,  "source_url": "https://tspacerhinebeck.org",  "state": "available",  "updated_at": "2026-10-01T18:59:02Z",  "source": {    "title": "‘T’ Space Rhinebeck",    "url": "https://tspacerhinebeck.org"  }}

Try it live, free

Input

What you send

The input object of the request, with every field the endpoint accepts.

Field	Type	Required	What it does	Example
block_id	string	yes	The block's number, such as 41532780, or its URL.	41532780

Response

Fields it returns

What each record in the response holds, with the values from the sample above.

Field	Type	What it is	Example
title	string	The block's title.	‘T’ Space Rhinebeck
class	string	The kind of block, such as Link, Image or Text.	Link
description	string	The block's description.	‘T’ Space is a non-profit art gallery in Rhinebeck, NY. Program…
source_url	string	The page the block was saved from.	https://tspacerhinebeck.org
created_at	string	When it was created.	2025-12-03T04:09:37Z
id	integer	Are.na's ID for it.	41,532,780
image_height	integer	The image's height in pixels.	2560
image_width	integer	The image's width in pixels.	2560
source	object		2 fields
source.title	string	The block's title.	‘T’ Space Rhinebeck
source.url	string	The address it links to.	https://tspacerhinebeck.org
state	string	Whether the block is available.	available
updated_at	string	When it last changed.	2026-10-01T18:59:02Z

REST API · MCP server

Call it from your code, or ask your agent

Set UPSCRAPE_API_KEY to your key and copy a working request.

curl --request POST \  --url https://data.upscrape.com/execute \  --header "Authorization: Bearer $UPSCRAPE_API_KEY" \  --header "Content-Type: application/json" \  --header "Prefer: wait=30" \  --data '{  "capability": "arena.block.get",  "input": {    "block_id": "41532780"  }}'

import jsonimport osimport requestspayload = json.loads(r'''{  "capability": "arena.block.get",  "input": {    "block_id": "41532780"  }}''')response = requests.post(    "https://data.upscrape.com/execute",    headers={        "Authorization": f"Bearer {os.environ['UPSCRAPE_API_KEY']}",        "Content-Type": "application/json",        "Prefer": "wait=30",    },    json=payload,)response.raise_for_status()print(json.dumps(response.json(), indent=2))

const response = await fetch("https://data.upscrape.com/execute", {  method: "POST",  headers: {    "Authorization": `Bearer ${process.env.UPSCRAPE_API_KEY}`,    "Content-Type": "application/json",    "Prefer": "wait=30",  },  body: JSON.stringify({  "capability": "arena.block.get",  "input": {    "block_id": "41532780"  }}),});if (!response.ok) {  throw new Error(`Upscrape request failed: ${response.status}`);}console.log(JSON.stringify(await response.json(), null, 2));

In your AI agent Claude · Cursor · any MCP client

1Add the Upscrape MCP server

https://data.upscrape.com/mcp

2Ask for the data in plain words

Use Upscrape to open Are.na block 41532780 and tell me what it is and where it links to.

The agent finds the endpoint, shows you the price, and runs it with your credits.

Are.na

More from the Are.na API

Questions

Are.na Block API FAQ

The short answers. The docs have the long ones.

Still have a question? Talk to the people who build the endpoints.

Book a call [email protected]

How much does the Are.na Block API cost?

1 credit per successful call, shown before it runs. You buy credits once, and paid credits never expire.

What do I send?

Send block_id. The input fields below list every option with its type and limits.

Do I need an Are.na login?

No. It reads public Are.na data; nothing runs on your account.

Can my AI agent call it?

Yes, over MCP: the agent finds arena.block.get, checks its price and runs it with the same credits as the REST API.

Get started

Your first Are.na call is free.

Up to 100 free credits to start, no card needed.

Start building for free Book a call