Foot Locker

Foot Locker Reviews API

Real customer review text for one footlocker.com product by SKU or URL, 1 to 98 reviews per call (default 38), sorted most recent (default), most helpful, highest rating, lowest rating or relevance, optionally only one star rating. Returns the review statistics (total_reviews in every language, displayed_reviews, average rating, the 1-5 star distribution, recommended percent, comfort, fit and quality averages, photo count) and each review with rating, title, text, nickname, date, recommended, helpful and unhelpful votes, verified-purchaser and incentivized badges, the syndication source, secondary ratings, photos, videos and the brand's response. Slow: usually 25 to 90 seconds, so allow 240. US only. Costs 1 credit per request.

POST/api/v1/footlocker/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

A footlocker.com SKU: a search result's id, the last part of a product URL (Q5495005). One of product_id or url is required.

Example: Q5495005

urlstring

A footlocker.com product URL (its SKU is used). Alternative to product_id.

Example: https://www.footlocker.com/product/jordan-retro-1-high-og-mens/Q5495005.html

countryenum<string>default:us

us only: this endpoint covers footlocker.com (United States) and nothing else. Any other value is a 400.

Example: us

us — United States (footlocker.com), USD. The only value.

sortenum<string>default:most_recent

most_recent (default), most_helpful, highest_rating, lowest_rating or relevance.

Example: most_helpful

ratinginteger

Only reviews with this many stars, 1-5.

Example: 1

limitinteger

Reviews to return, 1-98. Defaults to 38. More reviews take longer (about 4 seconds per 30).

Example: 98

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

# This call takes 25-90 s; give your client 240 s.
res = client.footlocker.reviews(product_id="Q5495005", sort="most_recent")["data"]
stats = res["stats"]

print(stats["total_reviews"], "reviews,", stats["average_rating"], "stars,", stats["recommended_percent"], "% recommend")
for r in res["reviews"]:
    print(r["submitted_at"][:10], r["rating"], r["syndication_source"], r["title"])

Response

"product_id": "Q5495005",

"country": "us",

"sort": "most_recent",

"rating_filter": null,

"matching_reviews": 965,

"count": 38,

"response_time": 25075

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") # This call takes 25-90 s; give your client 240 s. res = client.footlocker.reviews(product_id="Q5495005", sort="most_recent")["data"] stats = res["stats"] print(stats["total_reviews"], "reviews,", stats["average_rating"], "stars,", stats["recommended_percent"], "% recommend") for r in res["reviews"]: print(r["submitted_at"][:10], r["rating"], r["syndication_source"], r["title"])