--- title: "Search for products using specified criteria." method: POST path: "/crm/objects/2026-03/products/search" tags: ["Search"] --- # Search for products using specified criteria. `POST /crm/objects/2026-03/products/search` ## Request - Base URL: `https://api.hubapi.com` - URL: `https://api.hubapi.com/crm/objects/2026-03/products/search` - Auth: none required Execute a search for products based on defined filters, properties, and sorting options. This endpoint allows for detailed querying of product data within the CRM, enabling users to retrieve specific product information by applying multiple filter groups and sorting criteria. ## Request body - PublicObjectSearchRequest: Describes a search request - `after` string, required: A paging cursor token for retrieving subsequent pages. - `filterGroups` FilterGroup[], required: Up to 6 groups of filters defining additional query criteria. - `filters` Filter[], required: A list of individual filter criteria that are applied together as a group. Each filter specifies a condition that records must meet to be included in the results. - `highValue` string: The upper boundary value when using ranged-based filters. - `operator` 'BETWEEN' | 'CONTAINS_TOKEN' | 'EQ' | 'GT' | 'GTE' | 'HAS_PROPERTY' | 'IN' | 'LT' | 'LTE' | 'NEQ' | 'NOT_CONTAINS_TOKEN' | 'NOT_HAS_PROPERTY' | 'NOT_IN', required: The comparison operator used in the filter, such as "EQ" or "GT". - `propertyName` string, required: The name of the property to apply the filter to. - `value` string: The value to match against the property. - `values` string[]: The values to match against the property. - `limit` integer, required: The maximum results to return, up to 200 objects. - `properties` string[], required: A list of property names to include in the response. - `query` string: The search query string, up to 3000 characters. - `sorts` string[], required: Specifies sorting order based on object properties. ## Response `200` successful operation - CollectionResponseWithTotalSimplePublicObject: Represents a list of simple objects returned from an API request, along with the total count of objects available. - `paging` Paging: Represents the pagination information for navigating through a list of results in the API. It provides details on how to access the previous or next set of results. - `next` NextPage: Specifies the paging information needed to retrieve the next set of results in a paginated API response - `after` string, required: A paging cursor token for retrieving subsequent pages. - `link` string: A URL that can be used to retrieve the next page results. - `prev` PreviousPage: specifies the paging information needed to retrieve the previous set of results in a paginated API response - `before` string, required: A paging cursor token for retrieving previous pages. - `link` string: A URL that can be used to retrieve the previous pages' results. - `results` SimplePublicObject[], required: An array containing the simple public objects returned in the current page of the response. This property is required. - `archived` boolean, required: Whether the object is archived. - `archivedAt` string, date-time: The timestamp when the object was archived, in ISO 8601 format. - `createdAt` string, date-time, required: The timestamp when the object was created, in ISO 8601 format. - `id` string, required: The unique ID of the object. - `objectWriteTraceId` string: An identifier used to trace the write request for the object. Set a unique ID for each write operation; it is returned with any errors so you can identify which request encountered which error. - `properties` object, required: Key-value pairs representing the properties of the object. - `propertiesWithHistory` object: Key-value pairs representing the properties of the object along with their history, each with a timestamp and source information. - `updatedAt` string, date-time, required: The timestamp when the object was last updated, in ISO 8601 format. - `url` string: The URL associated with the object. - `warnings` PublicObjectWarning[] - `category` string, required: The classification of the warning, indicating the type or nature of the issue. - `context` object, required: Additional information or metadata about the warning, providing context for understanding the issue. - `message` string, required: The text of the warning message, providing information about the issue or alert. - `total` integer, required: The number of available results ## Other responses - `default`: An error occurred. ## Changes - **2026-09-22** (2026-03) `7002ca32ceea`: 2 info - the endpoint scheme security `oauth2` was removed from the API - the endpoint scheme security `oauth2` was removed from the API - **2026-09-10** (2026-03) `f3a9e956579d`: 2 info - the security scope `crm.objects.products.read` was added to the endpoint's security scheme `oauth2` - the security scope `e-commerce` was removed from the endpoint's security scheme `oauth2` - **2026-09-09** (2026-03) `512fb8528251`: 2 info - the security scope `crm.objects.products.read` was added to the endpoint's security scheme `oauth2` - the security scope `e-commerce` was removed from the endpoint's security scheme `oauth2` - **2026-09-07** (2026-03) `4111d7a802ac`: 2 info - the security scope `crm.objects.products.read` was added to the endpoint's security scheme `oauth2` - the security scope `e-commerce` was removed from the endpoint's security scheme `oauth2` - **2026-09-04** (2026-03) `958b91a563fc`: 2 info - the security scope `crm.objects.products.read` was added to the endpoint's security scheme `oauth2` - the security scope `e-commerce` was removed from the endpoint's security scheme `oauth2` [Operation history](https://skmtc.dev/hubspot/apis/crm-products/changes/crm/objects/2026-03/products/search/post.md) --- [API](https://skmtc.dev/hubspot/apis/crm-products.md) - [All operations](https://skmtc.dev/hubspot/apis/crm-products/llms.txt) - [OpenAPI document](https://skmtc.dev/hubspot/apis/crm-products/revisions/019b1f9c1aa5?raw)