# satohub-ai Listings API

**Canonical:** https://apis.io/apis/satohub-ai/satohub-ai-listings-api/  
**Provider:** satohub-ai — https://apis.io/providers/satohub-ai/  
**Base URL:** https://satohub.ai  
**Documentation:** https://satohub.ai/docs/api

satohub-ai Listings API is one of 21 APIs that [satohub-ai](https://apis.io/providers/satohub-ai/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include listings. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Published agent packages. A listing is a public VIEW of one sealed, immutable version — allowlisted version fields plus secret-scanned owner fields, bound to the version's digest. Public reads need no auth. Owner operations take ONLY the Privy bearer; a non-owner gets 404. Acquisition modes are `download` and `fork`; there is no deploy or buy.

## Operations (11)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/listings` | Search published agent packages |
| GET | `/api/listings/{slug}` | Inspect one published listing |
| GET | `/api/listings/{slug}/evidence` | Evidence for the listing's exact digest |
| GET | `/api/listings/{slug}/manifest` | The public signed release manifest |
| GET | `/api/listings/{slug}/download` | Download the sealed package |
| POST | `/api/listings/{slug}/fork` | Fork into a new private project |
| POST | `/api/listings/{slug}/report` | Report a published listing |
| POST | `/api/projects/{id}/listings` | Create a listing draft from a sealed version |
| GET | `/api/projects/{id}/listings` | The owner's listings for one project |
| POST | `/api/listings/{id}/submit` | Submit a draft for first-party review |
| POST | `/api/listings/{id}/unpublish` | Unpublish (or withdraw) a listing |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/satohub-ai/openapi/satohub-ai-listings-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/satohub-ai/json-schema/satohub-ai-version-schema.json
- **JSONSchema** — https://artifacts.apis.io/satohub-ai/json-schema/satohub-ai-interpretation-schema.json
- **JSONSchema** — https://artifacts.apis.io/satohub-ai/json-schema/satohub-ai-needs-input-schema.json
- **JSONSchema** — https://artifacts.apis.io/satohub-ai/json-schema/satohub-ai-scan-recipient-schema.json
- **JSONSchema** — https://artifacts.apis.io/satohub-ai/json-schema/satohub-ai-token-resolve-schema.json
- **JSONSchema** — https://artifacts.apis.io/satohub-ai/json-schema/satohub-ai-swap-receipt-schema.json

## Other satohub-ai APIs (12)

- [satohub-ai Agent Economy API](https://apis.io/apis/satohub-ai/satohub-ai-agent-economy-api/)
- [satohub-ai Badges API](https://apis.io/apis/satohub-ai/satohub-ai-badges-api/)
- [satohub-ai Check API](https://apis.io/apis/satohub-ai/satohub-ai-check-api/)
- [satohub-ai Claims API](https://apis.io/apis/satohub-ai/satohub-ai-claims-api/)
- [satohub-ai Create API](https://apis.io/apis/satohub-ai/satohub-ai-create-api/)
- [satohub-ai Directory API](https://apis.io/apis/satohub-ai/satohub-ai-directory-api/)
- [satohub-ai Erc8004 API](https://apis.io/apis/satohub-ai/satohub-ai-erc8004-api/)
- [satohub-ai Preflight API](https://apis.io/apis/satohub-ai/satohub-ai-preflight-api/)
- [satohub-ai Projects API](https://apis.io/apis/satohub-ai/satohub-ai-projects-api/)
- [satohub-ai Registry API](https://apis.io/apis/satohub-ai/satohub-ai-registry-api/)
- [satohub-ai Resolve API](https://apis.io/apis/satohub-ai/satohub-ai-resolve-api/)
- [satohub-ai Route API](https://apis.io/apis/satohub-ai/satohub-ai-route-api/)

## Tags

listings

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/satohub-ai/satohub-ai-listings-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/satohub-ai/.
