Ashley Furniture

Ashley Furniture Category API

One ashleyfurniture.com category's products by path or category URL, 30 per page, sorted by best sellers, price, newest, customer rating or name and filtered by any facet (color, design, number of pieces, rating ...) or a price range. Each product has its item number, brand, UPC, price, Ashley's Regular Price, percent off, sale, clearance and other badges, promotion, rating, review count, stock text and delivery method; the answer adds the category's breadcrumbs, the exact total, facets with counts and the ZIP and price zone it was priced for (priced_for). us only. Costs 2 credits per request.

POST/api/v1/ashley/category

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

pathstring

A category path: the part after /c/ in an ashleyfurniture.com category URL (furniture/living-room/sofas, furniture/living-room/sectional-sofas). Send path or category_url.

Example: furniture/living-room/sofas

category_urlstring

An ashleyfurniture.com category page (a /c/ URL). Refinements already in the URL are kept.

Example: https://www.ashleyfurniture.com/c/furniture/living-room/sectional-sofas/

countrystringdefault:us

us only (ashleyfurniture.com). Any other market answers 400 before anything is charged.

Example: us

pageintegerdefault:1

Grid page, 1-based, 30 products per page, up to 100. A page past the last returns no items and a note.

Example: 2

sortenum<string>default:best_sellers

Result order. A grid that does not offer the sort says so in notes.

Example: price_asc

best_sellers — Ashley's best sellers. The default.
price_asc — Price, low to high.
price_desc — Price, high to low.
newest — Newest first.
rating — Customer rating, best first.
name — Name, A to Z.

filtersobject

Facet refinements from the answer's facets: {"<facets[].id>": "<options[].value>"}, several values of one facet as a list (any of them matches). At most 6 facets per call.

Example: {"facetUpholsteryDesign": "Chaise"}

price_minnumber

Lowest price (USD). The range is applied to Ashley's own price list, so an item priced for another region can sit just outside it.

Example: 500

price_maxnumber

Highest price (USD).

Example: 1500

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key", timeout=120)

# Sectionals with a chaise between $500 and $1,500, highest price first.
r = client.ashley.category(
    path="furniture/living-room/sectional-sofas",
    filters={"facetUpholsteryDesign": "Chaise"},
    price_min=500, price_max=1500, sort="price_desc",
)["data"]
print(r["total"], "products, priced for", r["priced_for"])
for i in r["items"]:
    print(i["sku"], i["name"], i["price"], "regular", i["regular_price"], i["stock_text"])

Response

"country": "us",

"language": "en",

"currency": "USD",

"source_domain": "ashleyfurniture.com",

"count": 30,

"total": 343,

"page": 1,

"page_size": 30,

"total_pages": 12,

"sort": "best_sellers",

"requested_filters": {},

"response_time": 3772

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key", timeout=120) # Sectionals with a chaise between $500 and $1,500, highest price first. r = client.ashley.category( path="furniture/living-room/sectional-sofas", filters={"facetUpholsteryDesign": "Chaise"}, price_min=500, price_max=1500, sort="price_desc", )["data"] print(r["total"], "products, priced for", r["priced_for"]) for i in r["items"]: print(i["sku"], i["name"], i["price"], "regular", i["regular_price"], i["stock_text"])