[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"api-page:iherb-product-data-api":3},{"status":4,"api":5,"seo":160},"success",{"blocked":6,"description":7,"about":8,"stats":9,"name":11,"title":12,"slug":13,"logo":14,"created_at":15,"agent":16,"user":28,"endpoint_groups":31,"faqs":137,"features":138,"periodic_plans":139,"payasyougo_plans":158,"createdAtText":159},false,"Easily query over 40,000 products with multiple filters like price, reviews, discounts, availability, and more. You can also export a .zip file containing the latest product data.","# iHerb API\n\nWelcome to the **iHerb API**! This API allows you to retrieve a list of products by brand from the iHerb database, get all available brands, or even download a zip file with over 40,000 products (see plans for more details).\n\n## **Endpoints**\n\n### **GET** `/brands/{brandName}/products`\n\nRetrieve a list of products for a specific brand with optional filters.\n\n#### **Path Parameters**\n\n| Parameter | Type | Required | Description |\n| --- | --- | --- | --- |\n| `brandName` | string | Yes | The name of the brand to search. |\n\n#### **Query Parameters**\n\n| Parameter | Type | Description | Default |\n| --- | --- | --- | --- |\n| `page` | `int` | Page number for pagination. | 1 |\n| `productId` | `long` | Specific product ID to filter results. | null |\n| `prohibitedAtCountry` | `bool` | Filter out products that are prohibited in the current country. | null |\n| `upcCode` | `string` | Universal Product Code (UPC) to search for a specific product. | null |\n| `hasDiscount` | `bool` | Filter products that have a discount available. | null |\n| `hasStock` | `bool` | Filter products that are currently in stock. | null |\n| `hasNewProductFlag` | `bool` | Filter products marked as new. | null |\n| `isTrial` | `bool` | Filter products that are trial samples. | null |\n| `isSpecial` | `bool` | Filter products with special flags. | null |\n| `minPrice` | `float` | Minimum price for filtering. | null |\n| `maxPrice` | `float` | Maximum price for filtering. | null |\n| `minShippingWeight` | `float` | Minimum shipping weight for filtering. | null |\n| `maxShippingWeight` | `float` | Maximum shipping weight for filtering. | null |\n| `minRating` | `float` | Minimum rating value for filtering. | null |\n| `minDiscountPercent` | `int` | Minimum percentage discount for filtering. | null |\n\n## **Response Format**\n\nThe response is returned in JSON format, containing details about the products.\n\n### **Example Response**\n\n```json\n{\n  \"currentPage\": 1,\n  \"totalPages\": 5,\n  \"products\": [\n    {\n      \"productId\": 12345,\n      \"brandName\": \"iHerb\",\n      \"brandNameInHifenCase\": \"i-herb\",\n      \"brandId\": \"b123\",\n      \"outOfStock\": false,\n      \"isDiscontinued\": false,\n      \"title\": \"Vitamin D3 5000 IU\",\n      \"link\": \"https://www.iherb.com/vitamin-d3\",\n      \"sku\": \"VITD3-5000\",\n      \"formattedPrice\": \"$19.99\",\n      \"isSpecial\": false,\n      \"isTrial\": false,\n      \"hasNewProductFlag\": true,\n      \"productCatalogImage\": \"https://www.iherb.com/images/vitamin-d3.jpg\",\n      \"ratingValue\": 4.7,\n      \"reviewCount\": 120,\n      \"currencyUsed\": \"USD\",\n      \"countryUsed\": \"US\",\n      \"languageUsed\": \"en\",\n      \"unitsOfMeasureUsed\": \"oz\",\n      \"price\": 19.99,\n      \"formattedTrialPrice\": null,\n      \"trialPrice\": 0.0,\n      \"formattedSpecialPrice\": null,\n      \"specialPrice\": 0.0,\n      \"discountPercentValue\": \"10%\",\n      \"hasDiscount\": true,\n      \"soldPercent\": \"20%\",\n      \"prohibitedAtCountry\": false,\n      \"shippingWeight\": 0.5,\n      \"packageQuantity\": \"1 bottle\",\n      \"dimensions\": {\n        \"height\": 5.0,\n        \"length\": 2.5,\n        \"width\": 2.5,\n        \"weight\": 0.5\n      },\n      \"lastUpdate\": \"2024-11-20T10:30:00Z\",\n      \"allDescription\": \"This is a high-quality Vitamin D3 supplement...\",\n      \"hasAllData\": true,\n      \"productImages\": [\n        \"https://www.iherb.com/images/vitamin-d3-front.jpg\",\n        \"https://www.iherb.com/images/vitamin-d3-back.jpg\"\n      ],\n      \"stockLeft\": 0,\n      \"bestByApproximately\": \"2025-08-15\",\n      \"upcCode\": \"123456789012\",\n      \"variation\": {\n        \"variationType\": \"Flavor\",\n        \"variationDescription\": \"Orange Flavor\"\n      },\n      \"serving\": {\n        \"servingType\": \"Capsules\",\n        \"servingDescription\": \"1 capsule per serving\"\n      },\n      \"categories\": [\n        \"Supplements\",\n        \"Vitamins\"\n      ],\n      \"supplementFacts\": {\n        \"servingSize\": \"1 capsule\",\n        \"servingsPerContainer\": \"90\",\n        \"nutritionalFacts\": [\n          {\n            \"substancy\": \"Vitamin D3\",\n            \"amountPerServing\": \"5000 IU\",\n            \"dailyValuePercent\": \"1250%\"\n          }\n        ],\n        \"disclaimer\": \"These statements have not been evaluated by the FDA...\"\n      }\n    }\n  ]\n}\n```\n\n## **Response Fields**\n\n| **Field** | **Type** | **Description** |\n| --- | --- | --- |\n| `currentPage` | `int` | The current page number of the paginated response. |\n| `totalPages` | `int` | The total number of pages available. |\n| `products` | `List` | A list of products retrieved based on the filters and brand specified. |\n| `productId` | `int` | Unique ID of the product. |\n| `brandName` | `string` | Name of the brand. |\n| `brandNameInHifenCase` | `string` | Brand name formatted in hyphen-case. |\n| `brandId` | `string` | Unique ID of the brand. |\n| `outOfStock` | `bool` | Indicates if the product is currently out of stock. |\n| `isDiscontinued` | `bool` | Indicates if the product has been discontinued. |\n| `title` | `string` | Product title. |\n| `link` | `string` | URL link to the product page. |\n| `sku` | `string` | Stock Keeping Unit (SKU) identifier. |\n| `formattedPrice` | `string` | Formatted display price of the product. |\n| `isSpecial` | `bool` | Flag indicating if the product is marked as special. |\n| `isTrial` | `bool` | Flag indicating if the product is a trial sample. |\n| `hasNewProductFlag` | `bool` | Indicates if the product is marked as new. |\n| `productCatalogImage` | `string` | URL of the product’s catalog image. |\n| `ratingValue` | `float` | Average rating value of the product. |\n| `reviewCount` | `int` | Number of reviews for the product. |\n| `currencyUsed` | `string` | Currency code used for the product price. |\n| `countryUsed` | `string` | Country code representing the product’s origin or sale location. |\n| `languageUsed` | `string` | Language code used for the product’s description. |\n| `unitsOfMeasureUsed` | `string` | Unit of measure used for the product. |\n| `price` | `float` | Actual product price in float format. |\n| `formattedTrialPrice` | `string` | Formatted price if the product is a trial sample. |\n| `trialPrice` | `float` | Actual trial price in float format. |\n| `formattedSpecialPrice` | `string` | Formatted price if the product is on special offer. |\n| `specialPrice` | `float` | Actual special offer price in float format. |\n| `discountPercentValue` | `string` | Discount percentage if applicable. |\n| `hasDiscount` | `bool` | Indicates if the product has a discount. |\n| `soldPercent` | `string` | Percentage of stock sold. |\n| `prohibitedAtCountry` | `bool` | Indicates if the product is prohibited in the specified country. |\n| `shippingWeight` | `float` | The weight of the product used for shipping calculations. |\n| `packageQuantity` | `string` | Quantity description of the package. |\n| `dimensions` | `object` | Product’s physical dimensions (height, length, width, weight). |\n| `lastUpdate` | `string` | The last update date and time of the product information. |\n| `allDescription` | `string` | Full product description text. |\n| `hasAllData` | `bool` | Indicates if all detailed product data is included. |\n| `productImages` | `List` | List of URLs for the product’s images. |\n| `stockLeft` | `int` | Amount of stock left for the product. Pay attention: if zero it means stock IS available (not tracked individually). |\n| `bestByApproximately` | `string` | Approximate best-by date for the product. |\n| `upcCode` | `string` | UPC (Universal Product Code) of the product. |\n| `variation` | `object` | Information about product variations (e.g., flavor, size). |\n| `serving` | `object` | Information about serving size and description. |\n| `categories` | `List` | List of categories the product belongs to. |\n| `supplementFacts` | `object` | Detailed supplement facts, including serving size and nutritional information. |\n\n### Usage Tips\n\n*   Use pagination with the `page` parameter to navigate through large datasets.\n*   Use the filters provided in the query parameters to get more specific results.\n\n* * *\n\n## Get All Brands\n\nRetrieve a paginated list of all brands available in the iHerb database.\n\n### **GET** `/api/IHerb/brands?page={page}`\n\n### Query Parameters\n\n| Parameter | Type | Required | Default | Description |\n| --- | --- | --- | --- | --- |\n| `page` | `int` | No | 1 | The page number for paginated results. Use this to navigate through the list of brands. |\n\n### Response Format\n\n```json\n{\n  \"currentPage\": 1,\n  \"totalPages\": 50,\n  \"allBrands\": [\n    \"Brand1\",\n    \"Brand2\",\n    \"Brand3\",\n    \"...\",\n    \"BrandN\"\n  ]\n}\n```\n\n### Response Fields\n\n| Field | Type | Description |\n| --- | --- | --- |\n| `currentPage` | `int` | The current page of the results. |\n| `totalPages` | `int` | The total number of pages available. |\n| `allBrands` | `List\u003Cstring>` | A list of brand names available in the iHerb database. |\n\n### Usage Tips\n\n*   Use the `page` parameter to navigate through the list of brands.\n*   This endpoint is useful to get a complete overview of all brands available on iHerb.\n\n* * *\n\n## Support\n\nFor questions or help, feel free to contact support.",{"score":10},"1.96","IHerb Product Data Api","IHerb Product Data Api API","iherb-product-data-api","https://cdn.jojapi.com/api/6fc02d26-9efb-4c87-ba41-658ad95a7cd4","2026-04-10 23:55:37",{"enabled":17,"closed":18,"request_enabled":6,"catalog_url":19,"discovery_url":20,"directory_url":21,"rails":22,"networks":25,"docs":27},true,null,"https://iherb-product-api.jojapi.net/_jojapi/agent/plans","https://iherb-product-api.jojapi.net/.well-known/x402","https://agents.jojapi.net/apis/iherb-product-data-api",[23,24],"x402","mpp",[26],"eip155:8453","https://docs.jojapi.com/consumers/agents",{"nick":29,"name":30,"verified":6,"website":18},"daniel-passos","Daniel Passos",[32],{"endpoints":33,"name":136,"description":41,"ungrouped":17},[34,63,123],{"blocked":6,"hidden":6,"agent_price":18,"credits":35,"flexible_credits_description":18,"consumptions":36,"description":42,"method":43,"name":44,"url_path":45,"root_url":46,"parameters":47,"responses":62,"result_stats":18},1,[37],{"name":38,"slug":39,"cost":40,"label":41,"avg":18},"Credits","credits","1","","Retrieve a paginated list of all brands available in the iHerb database.","GET","Get all brands","/api/IHerb/brands","https://iherb-product-api.jojapi.net",{"url":48,"header":53,"post":59,"body":60,"path":61},[49],{"key":50,"example":41,"schema":18,"example_disabled":6,"example_type":51,"value_type":51,"enum_values":18,"default_value":41,"required":6,"name":50,"description":52},"page","string","The page number for paginated results. Use this to navigate through the list of brands.",[54],{"key":55,"is_auth":17,"example":56,"example_disabled":17,"example_type":51,"name":57,"description":56,"required":17,"always_error":58},"X-JoJAPI-Key","You must log in to get API key","JoJ API Key","Please log in to get API key",[],[],[],[],{"blocked":6,"hidden":6,"agent_price":18,"credits":35,"flexible_credits_description":18,"consumptions":64,"description":66,"method":43,"name":67,"url_path":68,"root_url":46,"parameters":69,"responses":122,"result_stats":18},[65],{"name":38,"slug":39,"cost":40,"label":41,"avg":18},"Retrieve a list of products for a specific brand with optional filters.","Get products by brand","/api/IHerb/brands/{brandName}/products",{"url":70,"header":115,"post":117,"body":118,"path":119},[71,73,76,79,82,85,88,91,94,97,100,103,106,109,112],{"key":50,"example":41,"schema":18,"example_disabled":6,"example_type":51,"value_type":51,"enum_values":18,"default_value":41,"required":6,"name":50,"description":72},"Page number for pagination.",{"key":74,"example":41,"schema":18,"example_disabled":6,"example_type":51,"value_type":51,"enum_values":18,"default_value":41,"required":6,"name":74,"description":75},"productId","Specific product ID to filter results.",{"key":77,"example":41,"schema":18,"example_disabled":6,"example_type":51,"value_type":51,"enum_values":18,"default_value":41,"required":6,"name":77,"description":78},"prohibitedAtCountry","Filter out products that are prohibited in the current country.",{"key":80,"example":41,"schema":18,"example_disabled":6,"example_type":51,"value_type":51,"enum_values":18,"default_value":41,"required":6,"name":80,"description":81},"upcCode","Universal Product Code (UPC) to search for a specific product.",{"key":83,"example":41,"schema":18,"example_disabled":6,"example_type":51,"value_type":51,"enum_values":18,"default_value":41,"required":6,"name":83,"description":84},"hasDiscount","Filter products that have a discount available.",{"key":86,"example":41,"schema":18,"example_disabled":6,"example_type":51,"value_type":51,"enum_values":18,"default_value":41,"required":6,"name":86,"description":87},"hasStock","Filter products that are currently in stock.",{"key":89,"example":41,"schema":18,"example_disabled":6,"example_type":51,"value_type":51,"enum_values":18,"default_value":41,"required":6,"name":89,"description":90},"hasNewProductFlag","Filter products marked as new.",{"key":92,"example":41,"schema":18,"example_disabled":6,"example_type":51,"value_type":51,"enum_values":18,"default_value":41,"required":6,"name":92,"description":93},"isTrial","Filter products that are trial samples.",{"key":95,"example":41,"schema":18,"example_disabled":6,"example_type":51,"value_type":51,"enum_values":18,"default_value":41,"required":6,"name":95,"description":96},"isSpecial","Filter products with special flags.",{"key":98,"example":41,"schema":18,"example_disabled":6,"example_type":51,"value_type":51,"enum_values":18,"default_value":41,"required":6,"name":98,"description":99},"minPrice","Minimum price for filtering.",{"key":101,"example":41,"schema":18,"example_disabled":6,"example_type":51,"value_type":51,"enum_values":18,"default_value":41,"required":6,"name":101,"description":102},"maxPrice","Maximum price for filtering.",{"key":104,"example":41,"schema":18,"example_disabled":6,"example_type":51,"value_type":51,"enum_values":18,"default_value":41,"required":6,"name":104,"description":105},"minShippingWeight","Minimum shipping weight for filtering.",{"key":107,"example":41,"schema":18,"example_disabled":6,"example_type":51,"value_type":51,"enum_values":18,"default_value":41,"required":6,"name":107,"description":108},"maxShippingWeight","Maximum shipping weight for filtering.",{"key":110,"example":41,"schema":18,"example_disabled":6,"example_type":51,"value_type":51,"enum_values":18,"default_value":41,"required":6,"name":110,"description":111},"minRating","Minimum rating value for filtering.",{"key":113,"example":41,"schema":18,"example_disabled":6,"example_type":51,"value_type":51,"enum_values":18,"default_value":41,"required":6,"name":113,"description":114},"minDiscountPercent","Minimum percentage discount for filtering.",[116],{"key":55,"is_auth":17,"example":56,"example_disabled":17,"example_type":51,"name":57,"description":56,"required":17,"always_error":58},[],[],[120],{"key":121,"example":41,"example_disabled":6,"example_type":51,"value_type":51,"enum_values":18,"name":41,"description":41,"required":17},"brandName",[],{"blocked":6,"hidden":6,"agent_price":18,"credits":35,"flexible_credits_description":18,"consumptions":124,"description":126,"method":43,"name":126,"url_path":127,"root_url":46,"parameters":128,"responses":135,"result_stats":18},[125],{"name":38,"slug":39,"cost":40,"label":41,"avg":18},"teste","/teste",{"url":129,"header":130,"post":132,"body":133,"path":134},[],[131],{"key":55,"is_auth":17,"example":56,"example_disabled":17,"example_type":51,"name":57,"description":56,"required":17,"always_error":58},[],[],[],[],"Ungrouped Endpoints",[],[],[140],{"type":141,"slug":142,"blocked":6,"period":143,"currency":144,"pricing":145,"rate_limit":150,"objects":153,"name":156,"display_name":18,"features":157},"periodic","pfj95vgvj8ihxi1h27uix44e","1 MONTH","usd",{"price":146,"credits":147,"past_due_timeout_num":148,"past_due_timeout_type":149},0,300,3,"DAY",{"max_requests":151,"time_window":152},30,60,[154],{"id":155,"name":38,"slug":39,"quota":147,"tiers":18},"n4f3562a0","300 Credits",[],[],"2026-04-10",{"canonical":161,"page_title":162,"meta":163},"https://jojapi.com/hub/api/iherb-product-data-api","IHerb Product Data Api API Documentation & Playground - JoJ API",{"description":7,"keywords":164},"API,API Documentation,API Playground,Plans & Pricing,IHerb Product Data Api,daniel-passos"]