Listings overview
Create, update, publish and manage seller listings in the Mediloop Marketplace.
Authentication
OAuth 2.0
Permissions
marketplace:write
Rate limit
120 requests / min
Response
200 OK
Overview
Create, update, publish and manage seller listings in the Mediloop Marketplace.
Key capabilities
Draft listings
Prepare seller-specific offers.
Publish guard
Check eligibility before publication.
Publishing
Make listings public.
Lifecycle
Update or unpublish safely.
Available endpoints
| Method | Endpoint | Purpose |
|---|---|---|
POST | /listings | Create listing |
PATCH | /listings/{id} | Update listing |
POST | /listings/{id}/publish | Publish |
POST | /listings/{id}/unpublish | Unpublish |
Workflow
01
Draft
02
Validate
03
Publish
04
Maintain
Authentication
Use OAuth 2.0 credentials and the least-privilege Marketplace scopes required by your application.
Common use cases
| Scenario | Recommendation |
|---|---|
Interactive applications | Use scoped user/organization access |
Back-office sync | Use server-side credentials and idempotency |
High-volume jobs | Use pagination and respect rate limits |