Search Products
=================================

Search HSN codes by product keywords using fuzzy matching.

.. note::
   Once you get the HSN code, use the other endpoints to get tax rates, cess rates & meta information about the product
   

API Endpoint
------------

.. code-block:: bash

   GET /fuzzysearch/product?query={keyword}

Example Request
---------------

.. code-block:: bash

   curl --location '<BASE_URL>/fuzzysearch/product?query=corn'

Example Response
----------------

.. code-block:: json

  [
      {
          "matchPercentage": "30.00%",
          "hsn": "1904",
          "option": "Prepared foods obtained by the swelling or roasting of cereals or cereal products (for example, corn flakes); cereals (other than maize (corn)) in grain form or in the form of flakes or other worked grains (except flour, groats and meal), pre-cooked, or otherwise prepared, not elsewhere specified or included",
          "matches": [
              {
                  "hsn": "19041010",
                  "option": "Corn flakes"
              },
              {
                  "hsn": "19041020",
                  "option": "Puffed rice, commonly known as murmura, mudi, pori or khoi"
              },
              {
                  "hsn": "19041030",
                  "option": "Bulgur wheat"
              },
              {
                  "hsn": "19041090",
                  "option": "Other"
              },
              {
                  "hsn": "19042000",
                  "option": "Prepared foods obtained from unroasted cereal flakes or from mixtures of unroasted cereal flakes and roasted cereal flakes or swelled cereals"
              },
              {
                  "hsn": "19043000",
                  "option": "Bulgur wheat"
              },
              {
                  "hsn": "19049000",
                  "option": "Other prepared cereals"
              }
          ]
      },
      {
          "matchPercentage": "20.00%",
          "hsn": "1005",
          "option": "Maize (corn)",
          "matches": [
              {
                  "hsn": "10051000",
                  "option": "Maize seed"
              },
              {
                  "hsn": "10059000",
                  "option": "Other maize"
              }
          ]
      }
  ]

Field Reference
---------------

Top-Level Fields
^^^^^^^^^^^^^^^^

.. list-table::
   :header-rows: 1
   :widths: 25 50 25

   * - Field
     - Description
     - Example
   * - matchPercentage
     - Percentage relevance of the search result to the query
     - ``30.00%``
   * - hsn
     - The top-level HSN code matched
     - ``1904``
   * - option
     - Description of the matched HSN code
     - ``Prepared foods obtained by the swelling or roasting of cereals ...``
   * - matches
     - List of sub-classifications (child HSN codes) under this match
     - ``[ { "hsn": "19041010", "option": "Corn flakes" }, ... ]``

Matches Array
^^^^^^^^^^^^^

.. list-table::
   :header-rows: 1
   :widths: 25 50 25

   * - Field
     - Description
     - Example
   * - matches[].hsn
     - Child HSN code under the parent result
     - ``19041010``
   * - matches[].option
     - Description of the child HSN code
     - ``Corn flakes``