Bring a Trailer Scraper

{
  "title": "Bring a Trailer Scraper Input",
  "type": "object",
  "schemaVersion": 1,
  "properties": {
    "productUrls": {
      "title": "Product URLs",
      "type": "array",
      "description": "Add one or more product page URLs to scrape. Example product URLs:\n\n- https://bringatrailer.com/listing/2009-ferrari-430-scuderia-spider-16m-22/\n- https://bringatrailer.com/listing/1988-rolls-royce-corniche-ii-10/\n- https://bringatrailer.com/listing/2006-ford-gt-220/",
      "prefill": [
        "https://bringatrailer.com/listing/2009-ferrari-430-scuderia-spider-16m-22/",
        "https://bringatrailer.com/listing/1988-rolls-royce-corniche-ii-10/",
        "https://bringatrailer.com/listing/2006-ford-gt-220/"
      ],
      "default": [],
      "editor": "stringList"
    },
    "categoryUrls": {
      "title": "List URLs",
      "type": "array",
      "description": "Add one or more List URLs to scrape.\n\nSupported page types with examples:\n\n- Search page: https://bringatrailer.com/search/?s=porsche%20911%20997\n- Category page: https://bringatrailer.com/auctions/\n\nLeave blank if using direct product URLs instead.\n\nThe `scrapeProductDetails` option (labelled Include product details) decides what each List URL produces. When it is enabled, the Actor visits each product page and returns the full detail records; when it is disabled, the Actor returns one list-level record per product card with the fields that are always included.",
      "prefill": [
        "https://bringatrailer.com/auctions/"
      ],
      "default": [],
      "editor": "stringList"
    },
    "maxResultsPerScrape": {
      "title": "Maximum results",
      "type": "integer",
      "description": "Maximum number of product records to save.",
      "default": 20,
      "minimum": 1,
      "maximum": 100000
    },
    "usePagination": {
      "title": "Use pagination",
      "type": "boolean",
      "description": "If this option is enabled and a List URL has more than one page, the Actor continues through the following pages until it reaches the Maximum results limit. If the option is disabled, the Actor only scrapes the first page of each List URL.",
      "prefill": false,
      "default": true
    },
    "scrapeProductDetails": {
      "title": "Include product details",
      "type": "boolean",
      "default": true,
      "description": "If this option is enabled, the Actor visits each product page and adds the full product details to every record. If it is disabled, the Actor returns one list-level result record per product card.\n\nFields that are always included:\n\n- `url`\n- `product_id`\n- `name`\n- `price`\n- `currency`\n- `in_stock`\n- `sku`\n- `main_image`\n- `description`\n- `scraped_at`\n- `auction_end`\n- `year`\n- `country`\n- `country_code`\n- `badges`\n\nFields that are only added when this option is enabled (set to true), and not added when it is disabled:\n\n- `brand`\n- `category`\n- `breadcrumbs`\n- `breadcrumb_urls`\n- `images`\n- `description_html`\n- `features`\n- `attributes`\n- `seller_name`\n- `seller_url`\n- `canonical_url`\n- `bid_count`\n- `chassis`\n- `location`\n- `lot_number`\n- `mileage`\n- `seller_type`"
    }
  }
}

