Grailed Product Scraper

Extract rich Grailed listing data for fashion research, resale tracking, pricing analysis, and inventory monitoring. This actor collects structured product records from search, brand, and category pages with scalable pagination and clean dataset output.

---

Features

• Search, Brand, and Category Support — Run with a Grailed URL or a keyword.
• Keyword Priority Logic — If both URL and keyword are provided, keyword always wins.
• Paginated Collection — Collect exactly the number of items you request.
• Clean Output Records — Null and empty values are removed from every dataset item.
• Seller and Pricing Context — Includes listing, pricing, seller, and shipping-related fields.

---

Use Cases

Resale Market Intelligence

Track current listing prices, seller quality, and listing freshness to understand demand by brand or category.

Competitive Pricing Analysis

Build historical datasets for keyword-based products and compare price movement over time.

Sourcing and Curation

Find listings by category, size, condition, and designer to support sourcing decisions.

Catalog Monitoring

Monitor changes in newly bumped listings across specific search terms or URL paths.

---

Input Parameters

Parameter	Type	Required	Default	Description
url	String	No	"https://www.grailed.com/shop?query=shirt"	Grailed page URL (search, brand, or category).
keyword	String	No	"shirt"	Search term. If present, it overrides URL-derived terms.
results_wanted	Integer	No	20	Maximum number of listings to save.
max_pages	Integer	No	5	Maximum number of result pages to process.
proxyConfiguration	Object	No	Apify Residential Proxy	Proxy settings for reliability.

---

Output Data

Each dataset item contains rich listing metadata. Common fields include:

Field	Type	Description
listing_id	String	Grailed listing identifier.
title	String	Listing title.
url	String	Direct listing URL.
designer_names	String	Designer label(s) for the listing.
price	Number	Listing price value.
size	String	Item size.
condition	String	Condition tag.
category_path	String	Category path classification.
location	String	Seller location.
photo_url	String	Main listing image URL.
seller_username	String	Seller username.
seller_rating_average	Number	Seller average rating.
seller_rating_count	Number	Total seller ratings.
sold	Boolean	Sold state.
created_at	String	Listing creation timestamp.
bumped_at	String	Latest bump timestamp.
input_keyword	String	Effective keyword used in run.
input_url	String	URL used in run.
page	Number	Source result page number.

---

Usage Examples

Keyword Search

{
	"keyword": "shirt",
	"results_wanted": 20,
	"max_pages": 5
}

URL Search Page

{
	"url": "https://www.grailed.com/shop?query=hoodie",
	"results_wanted": 30,
	"max_pages": 6
}

Brand URL Pattern

{
	"url": "https://www.grailed.com/designers/nike",
	"results_wanted": 25,
	"max_pages": 5
}

Category URL Pattern

{
	"url": "https://www.grailed.com/categories/short-sleeve-shirts",
	"results_wanted": 25,
	"max_pages": 5
}

---

Sample Output

{
	"listing_id": 95470037,
	"title": "Vintage Oasis Box Logo Band T-shirt Black",
	"url": "https://www.grailed.com/listings/95470037",
	"designer_names": "Band Tees × Vintage",
	"price": 38,
	"size": "xl",
	"condition": "is_gently_used",
	"category_path": "tops.short_sleeve_shirts",
	"location": "Europe",
	"photo_url": "https://media-assets.grailed.com/prd/listing/temp/55e89d483c5045908063f29a1894f556",
	"seller_username": "soslangodmode",
	"seller_rating_average": 5,
	"seller_rating_count": 41,
	"sold": false,
	"created_at": "2026-04-16T08:17:59.046Z",
	"bumped_at": "2026-04-16T08:17:59.046Z",
	"input_keyword": "shirt",
	"input_url": "https://www.grailed.com/shop?query=shirt",
	"page": 1
}

---

Tips for Best Results

Start Small

Use results_wanted: 20 for quick validation, then scale up.

Set Page Caps

Keep max_pages aligned with your target volume to reduce unnecessary calls.

Use Proxies for Stability

Residential proxies are recommended for consistent large-volume collection.

---

Integrations

• Google Sheets — Build sortable trend tables.
• Airtable — Create searchable listing dashboards.
• Make — Trigger automated workflows from fresh data.
• Zapier — Send new listings to downstream tools.
• Webhooks — Push results to custom services.

Export Formats

• JSON — Structured API-friendly output.
• CSV — Spreadsheet and BI workflows.
• Excel — Reporting-ready exports.
• XML — Legacy system integrations.

---

Frequently Asked Questions

Does keyword override URL?

Yes. When both are provided, the actor uses the keyword value.

Can I scrape brand and category URLs?

Yes. Brand, category, and search URLs are supported.

Why are some fields missing?

The actor removes null and empty values to keep output clean.

Can I collect more than one page?

Yes. Increase max_pages and results_wanted.

Is proxy configuration required?

Not always, but it is recommended for reliable production runs.

---

Support

Use Apify Console issue reporting for bug reports and feature requests.

---

Legal Notice

This actor is intended for legitimate data collection and analysis workflows. Users are responsible for complying with applicable laws and platform terms.