feat: Implement search-a-licious endpoint support

openfoodfacts/api.py

@@ -193,6 +193,9 @@ def __init__(self, api_config: APIConfig):
             environment=api_config.environment,
             country_code=self.api_config.country.name,
         )
+        # Handle environment for Search-a-licious (Requested by review)
+        domain = "net" if self.api_config.environment == Environment.net else "org"
+        self.base_searchalicious_url = f"https://search.openfoodfacts.{domain}"
 
     def get(
         self,
@@ -274,6 +277,54 @@ def text_search(
             auth=get_http_auth(self.api_config.environment),
         )
 
+    def search(
+        self,
+        query: str,
+        page: int = 1,
+        page_size: int = 24,
+        sort_by: Optional[str] = None,
+        **kwargs: Any,
+    ) -> Optional[JSONType]:
+        """Search products using the new high-performance Search-a-licious endpoint.
+
+        WARNING: This endpoint is currently in alpha version and subjected to
+        breaking changes.
+
+        :param query: the search query
+        :param page: requested page (starts at 1), defaults to 1
+        :param page_size: number of items per page, defaults to 24
+        :param sort_by: result sorting key, defaults to None
+        :param kwargs: additional filters
+        :return: the search results (standardized with 'products' list)
+        """
+        # Use the dynamic URL based on environment
+        url = f"{self.base_searchalicious_url}/search"
+
+        params = {
+            "q": query,
+            "page": page,
+            "page_size": page_size,
+        }
+
+        if sort_by:
+            params["sort_by"] = sort_by
+
+        params.update(kwargs)
+
+        # Get the raw response
+        result = send_get_request(
+            url=url,
+            api_config=self.api_config,
+            params=params,
+            auth=get_http_auth(self.api_config.environment),
+        )
+
+        # Compatibility Fix: Rename 'hits' to 'products' to match existing SDK behavior
+        if result and "hits" in result:
+            result["products"] = result.pop("hits")
+
+        return result
+
     def update(self, body: Dict[str, Any]):
         """Create a new product or update an existing one."""
         if not body.get("code"):