Skip to main content
The Firmly Discovery APIs help users find products across multiple merchant catalogs. These APIs power product search and filtering capabilities.

​
Available Endpoints

Search Products

Search for products using keywords with filters for domains, price, availability, and variant attributes

Get Search Options

Retrieve available filter options for building search filter UIs

​
Key Concepts

​
Discovery vs Catalog APIs

Use Discovery APIs when:
  • Users are browsing or searching for products
  • You need to show products from multiple merchants
  • You want to filter by price, availability, or variants
Use Catalog APIs when:
  • You know the exact product and merchant
  • You need real-time availability/pricing
  • You’re building a product detail page for a specific merchant

​
Typical Search Flow

​
Authentication

Discovery endpoints support two authentication methods: Choose Browser Session for direct client integrations. Choose Server-to-Server when your backend needs to make Discovery API calls on behalf of a user’s device.

​
Domain Authorization

Search results are limited to merchant domains associated with your account. Contact your account manager to request access to additional merchants.

​
Rate Limits

Discovery APIs are subject to standard rate limits. Contact support for higher limits if needed for production workloads.