AptDeco Scraper

Scrape AptDeco — the used-furniture marketplace at aptdeco.com. Search thousands of pre-owned furniture listings by keyword, category, condition, color, brand, state, and price; browse full categories; or fetch individual products by ID. HTTP-only via AptDeco's public Algolia search index. No auth, no proxy.

What this actor does

• Three modes: search, byCategory, byIds
• Filters: category + subcategory, condition, color, brand, US state, region, metro area, selling type, price range
• Rich listing data: price, original price, % off, condition, dimensions, photos, seller, geo-location
• Sorting: relevance, price low-to-high, price high-to-low
• Empty fields are omitted

Output per product

• id — AptDeco product ID
• title, description
• price, originalPrice, oldPrice, discountAmount, percentOff, priceDrop
• category (e.g. Sofas), subcategory (e.g. Sleeper Sofas)
• condition, color, material, brand, sellerName
• state, region, greaterMetroArea
• width, depth, height (inches)
• latitude, longitude
• imageUrl, additionalImageUrls[], imageCount
• deals[], deliveryOptions[], searchPhrases[]
• isAvailable, isSaleable, isDeliveryAvailable, isPickUpAvailable, isIndividualOwner, isExpiring, selfShip
• aiCategory, aiStyle, aiSubcategory
• availableFrom, availableTill, createdAt, updatedAt, rankTime
• sourceUrl — canonical product page
• recordType, scrapedAt

Input

Field	Type	Default	Description
mode	string	search	search / byCategory / byIds
searchQuery	string	sofa	Product keyword (mode=search)
category	string	–	Category (e.g. Sofas, Tables, Beds)
subcategory	string	–	Subcategory within category
ids	array	–	Product IDs (mode=byIds)
condition	string	–	good / satisfactory / new / floorDisplayModel / ageWorn
color	string	–	e.g. Dark Brown, White, Black
brand	string	–	e.g. West Elm, Article, IKEA
state	string	–	US state, e.g. New York, California
region	string	–	northeast / sfBayArea
greaterMetroArea	string	–	e.g. New York City, Chicago, Miami
sellingType	string	–	individualPieces / set
priceMin	number	–	Min price (USD)
priceMax	number	–	Max price (USD)
sortBy	string	relevance	relevance / priceAsc / priceDesc
containsKeyword	string	–	Client-side title/description/brand filter
maxItems	int	50	Hard cap (1–1000)

Example: sofas under $1000 in New York

{
  "mode": "search",
  "searchQuery": "sofa",
  "state": "New York",
  "priceMax": 1000,
  "sortBy": "priceAsc"
}

Example: browse a category

{
  "mode": "byCategory",
  "category": "Tables",
  "subcategory": "Coffee Tables",
  "condition": "good"
}

Example: specific products by ID

{
  "mode": "byIds",
  "ids": ["6981876", "6982226"]
}

Example: West Elm sofas, lowest price first

{
  "mode": "search",
  "searchQuery": "",
  "category": "Sofas",
  "brand": "West Elm",
  "sortBy": "priceAsc"
}

Use cases

• Market research — track used-furniture pricing by category, brand, and region
• Deal hunting — find steep discounts (percentOff) and price drops
• Inventory analytics — monitor listing volumes, conditions, and turnover
• Renovation / staging — source quality second-hand furniture by brand and condition
• Resale intelligence — benchmark listing prices against original retail prices

FAQ

Do I need an AptDeco account? No. The actor reads AptDeco's public Algolia search index that powers their own site search.

Is there a rate limit? The index is served by Algolia's CDN; the actor uses polite delays and retries on 429/5xx with exponential backoff.

What do the price fields mean? price is the current asking price; originalPrice is the retail price when the item was new; percentOff and priceDrop quantify the discount.

Why are some fields missing? Sellers provide varying detail. Empty fields are always omitted — a listing without a recorded color simply has no color field.

What regions does AptDeco serve? The marketplace operates mainly in the US Northeast (NY, NJ, CT, PA, DE) and the San Francisco Bay Area; some items ship or are listed elsewhere — use state / greaterMetroArea filters to narrow.

How fresh is the data? Live — every run queries the current index at that moment.

Is this affiliated with AptDeco? No, this is a third-party actor using AptDeco's public site search index.

Limitations

• byCategory with no subcategory returns the full category; without searchQuery the default relevance ordering is used. searchQuery is ignored in byCategory — the category (and optional subcategory, condition, color, brand, state, region, price) filters alone determine the results, so a leftover search term can't narrow the category to zero.
• Some older listings have state: "None" / region: "Unknown" placeholders which are omitted from output.
• AptDeco's own website is protected by AWS WAF; this actor bypasses it entirely by using the public Algolia index the site itself uses, so no browser or proxy is needed.