# ClearList Listings API

**Canonical:** https://apis.io/apis/clearlist-me/clearlist-me-listings-api/  
**Provider:** ClearList — https://apis.io/providers/clearlist-me/  
**Base URL:** https://clearlist.me  
**Documentation:** https://clearlist.me/developers

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

Create, read, update, delete, and bulk-create items.

## Operations (8)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/items` | List items |
| POST | `/api/items` | Create a listing |
| GET | `/api/items/{id}` | Get one item |
| PUT | `/api/items/{id}` | Update a listing |
| DELETE | `/api/items/{id}` | Soft-delete a listing |
| POST | `/api/items/{id}/restore` | Restore a soft-deleted listing |
| POST | `/api/items/bulk-upload` | Upload a photo batch (step 1 of bulk creation) |
| POST | `/api/items/bulk-generate` | Generate one listing from photos (async) |

## Machine-readable artifacts (3)

- **OpenAPI** — https://artifacts.apis.io/clearlist-me/openapi/clearlist-me-listings-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/clearlist-me/json-schema/clearlist-me-error-schema.json
- **JSONSchema** — https://artifacts.apis.io/clearlist-me/json-schema/clearlist-me-job-schema.json

## Other ClearList APIs (7)

- [ClearList Account API](https://apis.io/apis/clearlist-me/clearlist-me-account-api/)
- [ClearList Jobs API](https://apis.io/apis/clearlist-me/clearlist-me-jobs-api/)
- [ClearList Onboarding API](https://apis.io/apis/clearlist-me/clearlist-me-onboarding-api/)
- [ClearList Orders API](https://apis.io/apis/clearlist-me/clearlist-me-orders-api/)
- [ClearList Publishing API](https://apis.io/apis/clearlist-me/clearlist-me-publishing-api/)
- [ClearList Scheduling API](https://apis.io/apis/clearlist-me/clearlist-me-scheduling-api/)
- [ClearList System API](https://apis.io/apis/clearlist-me/clearlist-me-system-api/)

## Tags

Listings

---

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