Search across blocks, channels, users, and groups.
⚠️ Premium Only: This endpoint requires a Premium subscription.
Examples:
- Simple:
/v3/search?query=brutalism - Images only:
/v3/search?query=architecture&type=Image - My content:
/v3/search?query=*&scope=my - In a channel:
/v3/search?query=design&channel_id=12345 - By a user:
/v3/search?query=*&user_id=456 - PDFs sorted by date:
/v3/search?query=*&ext=pdf&sort=created_at_desc
Query Params
query
string
The search query string. Supports full-text search across titles, descriptions, and content. Use `*` as a wildcard to match everything (useful when filtering by type, scope, or extension).
type
array of strings
Filter results by content type. Accepts comma-separated values. - Block subtypes: `Text`, `Image`, `Link`, `Attachment`, `Embed` - Aggregate types: `Block` (all block types), `Channel`, `User`, `Group` - `All` returns everything (default behavior)
scope
string enum
Limit search to a specific context.
user_id
integer
Limit search to a specific user's content.
group_id
integer
Limit search to a specific group's content.
channel_id
integer
Limit search to a specific channel's content.
ext
array of strings
Filter results by file extension. Accepts comma-separated values. Only applies to Attachment and Image block types. Common extensions include: pdf, jpg, png, gif, mp4, mp3, doc, xls, etc.
sort
string enum
Sort by relevance, date, name, or popularity. Defaults to `score_desc`. Use `random` with `seed` for reproducible random ordering.
after
string
Filter to only return results updated after this timestamp. Useful for incremental syncing or finding recently modified content. Format: ISO 8601 datetime string.
seed
integer
Random seed for reproducible random ordering. Only used when `sort=random`. Providing the same seed will return results in the same order, useful for pagination through random results.
page
integer
Page number for pagination
per
integer
Number of items per page (max 100)
GET
https://api.are.na/v3/search
Paginated list of all content types with total count
data
oneOf[]!
Array of results (blocks, channels, users, or groups)
[items]
TextBlock | ImageBlock | LinkBlock | AttachmentBlock | EmbedBlock | Channel | User | Group
TextBlock
TextBlock
A text block containing markdown content
ImageBlock
ImageBlock
An image block containing an uploaded or scraped image
LinkBlock
LinkBlock
A link block representing a URL with optional preview
AttachmentBlock
AttachmentBlock
An attachment block containing an uploaded file
EmbedBlock
EmbedBlock
An embed block containing embedded media (video, audio, etc.)
Channel
Channel
User
User
Full user representation
Group
Group
Full group representation
meta
PaginationMeta!
Pagination metadata
current_page
integer!
Current page number
next_page
integer | null
Next page number (null if last page)
prev_page
integer | null
Previous page number (null if first page)
per_page
integer!
Number of items per page
total_pages
integer!
Total number of pages available
total_count
integer!
Total number of items available
has_more_pages
boolean!
Whether there are more pages available