Are.na Search API
Search public Are.na channels and profiles by keyword, a page at a time.
- 1 credit per call
- Failed calls are free
- Updated
- arena.search
{ "page": 1, "per": 24, "total": 48, "total_pages": 326, "blocks": [], "channels": [ { "title": "Club Architecture", "created_at": "2017-05-02T21:44:11.759Z", "added_to_at": "2026-07-01T18:17:55.104Z", "id": 74104, "slug": "club-architecture", "status": "public", "updated_at": "2026-09-19T18:37:50.875Z", "counts": { "followers": 524, "contents": 114 } }, { "title": "Web design as architecture", "created_at": "2018-04-14T12:32:00.678Z", "added_to_at": "2026-07-21T17:52:12.830Z", "id": 179856, "slug": "web-design-as-architecture", "status": "closed", "updated_at": "2026-10-05T08:38:16.718Z", "counts": { "followers": 1132, "contents": 233 } } ]}
| # | Channel | Items | Followers | Status | Updated | Created at | Added to at | Slug | Id |
|---|---|---|---|---|---|---|---|---|---|
| 1 | Club Architecture | 114 | 524 | public | 2026-09-19T18:37:50.875Z | 2017-05-02T21:44:11.759Z | 2026-07-01T18:17:55.104Z | club-architecture | 74104 |
| 2 | Web design as architecture | 233 | 1132 | closed | 2026-10-05T08:38:16.718Z | 2018-04-14T12:32:00.678Z | 2026-07-21T17:52:12.830Z | web-design-as-architecture | 179856 |
| 3 | Websites: Architecture | 127 | 191 | closed | 2026-10-04T22:05:50.542Z | 2015-04-21T15:35:46.704Z | 2026-04-09T07:48:35.377Z | websites-architecture | 29162 |
| 4 | exhibiting architecture, exhibition models | 1496 | 1489 | closed | 2026-10-05T11:08:39.498Z | 2017-03-18T21:38:28.653Z | 2026-02-21T17:08:16.422Z | exhibiting-architecture-exhibition-models | 69097 |
| 5 | ARCHITECTURE STUDIOS | 235 | 105 | closed | 2026-09-30T15:56:36.975Z | 2013-03-16T20:45:01.398Z | 2026-09-13T07:35:37.087Z | architecture-studios | 8463 |
| 6 | data architecture | 154 | 168 | closed | 2026-10-01T22:22:50.012Z | 2017-01-03T10:56:22.761Z | 2021-04-21T18:50:54.453Z | data-architecture | 62017 |
| 7 | body architecture | 125 | 100 | public | 2026-10-05T00:43:36.813Z | 2019-03-21T22:49:12.395Z | 2026-05-07T05:50:23.778Z | body-architecture-hhiwpht1qeg | 371721 |
| 8 | Architecture . Homes | 1093 | 146 | closed | 2026-09-30T11:21:14.603Z | 2019-12-18T10:32:42.680Z | 2026-01-02T22:35:39.651Z | architecture-homes | 545296 |
| 9 | african architecture | 79 | 107 | closed | 2026-09-23T14:13:03.361Z | 2019-08-22T18:15:39.152Z | 2019-08-22T19:01:15.120Z | african-architecture-fyioyghida0 | 455495 |
| 10 | ARCHITECTURE | 346 | 95 | closed | 2026-09-12T15:46:59.935Z | 2012-07-09T13:01:15.804Z | 2026-08-13T08:08:31.030Z | architecture--4 | 3066 |
What you send
The input
object of the request, with every field the endpoint accepts.
| Field | Type | Required | What it does | Example |
|---|---|---|---|---|
| query | string | yes | What to search for, such as architecture. | architecture |
| limit | integer | no | How many items per page. | |
| page | integer | no | Which page to return, starting at 1. | |
| type | string | no | What to return: all (channels and profiles), channels or users. | all · channels · users |
Fields it returns
What each record in the response holds, with the values from the sample above.
| Field | Type | What it is | Example |
|---|---|---|---|
| channels[].title | string | The block's title. | Club Architecture |
| channels[].counts.contents | integer | How many items the channel holds. | 114 |
| channels[].counts.followers | integer | How many people follow it. | 524 |
| channels[].status | string | Whether the channel is open, closed or private. | public |
| channels[].updated_at | string | When it last changed. | 2026-09-19T18:37:50.875Z |
| channels[].created_at | string | When it was created. | 2017-05-02T21:44:11.759Z |
| channels[].added_to_at | string | When something was last added. | 2026-07-01T18:17:55.104Z |
| channels[].counts | object | Counts for the channel. | 2 fields |
| channels[].id | integer | Are.na's ID for it. | 74,104 |
| channels[].slug | string | The channel's name in its address. | club-architecture |
| blocks | array | How many blocks the channel has. | empty in this sample |
| channels | array | How many channels it has. | 24 records |
| page | integer | The page this response holds. | 1 |
| per | integer | How many results each page holds. | 24 |
| total | integer | How many results there are in all. | 48 |
| total_pages | integer | How many pages of results there are. | 326 |
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.search", "input": { "query": "architecture" }}'
import jsonimport osimport requestspayload = json.loads(r'''{ "capability": "arena.search", "input": { "query": "architecture" }}''')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.search", "input": { "query": "architecture" }}),});if (!response.ok) { throw new Error(`Upscrape request failed: ${response.status}`);}console.log(JSON.stringify(await response.json(), null, 2));
https://data.upscrape.com/mcp
Using Upscrape, search Are.na for architecture channels and list the ones with the most followers.
More from the Are.na API
Are.na Search API FAQ
The short answers. The docs have the long ones.
How much does the Are.na Search 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 query. 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.search, checks its price and runs it with the same credits as the REST API.
Your first Are.na call is free.
Up to 100 free credits to start, no card needed.