iHerb

iHerb Reviews API

The review summary for one iHerb product: average rating, total review count, star histogram (count and percent per star), review counts per language, and the full text of the top positive and the top critical review with rating, title, author, country, date, verified-purchase flag, helpful votes and images. It is a summary, not a full review list. Costs 2 credits per request; a failed attempt is not charged.

POST/api/v1/iherb/reviews

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.

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")

r = client.iherb.reviews(product_id="70316")["data"]

print(r["average_rating"], "from", r["review_count"], "reviews")
for star, h in r["rating_histogram"].items():
    print(star, h["count"], "%d%%" % h["percent"])
top = r["top_positive_review"]
if top:
    print(top["rating"], top["title"], "-", top["text"])

Response

"product_id": "70316",

"average_rating": 4.8,

"review_count": 324874,

"top_critical_review": null

"response_time": 1843

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") r = client.iherb.reviews(product_id="70316")["data"] print(r["average_rating"], "from", r["review_count"], "reviews") for star, h in r["rating_histogram"].items(): print(star, h["count"], "%d%%" % h["percent"]) top = r["top_positive_review"] if top: print(top["rating"], top["title"], "-", top["text"])