# Get new Grailed listings for a designer since the last run

**Use case:** 

Monitor Grailed for a designer and get only new listings since your last run, charged per new row. $2 per 1,000 listings. Quiet runs are free.

## Input

```json
{
  "searches": [
    "carhartt"
  ],
  "testRun": false,
  "onlyFound": false,
  "includeKeywords": [],
  "excludeKeywords": [],
  "listingType": "active",
  "maxListingsPerSearch": 100,
  "includeSoldComps": false,
  "maxSoldComps": 50,
  "designers": [
    "Carhartt"
  ],
  "sizes": [],
  "categories": [],
  "condition": "",
  "deltaMode": true,
  "deltaName": "new-carhartt-listings",
  "alertOnNew": true,
  "alertOnPriceDrop": true,
  "minPriceDropPct": 5,
  "skipFirstRun": false,
  "includeSellerInfo": false,
  "columns": [
    "searchQuery",
    "listingType",
    "listingCount",
    "totalAvailable",
    "truncated",
    "newCount",
    "priceDropCount",
    "monitorStatus",
    "activeCount",
    "soldCount",
    "sellThroughRate",
    "compsWindowDays",
    "activeMedianPrice",
    "soldMedianPrice",
    "askVsSoldGapPct",
    "medianDaysToSell",
    "listings",
    "listingId",
    "title",
    "price",
    "currency",
    "designers",
    "size",
    "category",
    "condition",
    "color",
    "location",
    "postedAt",
    "bumpedAt",
    "isSold",
    "soldAt",
    "soldPrice",
    "daysToSell",
    "nativePriceDropCount",
    "originalPrice",
    "popularity",
    "imageUrl",
    "sellerHash",
    "sellerId",
    "sellerName",
    "sellerProfileUrl",
    "changeType",
    "isNew",
    "previousPrice",
    "priceDropPct",
    "firstSeenAt",
    "url"
  ],
  "expandRows": true,
  "maxConcurrency": 5,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

## Output

```json
{
  "query": {
    "label": "Search submitted",
    "format": "string"
  },
  "found": {
    "label": "Found?",
    "format": "boolean"
  },
  "status": {
    "label": "Status",
    "format": "string"
  },
  "message": {
    "label": "Details",
    "format": "string"
  },
  "searchQuery": {
    "label": "Search",
    "format": "string"
  },
  "listingType": {
    "label": "Listing type searched (active / sold / both)",
    "format": "string"
  },
  "listingCount": {
    "label": "Listings returned",
    "format": "number"
  },
  "totalAvailable": {
    "label": "Total matching on Grailed",
    "format": "number"
  },
  "truncated": {
    "label": "More results were available",
    "format": "boolean"
  },
  "newCount": {
    "label": "New listings this run",
    "format": "number"
  },
  "priceDropCount": {
    "label": "Price drops this run",
    "format": "number"
  },
  "monitorStatus": {
    "label": "Monitoring status (quiet / seeded runs)",
    "format": "string"
  },
  "activeCount": {
    "label": "Active listings fetched this run (sold comps only)",
    "format": "number"
  },
  "soldCount": {
    "label": "Sold comps fetched this run (sold comps only)",
    "format": "number"
  },
  "sellThroughRate": {
    "label": "Sell-through rate: sold / (sold + active) (sold comps only)",
    "format": "number"
  },
  "compsWindowDays": {
    "label": "Span of the fetched sold comps, oldest to newest sale (sold comps only)",
    "format": "number"
  },
  "activeMedianPrice": {
    "label": "Median asking price, USD (sold comps only)",
    "format": "number"
  },
  "soldMedianPrice": {
    "label": "Median sold price, USD (sold comps only)",
    "format": "number"
  },
  "askVsSoldGapPct": {
    "label": "Asking vs. sold median price gap % (sold comps only)",
    "format": "number"
  },
  "medianDaysToSell": {
    "label": "Median days from posted to sold (sold comps only)",
    "format": "number"
  },
  "listings": {
    "label": "All listings found (full list)",
    "format": "array"
  },
  "listingId": {
    "label": "Grailed listing ID",
    "format": "string"
  },
  "title": {
    "label": "Title",
    "format": "string"
  },
  "price": {
    "label": "Price (USD)",
    "format": "number"
  },
  "currency": {
    "label": "Currency",
    "format": "string"
  },
  "designers": {
    "label": "Designer(s)",
    "format": "string"
  },
  "size": {
    "label": "Size",
    "format": "string"
  },
  "category": {
    "label": "Category",
    "format": "string"
  },
  "condition": {
    "label": "Condition",
    "format": "string"
  },
  "color": {
    "label": "Color",
    "format": "string"
  },
  "location": {
    "label": "Seller location",
    "format": "string"
  },
  "postedAt": {
    "label": "Posted",
    "format": "string"
  },
  "bumpedAt": {
    "label": "Last bumped",
    "format": "string"
  },
  "isSold": {
    "label": "Sold",
    "format": "boolean"
  },
  "soldAt": {
    "label": "Sold at (sold listings only)",
    "format": "string"
  },
  "soldPrice": {
    "label": "Sold price (sold listings only)",
    "format": "number"
  },
  "daysToSell": {
    "label": "Days from posted to sold (sold listings only)",
    "format": "number"
  },
  "nativePriceDropCount": {
    "label": "Grailed's own price-drop count for this listing",
    "format": "number"
  },
  "originalPrice": {
    "label": "Original price before Grailed's own price drops",
    "format": "number"
  },
  "popularity": {
    "label": "Popularity score (Grailed's \"heat\")",
    "format": "number"
  },
  "imageUrl": {
    "label": "Image",
    "format": "string"
  },
  "sellerHash": {
    "label": "Anonymous seller hash",
    "format": "string"
  },
  "sellerId": {
    "label": "Seller ID (raw seller info only)",
    "format": "string"
  },
  "sellerName": {
    "label": "Seller username (raw seller info only)",
    "format": "string"
  },
  "sellerProfileUrl": {
    "label": "Seller profile link (raw seller info only)",
    "format": "string"
  },
  "changeType": {
    "label": "new / price-drop / seen",
    "format": "string"
  },
  "isNew": {
    "label": "Is this listing new?",
    "format": "boolean"
  },
  "previousPrice": {
    "label": "Previous price seen by this monitor (USD)",
    "format": "number"
  },
  "priceDropPct": {
    "label": "Price drop % (this monitor)",
    "format": "number"
  },
  "firstSeenAt": {
    "label": "First seen on a run",
    "format": "string"
  },
  "url": {
    "label": "Listing link",
    "format": "string"
  },
  "scrapedAt": {
    "label": "Checked at",
    "format": "string"
  }
}
```

## About this Actor

This example demonstrates how to use [Grailed Scraper: Sold Prices & New Listings](https://apify.com/accountable_eel/grailed-listing-lookup.md) with a specific input configuration. Visit the [Actor detail page](https://apify.com/accountable_eel/grailed-listing-lookup.md) to learn more, explore other use cases, and run it yourself.


## How to integrate an Actor?

This Task's input is already configured above. Use it as-is rather than inventing a new one.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For full API examples (JavaScript, Python, CLI, MCP, OpenAPI), see this Task's Actor page: https://apify.com/accountable_eel/grailed-listing-lookup.md

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).