Get collection products count
Use this endpoint to retrieve the number of products available within a specific Collection. Use this for display purposes or pagination planning before fetching the full product list.
Required fields:
collectionId- the Collection identifier, passed as a path parameterminBudgetquery parameter - inclusive minimum budget (1-20,000)maxBudgetquery parameter - inclusive maximum budget (1-20,000)
Optional parameters:
countriesquery parameter - comma-separated list of supported countries (defaultUS)Request-Sourceheader - source of the request
Please note:
- Returns a single
countfield with the total number of products matching the supplied budget range and country filter. - Returns
422when the Collection doesn’t exist or isn’t accessible.
Permissions
- Requires:
products:read
Authorizations
Company Level Authentication
Company level authentication provides access to all resources under your company, including accounts, campaigns, gifts, and recipients.
Getting Your API Key
- Create an API Key: Use the
POST /v2/authentication/apiKeysendpoint to generate a new API key - Set Expiration: Choose from 30, 60, 90, or 180 days (default: 90 days)
- Optional mTLS: Enable mutual TLS for enhanced security
- Name Your Key: Provide a descriptive name for easy identification
Using Your API Key
Include your API key in the X-Api-Key header for every request:
X-Api-Key: YOUR_24_CHARACTER_API_KEYAPI Key Management
- Maximum Keys: Up to 3 active API keys per company
- Rotation: Delete old keys before creating new ones when at the limit
- Security: Keys are hashed and cannot be retrieved after creation
Enhanced Security (mTLS)
For production environments, enable mutual TLS authentication:
- Set
enforceMtls: truewhen creating the API key - Contact support to obtain your client certificates
- Use the mTLS endpoint:
https://mtls-api.snappy.com/public-api
Headers
Source of the request
api_native, api_zapier, api_salesforce, api_ftp, api_make "api_native"
Path Parameters
Collection ID.
^[A-Za-z0-9]{8,}$"abcdef12"
Query Parameters
Minimum budget
1 <= x <= 200001
Maximum budget
1 <= x <= 2000010000
List of supported countries
1["US"]Response
Successful response
Response containing collection products count.
Total number of products in the collection.
x >= 042