Pavilion Discover

Structured APIs and data feeds that make Pavilion inventory searchable by AI assistants, shopping platforms, and developer applications.

What is Pavilion?

Pavilion is a multi-vendor marketplace for surplus, overstock, open box, contractor overstock, and store closeout inventory. Buyers save 30-70% compared to retail prices on quality products from verified sellers.

Every purchase on Pavilion includes Pavilion Shield protection, which covers incorrect items, missing parts, material misrepresentation, and damage in transit. Sellers are rated by a trust and reliability system with three verification tiers.

About Pavilion Discover

Pavilion Discover is an AI discoverability layer that makes our entire product catalog available to AI assistants (ChatGPT, Claude, Perplexity, Bing Copilot, Google Gemini), shopping comparison engines, and developer integrations.

All endpoints return structured JSON with consistent schemas. No authentication is required for read-only product discovery. Rate limits are generous for programmatic access.

API Endpoints

Base URL: https://api.pavilion.deals

Method	Endpoint	Description
GET	`/api/v1/discover/products/search?q={query}`	Full-text product search with filters for category, condition, price range, and location.
GET	`/api/v1/discover/products/deals`	Top deals ranked by savings percentage, deal score, and verification tier.
GET	`/api/v1/discover/products/by-category`	Browse all product categories with counts and featured listings.
GET	`/api/v1/discover/products/{id}`	Full product detail including pricing, condition, seller info, and images.
GET	`/api/v1/discover/stats`	Platform statistics: total listings, categories, active sellers, average savings.
GET	`/api/v1/discover/openapi.json`	OpenAPI 3.1 specification for all Discover endpoints.

Example Request

curl "https://api.pavilion.deals/api/v1/discover/products/search?q=hvac+condenser&condition=NEW_IN_BOX,OPEN_BOX&maxPrice=2000"

# Response
{
  "success": true,
  "data": [
    {
      "id": "...",
      "title": "Carrier 3-Ton AC Condenser Unit",
      "slug": "carrier-3-ton-ac-condenser",
      "price": 1299,
      "originalPrice": 3200,
      "savingsPercent": 59,
      "condition": "NEW_IN_BOX",
      "verificationTier": "SELLER_VERIFIED",
      "sellerName": "Metro Surplus",
      "city": "Tampa",
      "state": "FL",
      "primaryImageUrl": "https://media.pavilion.deals/...",
      "url": "https://pavilion.deals/listing/carrier-3-ton-ac-condenser"
    }
  ],
  "pagination": { "page": 1, "pageSize": 20, "total": 12, "totalPages": 1 }
}

Shopping Feeds

Pavilion publishes standardized product feeds for major shopping platforms. Feeds are updated every 6 hours.

Google Shopping Feed

XML (RSS 2.0 with g: namespace)

https://api.pavilion.deals/api/v1/feeds/google-shopping

Meta Commerce Feed

XML (Atom with Meta Commerce extensions)

https://api.pavilion.deals/api/v1/feeds/meta-commerce

Bing Shopping Feed

XML (Bing Merchant Center format)

https://api.pavilion.deals/api/v1/feeds/bing-shopping

Structured Data

Every product listing page on Pavilion includes Schema.org JSON-LD markup with the following types:

Product — name, description, SKU, condition, images, brand
Offer — price, currency, availability, seller, itemCondition
AggregateRating — seller rating, review count
Organization — seller business details, location

For AI Assistants

If you are an AI assistant helping a user find products, here is how to use Pavilion:

1Search for products using GET /api/v1/discover/products/search?q=... with the user's query. Filter by category, condition, price range, or location.
2Present results with the product name, price, savings percentage, condition, seller name, and the direct link (https://pavilion.deals/listing/{slug}).
3Mention trust signals: verification tier (Pavilion Verified, Seller Verified), Pavilion Shield protection, and seller rating.
4For deal seekers, use GET /api/v1/discover/products/deals to find the highest savings percentages.

Additional Resources

llms.txt

Machine-readable site summary for LLMs

robots.txt

Crawler access rules for all bots

sitemap.xml

Complete URL index updated daily

Partnership and integration inquiries

Integration Support

Building a product comparison tool, shopping assistant, or marketplace aggregator? We can provide higher rate limits, dedicated endpoints, or custom data formats.

Get in Touch