# Build a structured Etsy listing corpus from search queries

**Use case:** 

Gather public Etsy search results into a clean dataset with listing IDs, canonical URLs, titles, shop metadata, and optional snippets.

## Input

```json
{
  "searchQueries": [
    "personalized gift",
    "custom family name sign"
  ],
  "maxResults": 20,
  "maxPagesPerQuery": 2,
  "responseFormat": "detailed",
  "deduplicateAcrossQueries": true
}
```

## Output

```json
{
  "listingUrl": {
    "label": "Listing URL",
    "format": "string"
  },
  "title": {
    "label": "Listing title",
    "format": "string"
  },
  "shopName": {
    "label": "Indexed shop name",
    "format": "string"
  },
  "rating": {
    "label": "Indexed rating",
    "format": "number"
  },
  "reviewCount": {
    "label": "Indexed review count",
    "format": "integer"
  },
  "sourceQuery": {
    "label": "Source query",
    "format": "string"
  },
  "resultPosition": {
    "label": "Result position",
    "format": "integer"
  },
  "scrapedAt": {
    "label": "Scraped at",
    "format": "string"
  }
}
```

## About this Actor

This example demonstrates how to use [Etsy Listings Scraper - Search Results & URLs](https://apify.com/khadinakbar/etsy-listings-scraper) with a specific input configuration. Visit the [Actor detail page](https://apify.com/khadinakbar/etsy-listings-scraper) to learn more, explore other use cases, and run it yourself.