Skip to main content

Marketplace API

Publish, browse, and rate data products in the marketplace.

Endpoints Overview​

MethodEndpointDescription
GET/marketplace/spaces/{slug}/listingsList marketplace listings
POST/marketplace/spaces/{slug}/listingsPublish a product to marketplace
GET/marketplace/spaces/{slug}/listings/{id}Get listing details
DELETE/marketplace/spaces/{slug}/listings/{id}Unpublish (soft-archive) a listing
POST/marketplace/spaces/{slug}/listings/{id}/rateRate a listing
GET/marketplace/spaces/{slug}/listings/{id}/reviewsGet listing reviews
GET/marketplace/spaces/{slug}/my-listingsGet current user's listings
GET/marketplace/spaces/{slug}/featuredGet featured & trending listings

List Listings​

GET /marketplace/spaces/{slug}/listings

Query Parameters​

ParameterTypeDescription
pageintegerPage number (default: 1)
sizeintegerItems per page (default: 20, max: 100)
searchstringFilter by name/description
categorystringFilter by category
sortstringSort order: trending, newest, top_rated (default: trending)

Example Request​

curl -X GET "https://api.qarion.com/marketplace/spaces/analytics/listings?sort=top_rated" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response​

{
  "items": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "product_id": "...",
      "product_name": "Customer Segments",
      "product_slug": "customer-segments",
      "description": "Production-ready customer segmentation dataset",
      "category": "Marketing",
      "average_rating": 4.5,
      "rating_count": 12,
      "view_count": 156,
      "quality_score": 0.97,
      "published_at": "2026-01-10T14:30:00Z",
      "publisher": {"id": "...", "name": "Alice Johnson"}
    }
  ],
  "total": 24,
  "page": 1,
  "size": 20
}

Publish to Marketplace​

POST /marketplace/spaces/{slug}/listings

Request Body​

{
  "product_id": "550e8400-e29b-41d4-a716-446655440000",
  "category": "Marketing"
}

Qarion evaluates quality gates before publishing. If gates fail, returns 422 with details of which requirements are not met.

Response​

Returns the listing with status 201 Created.

Unpublish​

DELETE /marketplace/spaces/{slug}/listings/{id}

Soft-archives the listing (removes from marketplace browse but does not delete the product from the catalog).

Response​

{
  "message": "Listing unpublished successfully"
}

Rate a Listing​

POST /marketplace/spaces/{slug}/listings/{id}/rate

Request Body​

{
  "rating": 5,
  "review": "Excellent dataset with clear documentation"
}
FieldTypeRequiredDescription
ratingintegerYes1–5 star rating
reviewstringNoOptional text review

Upsert behavior: If the user has already rated this listing, the previous rating is updated.

Response​

{
  "id": "...",
  "rating": 5,
  "review": "Excellent dataset with clear documentation",
  "user": {"id": "...", "name": "Bob Smith"},
  "created_at": "2026-02-15T09:00:00Z"
}

Get Reviews​

GET /marketplace/spaces/{slug}/listings/{id}/reviews

Response​

{
  "items": [
    {
      "id": "...",
      "rating": 5,
      "review": "Excellent dataset",
      "user": {"id": "...", "name": "Bob Smith"},
      "created_at": "2026-02-15T09:00:00Z"
    }
  ],
  "average_rating": 4.5,
  "total": 12
}

Featured & Trending​

GET /marketplace/spaces/{slug}/featured

Returns a curated list of featured and trending listings based on view count and rating velocity.