{
  "actorSpecification": 1,
  "fields": {
    "type": "object",
    "additionalProperties": false,
    "properties": {
      "url": {
        "type": [
          "string",
          "null"
        ],
        "format": "uri"
      },
      "product_id": {
        "type": [
          "string",
          "null"
        ],
        "description": "Stable source-side product identifier."
      },
      "name": {
        "type": [
          "string",
          "null"
        ]
      },
      "price": {
        "type": [
          "number",
          "null"
        ]
      },
      "currency": {
        "type": [
          "string",
          "null"
        ],
        "description": "ISO 4217 currency code."
      },
      "in_stock": {
        "type": [
          "boolean",
          "null"
        ]
      },
      "sku": {
        "type": [
          "string",
          "null"
        ]
      },
      "brand": {
        "type": [
          "string",
          "null"
        ]
      },
      "category": {
        "type": [
          "string",
          "null"
        ]
      },
      "breadcrumbs": {
        "type": "array",
        "items": {
          "type": "string"
        }
      },
      "breadcrumb_urls": {
        "type": "array",
        "items": {
          "type": "string",
          "format": "uri"
        }
      },
      "main_image": {
        "type": [
          "string",
          "null"
        ],
        "format": "uri"
      },
      "images": {
        "type": "array",
        "items": {
          "type": "string",
          "format": "uri"
        }
      },
      "description": {
        "type": [
          "string",
          "null"
        ]
      },
      "description_html": {
        "type": [
          "string",
          "null"
        ],
        "description": "Sanitized rich-text product description with structural HTML only."
      },
      "features": {
        "type": "array",
        "items": {
          "type": "string"
        }
      },
      "attributes": {
        "type": "object",
        "description": "Additional source product attributes."
      },
      "seller_name": {
        "type": [
          "string",
          "null"
        ]
      },
      "seller_url": {
        "type": [
          "string",
          "null"
        ],
        "format": "uri"
      },
      "canonical_url": {
        "type": [
          "string",
          "null"
        ],
        "format": "uri"
      },
      "scraped_at": {
        "type": "string",
        "format": "date-time"
      },
      "auction_end": {
        "type": [
          "string",
          "null"
        ],
        "format": "date-time",
        "description": "Scheduled auction end time."
      },
      "bid_count": {
        "type": [
          "integer",
          "null"
        ],
        "description": "Current displayed number of bids."
      },
      "chassis": {
        "type": [
          "string",
          "null"
        ],
        "description": "Displayed chassis or VIN identifier."
      },
      "location": {
        "type": [
          "string",
          "null"
        ],
        "description": "Displayed vehicle location."
      },
      "lot_number": {
        "type": [
          "string",
          "null"
        ],
        "description": "Bring a Trailer lot number."
      },
      "mileage": {
        "type": [
          "string",
          "null"
        ],
        "description": "Displayed mileage or operating-hours label."
      },
      "seller_type": {
        "type": [
          "string",
          "null"
        ],
        "description": "Displayed private-party or dealer classification."
      },
      "year": {
        "type": [
          "integer",
          "null"
        ],
        "description": "Vehicle model year read from the listing title."
      },
      "country": {
        "type": [
          "string",
          "null"
        ],
        "description": "Country displayed on the current-auction card."
      },
      "country_code": {
        "type": [
          "string",
          "null"
        ],
        "description": "Two-letter country code displayed by the current-auction card."
      },
      "badges": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "Visible auction-card badges such as No Reserve, Premium, or Alumni."
      }
    },
    "required": [
      "url",
      "name"
    ]
  },
  "views": {
    "overview": {
      "title": "Overview",
      "transformation": {
        "fields": [
          "main_image",
          "url",
          "product_id",
          "name",
          "price",
          "currency",
          "in_stock",
          "brand",
          "seller_name",
          "scraped_at"
        ]
      },
      "display": {
        "component": "table",
        "properties": {
          "main_image": {
            "label": "Image",
            "format": "image"
          },
          "url": {
            "label": "Product URL",
            "format": "link"
          },
          "product_id": {
            "label": "Product ID",
            "format": "text"
          },
          "name": {
            "label": "Product name",
            "format": "text"
          },
          "price": {
            "label": "Current price",
            "format": "number"
          },
          "currency": {
            "label": "Currency",
            "format": "text"
          },
          "in_stock": {
            "label": "In stock",
            "format": "boolean"
          },
          "brand": {
            "label": "Brand",
            "format": "text"
          },
          "seller_name": {
            "label": "Seller",
            "format": "text"
          },
          "scraped_at": {
            "label": "Scraped at",
            "format": "datetime"
          }
        }
      }
    },
    "allFields": {
      "title": "All fields",
      "description": "Every stored field.",
      "transformation": {
        "fields": [
          "url",
          "product_id",
          "name",
          "price",
          "currency",
          "in_stock",
          "sku",
          "brand",
          "category",
          "breadcrumbs",
          "breadcrumb_urls",
          "main_image",
          "images",
          "description",
          "description_html",
          "features",
          "attributes",
          "seller_name",
          "seller_url",
          "canonical_url",
          "scraped_at",
          "auction_end",
          "bid_count",
          "chassis",
          "location",
          "lot_number",
          "mileage",
          "seller_type",
          "year",
          "country",
          "country_code",
          "badges"
        ]
      },
      "display": {
        "component": "table"
      }
    }
  }
}