---
title: "Browse marketplace listings"
method: GET
path: "/v1/aion/marketplace/browse"
---

# Browse marketplace listings

`GET /v1/aion/marketplace/browse`

## Request

- Base URL: `https://api.payaion.com`
- URL: `https://api.payaion.com/v1/aion/marketplace/browse`
- Auth: API key in header `X-Aion-Key`

Search and paginate through active marketplace listings.
Returns files that are READY, not expired, and listed as active.
No login required for the returned URLs — anyone can view and buy.

## Query parameters

- `q` string
- `category` 'reports' | 'datasets' | 'code' | 'media' | 'models' | 'prompts' | 'other'
- `page` integer
- `pageSize` integer

## Response `200`

Marketplace listings

- MarketplaceBrowseResult
  - `listings` MarketplaceListingItem[], required
    - `uploadId` string, required
    - `title` string, required
    - `description` string, nullable
    - `category` string, nullable
    - `tags` string[]
    - `fileName` string, required
    - `mimeType` string, nullable
    - `sizeBytes` integer, required
    - `pricePerDownload` string, nullable
    - `sellerAddress` string, nullable
    - `listedAt` string, date-time, required
    - `url` string, uri, nullable: Market listing page URL (/m/{hash}) — null when the upload is not listed
  - `total` integer, required
  - `page` integer, required
  - `pageSize` integer, required

## Other responses

- `401`: Invalid or missing credentials
- `403`: Scope denied or access forbidden
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/payaion/apis/payaion-api.md) · [All operations](https://skmtc.dev/payaion/apis/payaion-api/llms.txt) · [OpenAPI document](https://skmtc.dev/payaion/apis/payaion-api/revisions/29927240cfc2?raw)