# Aura Historia Product Listings API

**Canonical:** https://apis.io/apis/aura-historia-com/aura-historia-com-productlistings-api/  
**Provider:** Aura Historia — https://apis.io/providers/aura-historia-com/  
**Base URL:** https://api.stage.aura-historia.com  
**Documentation:** https://docs.api.aura-historia.com/

Aura Historia Product Listings API is one of 18 APIs that [Aura Historia](https://apis.io/providers/aura-historia-com/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 11 JSON Schema definitions. Tagged areas include ProductListings. The published artifact set on APIs.io includes an OpenAPI specification and 11 JSON Schemas.

Product retrieval, product history, similar-product discovery, product search, and partner catalog ingestion workflows.

## Operations (27)

| Method | Path | Summary |
|---|---|---|
| POST | `/v1/listing-sources/{listingSourceId}/product-listings/async` | Submit a batch of product-listing creates asynchronously (Partner API) |
| PATCH | `/v1/listing-sources/{listingSourceId}/product-listings/async` | Submit a batch of product-listing updates asynchronously (Partner API) |
| PUT | `/v1/listing-sources/{listingSourceId}/product-listings/async` | Submit a batch of product-listing upserts asynchronously (Partner API) |
| DELETE | `/v1/listing-sources/{listingSourceId}/product-listings/async` | Submit a batch of product-listing withdrawals asynchronously (Partner API) |
| GET | `/v1/listing-sources/{listing_source_id}/product-listings/by-source-id/{source_listing_id}/delivery` | Get product listing delivery |
| PATCH | `/v1/listing-sources/{listing_source_id}/product-listings/by-source-id/{source_listing_id}/delivery` | Change product listing delivery |
| GET | `/v1/admin/product-listings` | Search ProductListings for administration |
| GET | `/v1/admin/product-listings/{productListingId}` | Inspect authoritative ProductListing facts |
| PATCH | `/v1/admin/product-listings/{productListingId}` | Update an existing active ProductListing |
| DELETE | `/v1/admin/product-listings/{productListingId}` | Withdraw a retained ProductListing |
| POST | `/v1/admin/product-listings/{productListingId}/restore` | Explicitly restore a retained ProductListing |
| GET | `/v1/listing-sources/{listingSourceId}/product-listings` | List ProductListings for an administered ListingSource |
| POST | `/v1/listing-sources/{listingSourceId}/product-listings` | Batch create product-listings (Partner API) |
| PATCH | `/v1/listing-sources/{listingSourceId}/product-listings` | Batch update product-listings (Partner API) |
| PUT | `/v1/listing-sources/{listingSourceId}/product-listings` | Batch upsert product-listings (Partner API) |
| DELETE | `/v1/listing-sources/{listingSourceId}/product-listings` | Batch delete product-listings (Partner API) |
| GET | `/v1/listing-sources/{listingSourceId}/product-listings/{productListingId}` | Inspect authoritative ProductListing facts |
| PATCH | `/v1/listing-sources/{listingSourceId}/product-listings/{productListingId}` | Update an existing active ProductListing |
| DELETE | `/v1/listing-sources/{listingSourceId}/product-listings/{productListingId}` | Withdraw a retained ProductListing |
| POST | `/v1/listing-sources/{listingSourceId}/product-listings/{productListingId}/restore` | Explicitly restore a retained ProductListing |
| POST | `/v1/webhooks/woocommerce/{listingSourceId}` | Ingest a WooCommerce product webhook (Partner API) |
| GET | `/v1/product-listings/by-slug/{productListingTitleSlugId}` | Get a single product by title slug |
| GET | `/v1/product-listings/{productListingId}` | Get a single product |
| GET | `/v1/product-listings/{productListingId}/history` | Get ProductListing history |
| GET | `/v1/product-listings/{productListingId}/similar` | Get similar product-listings |
| GET | `/v1/product-listings` | Simple product search via query parameters |
| POST | `/v1/listing-sources/{listing_source_id}/product-listings/by-source-id/{source_listing_id}/delivery/async` | Submit product listing delivery |

## Machine-readable artifacts (12)

- **OpenAPI** — https://artifacts.apis.io/aura-historia-com/openapi/aura-historia-com-productlistings-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/aura-historia-com/json-schema/aura-historia-com-woocommerce-product-webhook-upsert-data-schema.json
- **JSONSchema** — https://artifacts.apis.io/aura-historia-com/json-schema/aura-historia-com-upsert-product-listing-data-schema.json
- **JSONSchema** — https://artifacts.apis.io/aura-historia-com/json-schema/aura-historia-com-update-product-listing-data-schema.json
- **JSONSchema** — https://artifacts.apis.io/aura-historia-com/json-schema/aura-historia-com-create-product-listing-data-schema.json
- **JSONSchema** — https://artifacts.apis.io/aura-historia-com/json-schema/aura-historia-com-oauth-client-metadata-response-data-schema.json
- **JSONSchema** — https://artifacts.apis.io/aura-historia-com/json-schema/aura-historia-com-oauth-client-consent-metadata-data-schema.json
- **JSONSchema** — https://artifacts.apis.io/aura-historia-com/json-schema/aura-historia-com-oauth-token-response-data-schema.json
- **JSONSchema** — https://artifacts.apis.io/aura-historia-com/json-schema/aura-historia-com-async-product-listing-batch-report-schema.json
- **JSONSchema** — https://artifacts.apis.io/aura-historia-com/json-schema/aura-historia-com-shipping-profile-data-schema.json
- **JSONSchema** — https://artifacts.apis.io/aura-historia-com/json-schema/aura-historia-com-shipping-default-data-schema.json
- **JSONSchema** — https://artifacts.apis.io/aura-historia-com/json-schema/aura-historia-com-replace-shipping-profile-data-schema.json

## Other Aura Historia APIs (12)

- [Aura Historia Administration API](https://apis.io/apis/aura-historia-com/aura-historia-com-administration-api/)
- [Aura Historia Auctions API](https://apis.io/apis/aura-historia-com/aura-historia-com-auctions-api/)
- [Aura Historia Billing API](https://apis.io/apis/aura-historia-com/aura-historia-com-billing-api/)
- [Aura Historia Listing Sources API](https://apis.io/apis/aura-historia-com/aura-historia-com-listingsources-api/)
- [Aura Historia Newsletter API](https://apis.io/apis/aura-historia-com/aura-historia-com-newsletter-api/)
- [Aura Historia Notifications API](https://apis.io/apis/aura-historia-com/aura-historia-com-notifications-api/)
- [Aura Historia OAuth API](https://apis.io/apis/aura-historia-com/aura-historia-com-oauth-api/)
- [Aura Historia Operations API](https://apis.io/apis/aura-historia-com/aura-historia-com-operations-api/)
- [Aura Historia Overview API](https://apis.io/apis/aura-historia-com/aura-historia-com-overview-api/)
- [Aura Historia Parties API](https://apis.io/apis/aura-historia-com/aura-historia-com-parties-api/)
- [Aura Historia Partnership Applications API](https://apis.io/apis/aura-historia-com/aura-historia-com-partnershipapplications-api/)
- [Aura Historia Partnerships API](https://apis.io/apis/aura-historia-com/aura-historia-com-partnerships-api/)

## Tags

ProductListings

---

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