# MarketSDK Listings API

**Canonical:** https://apis.io/apis/marketsdk/marketsdk-listings-api/  
**Provider:** MarketSDK — https://apis.io/providers/marketsdk/  
**Base URL:** https://api.marketsdk.com  
**Documentation:** https://marketsdk.com/docs/api

MarketSDK Listings API is one of 13 APIs that [MarketSDK](https://apis.io/providers/marketsdk/) 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.

The Listings API from MarketSDK — 9 operation(s) for listings.

## Operations (12)

| Method | Path | Summary |
|---|---|---|
| POST | `/v1/listings` | Create a listing, as a draft |
| GET | `/v1/listings` | List listings, newest first |
| POST | `/v1/listings/bulk` | Create up to 100 listings at once, all or none |
| GET | `/v1/listings/{id}` | Retrieve a listing |
| PATCH | `/v1/listings/{id}` | Update a listing |
| POST | `/v1/listings/{id}/publish` | Publish a listing |
| POST | `/v1/listings/{id}/unpublish` | Return a published listing to draft |
| POST | `/v1/listings/{id}/remove` | Take a listing down, with a reason |
| POST | `/v1/listings/{id}/media` | Start a media upload |
| GET | `/v1/listings/{id}/media` | A listing's media, pending uploads included |
| POST | `/v1/media/{id}/complete` | Complete a media upload |
| DELETE | `/v1/media/{id}` | Delete media and its file |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/marketsdk/openapi/marketsdk-listings-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/marketsdk/json-schema/marketsdk-order-object-schema.json
- **JSONSchema** — https://artifacts.apis.io/marketsdk/json-schema/marketsdk-payment-object-schema.json
- **JSONSchema** — https://artifacts.apis.io/marketsdk/json-schema/marketsdk-event-object-schema.json
- **JSONSchema** — https://artifacts.apis.io/marketsdk/json-schema/marketsdk-create-webhook-endpoint-dto-schema.json
- **JSONSchema** — https://artifacts.apis.io/marketsdk/json-schema/marketsdk-refund-object-schema.json
- **JSONSchema** — https://artifacts.apis.io/marketsdk/json-schema/marketsdk-update-webhook-endpoint-dto-schema.json

## Other MarketSDK APIs (12)

- [MarketSDK Buyers API](https://apis.io/apis/marketsdk/marketsdk-buyers-api/)
- [MarketSDK Categories API](https://apis.io/apis/marketsdk/marketsdk-categories-api/)
- [MarketSDK Marketplace API](https://apis.io/apis/marketsdk/marketsdk-marketplace-api/)
- [MarketSDK Moderation API](https://apis.io/apis/marketsdk/marketsdk-moderation-api/)
- [MarketSDK Orders API](https://apis.io/apis/marketsdk/marketsdk-orders-api/)
- [MarketSDK Payments API](https://apis.io/apis/marketsdk/marketsdk-payments-api/)
- [MarketSDK Reputation API](https://apis.io/apis/marketsdk/marketsdk-reputation-api/)
- [MarketSDK Reviews API](https://apis.io/apis/marketsdk/marketsdk-reviews-api/)
- [MarketSDK Search API](https://apis.io/apis/marketsdk/marketsdk-search-api/)
- [MarketSDK Sellers API](https://apis.io/apis/marketsdk/marketsdk-sellers-api/)
- [MarketSDK Trust API](https://apis.io/apis/marketsdk/marketsdk-trust-api/)
- [MarketSDK Webhooks API](https://apis.io/apis/marketsdk/marketsdk-webhooks-api/)

## Tags

Listings

---

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