{"id":2562,"date":"2024-12-31T20:23:00","date_gmt":"2024-12-31T20:23:00","guid":{"rendered":"https:\/\/meetanshi.com\/blog\/magento-2-api-searchcriteria\/"},"modified":"2025-04-09T17:42:55","modified_gmt":"2025-04-09T12:12:55","slug":"magento-2-api-searchcriteria","status":"publish","type":"post","link":"https:\/\/meetanshi.com\/blog\/magento-2-api-searchcriteria\/","title":{"rendered":"Magento 2 API – SearchCriteria"},"content":{"rendered":"\n

Hello, Magento peeps!<\/p>\n\n\n\n

I am here with another Magento 2 API<\/a> tutorial on SearchCriteria. In my last blog post, I provided a complete step-wise guide to getting a product by SKU using Magento 2 REST API. In case you missed it, you can read it at Magento 2 API \u2013 Get Product by SKU<\/a>.<\/p>\n\n\n\n

SearchCriteria in Magento 2 API is useful to add the search\/filter functionality when developing a third-party application based on Magento 2. Suppose you want to facilitate the visitors on your Magento 2 app to search for products. In such cases, you can use the SearchCriteria in API to perform search or filter operations.<\/p>\n\n\n\n

In this post, I will show you how to use SearchCriteria in Magento 2 API.<\/p>\n\n\n\n

Let\u2019s begin with the Magento 2 API Search Criteria!<\/p>\n\n\n\n

What is Magento 2 SearchCriteria?<\/h2>\n\n\n\n

According to Adobe Commerce DevDocs<\/a>, A SearchCriteria is an implementation of the SearchCriteriaInterface class that allows you to build custom requests with different conditions. The SearchCriteria endpoint in the API is useful for fetching the data from the repository using various conditions.<\/p>\n\n\n\n

The SearchCriteria is specified in the URL of the GET request. The basic structure of the same is provided below.<\/p>\n\n\n\n

searchCriteria[filter_groups][][filters][][field]=\nsearchCriteria[filter_groups][][filters][][value]=\nsearchCriteria[filter_groups][][filters][][condition_type]=<\/pre>\n\n\n\n
where the field name, search value, and operators can be changed as per the requirement. Provided below is the list of the search operators for the SearchCriteria endpoint:<\/p>\n\n\n\n
list of the search operators<\/strong><\/h3>\n\n\n\n
Operator<\/strong><\/th>Details<\/strong><\/th><\/tr><\/thead>
eq<\/code><\/td>Equals<\/td><\/tr>
finset<\/code><\/td>A value within a set of values<\/td><\/tr>
from<\/code><\/td>The beginning of a range. Must be used with to<\/strong>.<\/td><\/tr>
gt<\/code><\/td>Greater than<\/td><\/tr>
gteq<\/code><\/td>Greater than or equal<\/td><\/tr>
in<\/code><\/td>The value can contain a comma-separated list of values.<\/td><\/tr>
like<\/code><\/td>The value can contain the SQL wildcard characters when like is specified.<\/td><\/tr>
lt<\/code><\/td>Less than<\/td><\/tr>
lteq<\/code><\/td>Less than or equal<\/td><\/tr>
moreq<\/code><\/td>More or equal<\/td><\/tr>
neq<\/code><\/td>Not equal<\/td><\/tr>
nfinset<\/code><\/td>A value that is not within a set of values.<\/td><\/tr>
nin<\/code><\/td>Not in. The value can contain a comma-separated list of values<\/strong>.<\/td><\/tr>
nlike<\/code><\/td>Not like<\/td><\/tr>
notnull<\/code><\/td>Not null<\/td><\/tr>
null<\/code><\/td>Null<\/td><\/tr>
to<\/code><\/td>The end of a range. Must be used with from<\/strong>.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
How to Use Magento 2 SearchCriteria in Rest API?<\/h2>\n\n\n\n
In order to search for products containing a \u201cbag\u201d word, we\u2019ll use the SearchCriteria rest point with \u2018name\u2019 as field and \u2018bag\u2019 as value using the like<\/strong> operator. Complete API request for the same is provided below.<\/p>\n\n\n\n
Method: <\/strong>GET<\/p>\n\n\n\n
URL: <\/strong>store_url\/rest\/V1\/products<\/em><\/p>\n\n\n\n
Params:<\/strong><\/p>\n\n\n\n
Key<\/strong><\/th>Value<\/strong><\/th><\/tr><\/thead>
searchCriteria[filter_groups][0][filters][0][field]<\/code><\/td>name<\/td><\/tr>
searchCriteria[filter_groups][0][filters][0][value]<\/code><\/td>bag<\/td><\/tr>
searchCriteria[filter_groups][0][filters][0][condition_type]<\/code><\/td>like<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
It will build the request with the SearchCriteria as below:
<\/p>\n\n\n\n
GET store_url\/rest\/V1\/products?\nsearchCriteria[filter_groups][0][filters][0][field]=name&amp;\nsearchCriteria[filter_groups][0][filters][0][value]=bag&amp;\nsearchCriteria[filter_groups][0][filters][0][condition_type]=like<\/pre>\n\n\n\n
Response:<\/strong><\/p>\n\n\n\n
On calling the API request in Magento 2 with the above URL and params, it will return the list of the products containing the \u2018bag\u2019 word in the name attribute.<\/p>\n\n\n\n
In the same way, the SearchCriteria can be used to perform search and filter functions in Magento 2 using the APIs.<\/p>\n\n\n\n
Conclusion<\/h2>\n\n\n\n
Magento 2 is a powerful\u00a0eCommerce platform<\/a>, the functionalities of which can be augmented to other applications through the use of APIs. Magento 2 SearchCriteria is very useful for performing search and filter functions while developing third-party applications. I hope this complete tutorial will help you understand how to use SearchCriteria in Magento 2 API. <\/p>\n\n\n\n
If you loved reading this blog, then do not forget to share it with your Magento 2 friends through social media.  <\/p>\n\n\n\n
Thanks for reading!  <\/p>\n\n\n\n
\n
Magento 2 API \u2013 Get Product by SKU<\/a><\/div>\n\n\n\n
Magento 2 API \u2013 Get All Available Currencies<\/a><\/div>\n<\/div>\n","protected":false},"excerpt":{"rendered":"
Hello, Magento peeps! I am here with another Magento 2 API tutorial on SearchCriteria. In my last blog post, I provided a complete step-wise guide to getting…<\/p>\n","protected":false},"author":13,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[34],"tags":[],"class_list":["post-2562","post","type-post","status-publish","format-standard","hentry","category-magento"],"acf":[],"_links":{"self":[{"href":"https:\/\/meetanshi.com\/blog\/wp-json\/wp\/v2\/posts\/2562","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/meetanshi.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/meetanshi.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/meetanshi.com\/blog\/wp-json\/wp\/v2\/users\/13"}],"replies":[{"embeddable":true,"href":"https:\/\/meetanshi.com\/blog\/wp-json\/wp\/v2\/comments?post=2562"}],"version-history":[{"count":4,"href":"https:\/\/meetanshi.com\/blog\/wp-json\/wp\/v2\/posts\/2562\/revisions"}],"predecessor-version":[{"id":11740,"href":"https:\/\/meetanshi.com\/blog\/wp-json\/wp\/v2\/posts\/2562\/revisions\/11740"}],"wp:attachment":[{"href":"https:\/\/meetanshi.com\/blog\/wp-json\/wp\/v2\/media?parent=2562"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/meetanshi.com\/blog\/wp-json\/wp\/v2\/categories?post=2562"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/meetanshi.com\/blog\/wp-json\/wp\/v2\/tags?post=2562"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}