iHerb

iHerb Product API

One iHerb product by id or URL (US store, prices in USD): name, brand, part number, UPC, price, list price, discount, price per serving, stock status, quantity limit, expiration date, first-available date, package size, weight and dimensions, rating and review count, breadcrumbs, best-seller rankings by category, badges, variants (size, potency, flavor) with their product ids, supplement facts, description, suggested use, ingredients, warnings and images. Costs 2 credits per request; a failed attempt is not charged.

POST/api/v1/iherb/product

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json

product_idstring

iHerb product id: the number at the end of an iherb.com/pr/ URL, or a search result's product_id. A number is accepted too. Pass this or url.

Example: 70316

urlstring

An iherb.com product URL, as an alternative to product_id. Data is always the US store's, whatever the URL's country.

Example: https://www.iherb.com/pr/california-gold-nutrition-vitamin-d3-125-mcg-5-000-iu-90-fish-gelatin-softgels/70316

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

p = client.iherb.product(product_id="70316")["data"]

print(p["name"], p["price"], p["price_per_unit"]["text"], "UPC", p["upc"])
print("expires", p["expiration_date"], "| limit per order:", p["quantity_limit"])
for n in p["supplement_facts"]["nutrients"]:
    print(n["name"], n["amount"], n["daily_value"])
for r in p["rankings"]:
    print("#%d in %s" % (r["rank"], r["category"]))

Response

"product_id": "70316",

"name": "California Gold Nutrition, Vitamin D3, 125 mcg (5,000 IU), 90 Fish Gelatin Softgels",

"brand": "California Gold Nutrition",

"brand_code": "CGN",

"brand_url": "https://www.iherb.com/c/california-gold-nutrition",

"part_number": "CGN-01065",

"upc": "898220010653",

"url": "https://www.iherb.com/pr/california-gold-nutrition-vitamin-d3-125-mcg-5-000-iu-90-fish-gelatin-softgels/70316",

"price": 6.07,

"list_price": 6.07,

"currency": "USD",

"discount_percent": 0,

"discount_amount": 0,

"availability": "InStock",

"in_stock": true,

"stock_status": "In stock",

"is_available_to_purchase": true,

"is_discontinued": false,

"is_coming_soon": false,

"recent_sales": "30,000+ sold in 30 days",

"quantity_limit": 12,

"expiration_date": "04/2029",

"first_available": "09/2016",

"package_quantity": "90 count",

"shipping_weight": "0.1 lb",

"dimensions": "3.3 x 1.8 x 1.75 in",

"weight": "0.1 lb",

"rating": 4.8,

"review_count": 324874,

"category": "Supplements",

"is_iherb_brand": true,

"description": "Featuring Vitamin D3 (Cholecalciferol) Supports Healthy Bones and Teeth* Supports Healthy Immune System Function* California Gold Nutrition® Vitamin D3, 125 mcg (5,000 IU) is a high-potency vitamin D supplement and contains cholecalciferol in fish gelatin softgels. iTested Verified",

"suggested_use": "Take 1 softgel daily, with food. Best when taken as directed by a qualified healthcare professional. Do not exceed one softgel daily or take with other dietary supplements containing Vitamin D.",

"ingredients": "Main Ingredients Vitamin D (as D3, Cholecalciferol) Other Ingredients Safflower Oil and Fish Gelatin Softgel (Gelatin, Vegetable Glycerin, Purified Water). Contains: Fish (Tilapia) Not manufactured with milk, eggs, crustacean shellfish, tree nuts, peanuts, wheat, soy, sesame, or gluten. Produced in an FDA-registered, third-party audited, and cGMP-compliant facility that may process other products that contain these allergens or ingredients.",

"warnings": "Keep out of reach of children. This is a high potency Vitamin D product. Consult with a licensed physician, pharmacist, naturopath or other qualified healthcare professional prior to using this product if you are pregnant, nursing, taking prescription medications, have diagnosed medical conditions (e.g., hypercalcemia or kidney disease), or require higher Vitamin D intake. Sealed for your protection. Do not use if seal is missing or broken. Store in a cool, dry place. Protect from heat, light, and moisture.",

"response_time": 8437

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") p = client.iherb.product(product_id="70316")["data"] print(p["name"], p["price"], p["price_per_unit"]["text"], "UPC", p["upc"]) print("expires", p["expiration_date"], "| limit per order:", p["quantity_limit"]) for n in p["supplement_facts"]["nutrients"]: print(n["name"], n["amount"], n["daily_value"]) for r in p["rankings"]: print("#%d in %s" % (r["rank"], r["category"]))