# Superbid Product Search Scraper (`stealth_mode/superbid-product-search-scraper`) Actor

Scrape product listings from SuperBid.net with comprehensive auction details. Collect 40+ fields including bids, pricing, seller info, and auction status from search results — perfect for market research, price analysis, and competitor monitoring.

- **URL**: https://apify.com/stealth\_mode/superbid-product-search-scraper.md
- **Developed by:** [Stealth mode](https://apify.com/stealth_mode) (community)
- **Categories:** Automation, Developer tools, E-commerce
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## SuperBid Product Search Scraper: Extract Auto & Auction Data Fast

***

### What Is SuperBid?

SuperBid.net is Brazil's largest online auction platform specializing in automobiles, motorcycles, and other products. With thousands of active listings updated daily, SuperBid hosts real-time auction data including bid history, seller information, and pricing trends. Manually collecting this data across multiple search pages is tedious and error-prone — the **SuperBid Product Search Scraper** automates the extraction, delivering structured auction intelligence at scale.

***

### Overview

The **SuperBid Product Search Scraper** extracts product listings from SuperBid search result pages, capturing comprehensive auction details from each item. It's ideal for:

- **Automotive dealers** tracking used car prices and market trends
- **Market researchers** analyzing auction bid patterns and price movements
- **Business intelligence teams** monitoring competitor inventory
- **Price aggregators** building comparative pricing databases
- **Investors** evaluating auction performance metrics

Key features include pagination support, configurable item limits, error tolerance with `ignore_url_failures`, and rich output spanning auction mechanics, pricing, seller data, and bid information.

***

### Input Format

The scraper accepts a JSON configuration object with three main parameters:

```json
{
  "urls": [
    "https://www.superbid.net/categorias/carros-motos?pageNumber=2&pageSize=30&orderBy=score:desc"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 200
}
```

#### Input Parameters Explained

| Parameter | Type | Description |
|---|---|---|
| `urls` | Array | SuperBid search result page URLs. Include full URLs with query parameters (pageNumber, pageSize, orderBy). You can add multiple URLs or use Bulk edit to paste a prepared list. |
| `ignore_url_failures` | Boolean | If `true`, the scraper continues processing remaining URLs even if some fail. Useful for large-scale runs. If `false`, any failure stops the entire job. |
| `max_items_per_url` | Integer | Maximum number of product listings to extract per URL (default: 20, max: 200). Higher values capture more items but increase runtime. |

> **Pro tip:** Use `pageSize=30` and adjust `pageNumber` to systematically scrape multiple result pages. Set `orderBy=score:desc` for relevance-ranked results or `orderBy=price:asc` for price-sorted listings.

***

### Output Format

**Sample output**

```json
{
  "id": 4741600,
  "indexation_date": "2026-06-19 14:30:18",
  "lot_number": 274,
  "quantity_in_lot": 1,
  "quantity_sold": 0,
  "quantity_reserved": 0,
  "total_received_proposals": 0,
  "has_received_proposals": false,
  "visits": 67,
  "total_bidders": 0,
  "total_bids": 0,
  "total_received_bids_or_proposals": 0,
  "has_bids": false,
  "has_received_bids_or_proposals": false,
  "end_date": "2026-06-25 23:21:00",
  "end_date_time": 1782440460000,
  "offer_type_id": 1,
  "create_at": "2026-06-17 20:23:56",
  "update_at": "2026-06-17 21:09:49",
  "published_at": "2026-06-17 21:09:49",
  "status_id": 1,
  "price": 5000,
  "price_formatted": "R$ 5.000,00",
  "offer_status": {
    "status_code": 1,
    "removed": false,
    "stabbed": false,
    "subjudice": false,
    "give_your_bid": true,
    "want_to_know_the_price": false,
    "make_your_proposal": false,
    "closed_to_bids": false,
    "sold": false,
    "reserved": false,
    "available": false,
    "closed": false
  },
  "store": {
    "id": 1161,
    "name": "SOLD",
    "highlight": true,
    "store_visible_on_portal": true,
    "logo_uri": "https://s.superbid.net/image/6a/67/6a670d93-0619-4cf2-9418-777f52aa84f5.png"
  },
  "stores": [
    {
      "id": 1161,
      "name": "SOLD",
      "highlight": true,
      "store_visible_on_portal": true,
      "logo_uri": "https://s.superbid.net/image/6a/67/6a670d93-0619-4cf2-9418-777f52aa84f5.png"
    }
  ],
  "offer_detail": {
    "id": 4741600,
    "initial_bid_value": 5000,
    "initial_bid_value_formatted": "R$ 5.000,00",
    "current_min_bid": 5000,
    "current_min_bid_formatted": "R$ 5.000,00",
    "current_max_bid": 5000,
    "current_max_bid_formatted": "R$ 5.000,00",
    "reserved_price": 999999999999,
    "reserved_price_formatted": "R$ 999.999.999.999,00"
  },
  "manager": {
    "id": 9,
    "name": "Sold Maisativo"
  },
  "current_timestamp": "2026-06-20 00:34:03",
  "auction": {
    "id": 788873,
    "desc": "Heineken",
    "slug_desc": null,
    "locale_id": "pt_BR",
    "currency_iso": "BRL",
    "status_id": 1,
    "permission_type_id": 1,
    "portal_id": 2,
    "modality_id": 1,
    "modality_desc": "Leilão",
    "business_area_id": 1,
    "all_offers_of_this_auction_is_closed": false,
    "begin_date": "2026-06-17 20:06:00",
    "end_date": "2026-06-25 23:00:00",
    "max_enddate_offer": "2026-06-25 23:54:00",
    "sub_marketplaces": [
      {
        "sub_marketplace_id": 1,
        "sub_marketplace_desc": "Corporativo"
      }
    ],
    "judicial_praca": null,
    "judicial_praca_description": "Praça Única",
    "judicial_control_number": null,
    "auctioneer": "Renato Schlobach Moyses",
    "registry": "654",
    "address": {
      "id": 27029,
      "street_type": "Alameda",
      "street": "Alameda Lorena",
      "number": "800",
      "complement": "2º andar",
      "district": "Jardins",
      "city": "São Paulo",
      "state_code": "SP",
      "country_name": "Brasil",
      "region_name": "Sudeste",
      "type": 5
    },
    "crier": false,
    "event_pipeline": null,
    "lot_auction_type_id": 1,
    "is_after_market": null,
    "internal_parameters": {
      "highlight_url_link": null,
      "has_advisor_intermediation": false
    }
  },
  "winner_bid": {},
  "current_bid_increment": {
    "current_bid_increment": 250,
    "current_bid_increment_formatted": "R$ 250,00"
  },
  "offer_description": {
    "offer_description": "HONDA CG 160 CARGO, 2019/2020, Placa FINAL 2 (SP), CH.:  <span><span><br>Marca: HONDA<br>Modelo: CG 160 CARGO<br>Ano Fab/Modelo: 2019/2020<br>Placa FINAL 2 (SP)<br>Cor: BRANCA<br>Combustível: ALCOOL/GASOLINA<br>Chassi: <br><br>Observações:<br><br><p>Cor: BRANCA</p><p>Motor: Sem teste</p><p>Banco: Danificado</p><p><br></p><p>Guidão: Regular</p><p>Painel dos Relógios: Sem teste</p><p>Farol: Sem teste</p><p>Freio Dianteiro: Regular</p><p>Cilindro Susp. Dianteiro: Regular</p><p>Roda Dianteira: Regular</p><p>Tanque Combustível: Sem teste</p><p>Carenagem Bolha: Não Há</p><p>Carenagem Lado Esquerdo: Danificado</p><p>Carenagem Lado Direito: Danificado</p><p>Câmbio: Sem teste</p><p>Módulo de Injeção: Sem teste</p><p>Cilindro Ignição: Sem teste</p><p>Espelho Retrovisor Esquerdo: Danificado</p><p>Espelho Retrovisor Direito: Danificado</p><p>Radiador: Sem teste</p><p>Lanterna Traseira: Sem teste</p><p>Roda Traseira: Regular</p><p>Quadro Susp. Traseira: Regular</p><p>Freio Traseiro: Regular</p><p>Bateria: Sem teste</p><p>Escapamento: Regular</p><p><br></p><p>Observações</p><p><br></p><p>Chave Principal: Não Há</p><br><br><br><br>Será de responsabilidade do comprador o pagamento dos débitos de eventuais multas de trânsito, licenciamento, DPVAT <br> (seguro obrigatório) e IPVA relativos ao(s) veículo(s) vendido(s) ainda que anteriores à data do evento.<br><br>Débitos em aberto:    <b>NADA CONSTASujeito a alterações de acordo com os cadastros dos órgãos públicos até a data da transferência do veículo<br><br>Consultar aba de <b>VALORES A PAGAR</b> para outras despesas a pagar como: estadia, remoção e descaracterização<br> <b><br>Além das comissões, o comprador deverá pagar encargos de administração, conforme estipulado nas Condições de Venda e Pagamento, previamente aceitas para participar do evento<br><br></span></span> 710925 Heineken"
  },
  "group_offer": {
    "accept_proposal": true,
    "commission_percent": 5,
    "id": 351209
  },
  "product": {
    "product_id": 3656667,
    "short_desc": "HONDA CG 160 CARGO, 2019/2020, Placa FINAL 2 (SP),",
    "gallery_json": [
      {
        "original_file_name": "enc_7zxjko0pn-8u9pvpo5xoaq.jpeg",
        "file_name": "3b901ef0-a8d5-468c-9488-d7e6d7eafb90.jpg",
        "link": "https://ms.sbwebservices.net/photos/3b901ef0-a8d5-468c-9488-d7e6d7eafb90.jpg",
        "type": "photo",
        "content_type": "image/jpeg",
        "thumbnail_url": "https://ms.sbwebservices.net/photos/3b901ef0-a8d5-468c-9488-d7e6d7eafb90.jpg"
      },
      {
        "original_file_name": "enc_ag56z5vqqjeglwusk5ubaq.jpeg",
        "file_name": "8d8f7716-1588-4c3c-a45d-f7426289618f.jpg",
        "link": "https://ms.sbwebservices.net/photos/8d8f7716-1588-4c3c-a45d-f7426289618f.jpg",
        "type": "photo",
        "content_type": "image/jpeg",
        "thumbnail_url": "https://ms.sbwebservices.net/photos/8d8f7716-1588-4c3c-a45d-f7426289618f.jpg"
      },
      {
        "original_file_name": "enc_bbu-qht5_hqdh_wrimvfjw.jpeg",
        "file_name": "43cdb333-e2f0-4835-b334-13a36ce9fe3d.jpg",
        "link": "https://ms.sbwebservices.net/photos/43cdb333-e2f0-4835-b334-13a36ce9fe3d.jpg",
        "type": "photo",
        "content_type": "image/jpeg",
        "thumbnail_url": "https://ms.sbwebservices.net/photos/43cdb333-e2f0-4835-b334-13a36ce9fe3d.jpg"
      },
      {
        "original_file_name": "enc_bsc12c8tu1xuyfht34jv8a.jpeg",
        "file_name": "7c1c1a63-d36a-49ab-9567-27c1da849c96.jpg",
        "link": "https://ms.sbwebservices.net/photos/7c1c1a63-d36a-49ab-9567-27c1da849c96.jpg",
        "type": "photo",
        "content_type": "image/jpeg",
        "thumbnail_url": "https://ms.sbwebservices.net/photos/7c1c1a63-d36a-49ab-9567-27c1da849c96.jpg"
      },
      {
        "original_file_name": "enc_cgwdr0a4sc0azg15oteizq.jpeg",
        "file_name": "02b8ef7f-760f-43af-9bfe-8e7fb32f3284.jpg",
        "link": "https://ms.sbwebservices.net/photos/02b8ef7f-760f-43af-9bfe-8e7fb32f3284.jpg",
        "type": "photo",
        "content_type": "image/jpeg",
        "thumbnail_url": "https://ms.sbwebservices.net/photos/02b8ef7f-760f-43af-9bfe-8e7fb32f3284.jpg"
      },
      {
        "original_file_name": "enc_cjbaah40mg7twebaxgaqxg.jpeg",
        "file_name": "0d3002b7-8ec5-478f-a041-42f6c34f37ea.jpg",
        "link": "https://ms.sbwebservices.net/photos/0d3002b7-8ec5-478f-a041-42f6c34f37ea.jpg",
        "type": "photo",
        "content_type": "image/jpeg",
        "thumbnail_url": "https://ms.sbwebservices.net/photos/0d3002b7-8ec5-478f-a041-42f6c34f37ea.jpg"
      },
      {
        "original_file_name": "enc_ibvp3rphrw2euelznn5hyg.jpeg",
        "file_name": "e71187ce-7fe6-4274-b1f6-0edfc32d1f24.jpg",
        "link": "https://ms.sbwebservices.net/photos/e71187ce-7fe6-4274-b1f6-0edfc32d1f24.jpg",
        "type": "photo",
        "content_type": "image/jpeg",
        "thumbnail_url": "https://ms.sbwebservices.net/photos/e71187ce-7fe6-4274-b1f6-0edfc32d1f24.jpg"
      },
      {
        "original_file_name": "enc_j6nmtchrykh1nbrutxjdaw.jpeg",
        "file_name": "3996e28a-9064-4c7f-9697-edbd3b3ac876.jpg",
        "link": "https://ms.sbwebservices.net/photos/3996e28a-9064-4c7f-9697-edbd3b3ac876.jpg",
        "type": "photo",
        "content_type": "image/jpeg",
        "thumbnail_url": "https://ms.sbwebservices.net/photos/3996e28a-9064-4c7f-9697-edbd3b3ac876.jpg"
      },
      {
        "original_file_name": "enc_jn_kkeeote6z6duqqhmiaq.jpeg",
        "file_name": "7d6f0f7d-834e-47dd-b71d-9fae16f389c2.jpg",
        "link": "https://ms.sbwebservices.net/photos/7d6f0f7d-834e-47dd-b71d-9fae16f389c2.jpg",
        "type": "photo",
        "content_type": "image/jpeg",
        "thumbnail_url": "https://ms.sbwebservices.net/photos/7d6f0f7d-834e-47dd-b71d-9fae16f389c2.jpg"
      },
      {
        "original_file_name": "enc_jwq1fhs2kibmyupaor5xcw.jpeg",
        "file_name": "e330ae23-00ed-4a57-bb3a-b1cfad8933c4.jpg",
        "link": "https://ms.sbwebservices.net/photos/e330ae23-00ed-4a57-bb3a-b1cfad8933c4.jpg",
        "type": "photo",
        "content_type": "image/jpeg",
        "thumbnail_url": "https://ms.sbwebservices.net/photos/e330ae23-00ed-4a57-bb3a-b1cfad8933c4.jpg"
      },
      {
        "original_file_name": "enc_kc5ykaa6_ro7pkywq-sslw.jpeg",
        "file_name": "ec1293dc-45c2-4dd9-a35f-a824f1ee8e1b.jpg",
        "link": "https://ms.sbwebservices.net/photos/ec1293dc-45c2-4dd9-a35f-a824f1ee8e1b.jpg",
        "type": "photo",
        "content_type": "image/jpeg",
        "thumbnail_url": "https://ms.sbwebservices.net/photos/ec1293dc-45c2-4dd9-a35f-a824f1ee8e1b.jpg"
      },
      {
        "original_file_name": "enc_koa4fxqqyogzlvlomw37kw.jpeg",
        "file_name": "5878fc96-b316-487f-a1a8-9a8af754ae82.jpg",
        "link": "https://ms.sbwebservices.net/photos/5878fc96-b316-487f-a1a8-9a8af754ae82.jpg",
        "type": "photo",
        "content_type": "image/jpeg",
        "thumbnail_url": "https://ms.sbwebservices.net/photos/5878fc96-b316-487f-a1a8-9a8af754ae82.jpg"
      },
      {
        "original_file_name": "enc_ololylnshidqtm-njvr3cg.jpeg",
        "file_name": "42655497-5b7d-49a1-81f6-1c9eb98560a0.jpg",
        "link": "https://ms.sbwebservices.net/photos/42655497-5b7d-49a1-81f6-1c9eb98560a0.jpg",
        "type": "photo",
        "content_type": "image/jpeg",
        "thumbnail_url": "https://ms.sbwebservices.net/photos/42655497-5b7d-49a1-81f6-1c9eb98560a0.jpg"
      },
      {
        "original_file_name": "enc_r-mkffgfoivnsh5wgme4nq.jpeg",
        "file_name": "491e4b41-1476-4efa-8c54-3f023ecd2e32.jpg",
        "link": "https://ms.sbwebservices.net/photos/491e4b41-1476-4efa-8c54-3f023ecd2e32.jpg",
        "type": "photo",
        "content_type": "image/jpeg",
        "thumbnail_url": "https://ms.sbwebservices.net/photos/491e4b41-1476-4efa-8c54-3f023ecd2e32.jpg"
      },
      {
        "original_file_name": "enc_tiz9_srbzaj4u_00srhvmg.jpeg",
        "file_name": "7ee27155-76a3-4ec6-83f6-681590d4d627.jpg",
        "link": "https://ms.sbwebservices.net/photos/7ee27155-76a3-4ec6-83f6-681590d4d627.jpg",
        "type": "photo",
        "content_type": "image/jpeg",
        "thumbnail_url": "https://ms.sbwebservices.net/photos/7ee27155-76a3-4ec6-83f6-681590d4d627.jpg"
      },
      {
        "original_file_name": "enc_vw_iifpsldi9f9zqyednpa.jpeg",
        "file_name": "d9af85d2-f112-471e-af72-36f68f24bbf7.jpg",
        "link": "https://ms.sbwebservices.net/photos/d9af85d2-f112-471e-af72-36f68f24bbf7.jpg",
        "type": "photo",
        "content_type": "image/jpeg",
        "thumbnail_url": "https://ms.sbwebservices.net/photos/d9af85d2-f112-471e-af72-36f68f24bbf7.jpg"
      },
      {
        "original_file_name": "enc_vzviarwq-tfwgvnycfl8hg.jpeg",
        "file_name": "b34a075d-14a2-479d-ac5e-0046d557a357.jpg",
        "link": "https://ms.sbwebservices.net/photos/b34a075d-14a2-479d-ac5e-0046d557a357.jpg",
        "type": "photo",
        "content_type": "image/jpeg",
        "thumbnail_url": "https://ms.sbwebservices.net/photos/b34a075d-14a2-479d-ac5e-0046d557a357.jpg"
      },
      {
        "original_file_name": "enc_x_scylriay1_mjk1yvo3qa.jpeg",
        "file_name": "4fb58416-3a93-44da-a622-f8ac9dc1e293.jpg",
        "link": "https://ms.sbwebservices.net/photos/4fb58416-3a93-44da-a622-f8ac9dc1e293.jpg",
        "type": "photo",
        "content_type": "image/jpeg",
        "thumbnail_url": "https://ms.sbwebservices.net/photos/4fb58416-3a93-44da-a622-f8ac9dc1e293.jpg"
      },
      {
        "original_file_name": "enc_ynfr__iiacaw0iw0tumtmg.jpeg",
        "file_name": "a3bec001-2d94-4bf1-839d-faa6cd7d0a7a.jpg",
        "link": "https://ms.sbwebservices.net/photos/a3bec001-2d94-4bf1-839d-faa6cd7d0a7a.jpg",
        "type": "photo",
        "content_type": "image/jpeg",
        "thumbnail_url": "https://ms.sbwebservices.net/photos/a3bec001-2d94-4bf1-839d-faa6cd7d0a7a.jpg"
      },
      {
        "original_file_name": "ENC_YQ9xjI_Yg_gCpDs4hawYDg.jpeg",
        "highlight": true,
        "file_name": "b21f35ff-2553-4def-b15f-97d4579b0b6d.jpg",
        "link": "https://ms.sbwebservices.net/photos/b21f35ff-2553-4def-b15f-97d4579b0b6d.jpg",
        "type": "photo",
        "content_type": "image/jpeg",
        "thumbnail_url": "https://ms.sbwebservices.net/photos/b21f35ff-2553-4def-b15f-97d4579b0b6d.jpg"
      }
    ],
    "product_custom_json": "{\"vehicleRestrictions\":null,\"vehicleOwner\":null,\"vehicleSearchSource\":null,\"vehicleSearchType\":null}",
    "photo_count": 20,
    "video_url_count": 0,
    "thumbnail_url": "https://ms.sbwebservices.net/photos/b21f35ff-2553-4def-b15f-97d4579b0b6d.jpg",
    "detailed_description": "<span><span><br>Marca: HONDA<br>Modelo: CG 160 CARGO<br>Ano Fab/Modelo: 2019/2020<br>Placa FINAL 2 (SP)<br>Cor: BRANCA<br>Combustível: ALCOOL/GASOLINA<br>Chassi: <br><br>Observações:<br><br><p>Cor: BRANCA</p><p>Motor: Sem teste</p><p>Banco: Danificado</p><p><br></p><p>Guidão: Regular</p><p>Painel dos Relógios: Sem teste</p><p>Farol: Sem teste</p><p>Freio Dianteiro: Regular</p><p>Cilindro Susp. Dianteiro: Regular</p><p>Roda Dianteira: Regular</p><p>Tanque Combustível: Sem teste</p><p>Carenagem Bolha: Não Há</p><p>Carenagem Lado Esquerdo: Danificado</p><p>Carenagem Lado Direito: Danificado</p><p>Câmbio: Sem teste</p><p>Módulo de Injeção: Sem teste</p><p>Cilindro Ignição: Sem teste</p><p>Espelho Retrovisor Esquerdo: Danificado</p><p>Espelho Retrovisor Direito: Danificado</p><p>Radiador: Sem teste</p><p>Lanterna Traseira: Sem teste</p><p>Roda Traseira: Regular</p><p>Quadro Susp. Traseira: Regular</p><p>Freio Traseiro: Regular</p><p>Bateria: Sem teste</p><p>Escapamento: Regular</p><p><br></p><p>Observações</p><p><br></p><p>Chave Principal: Não Há</p><br><br><br><br>Será de responsabilidade do comprador o pagamento dos débitos de eventuais multas de trânsito, licenciamento, DPVAT <br> (seguro obrigatório) e IPVA relativos ao(s) veículo(s) vendido(s) ainda que anteriores à data do evento.<br><br>Débitos em aberto:    <b>NADA CONSTASujeito a alterações de acordo com os cadastros dos órgãos públicos até a data da transferência do veículo<br><br>Consultar aba de <b>VALORES A PAGAR</b> para outras despesas a pagar como: estadia, remoção e descaracterização<br> <b><br>Além das comissões, o comprador deverá pagar encargos de administração, conforme estipulado nas Condições de Venda e Pagamento, previamente aceitas para participar do evento<br><br></span></span>",
    "template": {
      "groups": [
        {
          "title": "Identificação",
          "properties": [
            {
              "titles_by_locale": null,
              "values_by_locale": null,
              "id": "anofabricacao",
              "title": "Ano Fabricação",
              "type": "integer",
              "value": "2019"
            },
            {
              "titles_by_locale": null,
              "values_by_locale": null,
              "id": "anomodelo",
              "title": "Ano Modelo",
              "type": "integer",
              "value": "2020"
            }
          ],
          "id": "identificacao"
        }
      ]
    },
    "sub_category": {
      "id": 10013,
      "description": "Motocicletas",
      "translation": {
        "map": {
          "es__p_e": "Motocicletas",
          "es__a_r": "Motocicletas",
          "en__u_s": "Motorcycles",
          "es__m_x": "Motocicletas",
          "es__c_o": "Motocicletas",
          "pt__b_r": "Motocicletas",
          "en__u_k": "Motorcycles",
          "es__c_l": "Motocicletas"
        }
      },
      "evidence": "F",
      "sub_grupo": 0,
      "grupo": 0,
      "position": 11,
      "category": {
        "id": 10012,
        "description": "Motos",
        "translation": {
          "map": {
            "es__p_e": "Motos",
            "es__a_r": "Motos",
            "en__u_s": "Motorcycles",
            "es__m_x": "Motos",
            "es__c_o": "Motos",
            "pt__b_r": "Motos",
            "es__c_l": "Motos",
            "en__u_k": "Motorcycles"
          }
        },
        "evidence": "F",
        "sub_grupo": 0,
        "grupo": 0,
        "position": 2
      }
    },
    "model": {},
    "brand": {},
    "product_your_ref": "710925",
    "location": {
      "display_on_map": false,
      "city": "Igarapé - MG",
      "state": "Minas Gerais",
      "country": "Brasil",
      "location_geo": {
        "lat": -20.071368,
        "lon": -44.303171
      }
    },
    "product_type": {
      "id": 10,
      "description": "Carros & Motos",
      "translation": {
        "map": {
          "es__p_e": "Autos y Motos",
          "en__u_s": "Cars & Motorcycles",
          "es__a_r": "Autos y Motos",
          "es__m_x": "Autos y Motos",
          "es__c_o": "Autos y Motos",
          "pt__b_r": "Carros & Motos",
          "es__c_l": "Autos y Motos",
          "en__u_k": "Cars & Motorcycles"
        }
      },
      "show_brand": true,
      "show_model": true
    },
    "judicial": {}
  },
  "seller": {
    "id": 22595,
    "name": "HNK BR INDÚSTRIA DE BEBIDAS LTDA.",
    "city": "Itu",
    "phone": [
      {
        "ddi": "55",
        "ddd": "11",
        "number": "21189549"
      },
      {
        "ddi": "55",
        "ddd": "11",
        "number": "994258805"
      }
    ],
    "company": [
      {
        "fantasy_name": "Heineken"
      }
    ]
  },
  "system_metric": "un",
  "payment_items": [
    {
      "payment_type_id": 1,
      "value": 324,
      "map_description_translator": {
        "es__p_e": "Estadia",
        "es__a_r": "Estadia",
        "es__m_x": "Estadia",
        "es__c_o": "Estadia",
        "es__e_s": "Estadia",
        "pt__b_r": "Estadia",
        "es__c_l": "Estadia"
      }
    },
    {
      "payment_type_id": 2,
      "value": 370.5,
      "map_description_translator": {
        "es__p_e": "Remoção",
        "es__a_r": "Remoção",
        "es__m_x": "Remoção",
        "es__c_o": "Remoção",
        "es__e_s": "Remoção",
        "pt__b_r": "Remoção",
        "es__c_l": "Remoção"
      }
    }
  ],
  "commercial_condition": {
    "auctioneer_commission_percent": null,
    "min_advance_rate": null,
    "max_installments": null,
    "allows_credit_card": true,
    "schedule_type": "AFTER_PAYMENT",
    "allow_credit_card_commission": false,
    "allow_credit_card_total_value": true,
    "transaction_limit": 120000
  },
  "installment_payment_terms": {},
  "is_favorite": false,
  "is_shopping": false,
  "shopping_offer_type": false,
  "from_url": "https://www.superbid.net/categorias/carros-motos?pageNumber=2&pageSize=30&orderBy=score:desc"
}
```

Each scraped product returns 40+ fields capturing auction details, pricing, bidding activity, and seller information:

#### Identification & Timing

| Field | Meaning |
|---|---|
| `ID` | Unique product identifier in SuperBid's system |
| `Indexation Date` | When the product was indexed for search |
| `Create At` | Product creation timestamp |
| `Update At` | Last update timestamp |
| `Published At` | Publication date of the listing |
| `Current Timestamp` | Current server time at scrape moment |

#### Lot & Inventory Management

| Field | Meaning |
|---|---|
| `Lot Number` | Unique lot identifier (used in auctions) |
| `Quantity In Lot` | Total units available in this lot |
| `Quantity Sold` | Number of units already sold |
| `Quantity Reserved` | Number of units reserved by bidders |

#### Bidding & Engagement Metrics

| Field | Meaning |
|---|---|
| `Total Received Proposals` | Total offers/proposals received |
| `Has Received Proposals` | Boolean flag: any proposals received |
| `Total Bidders` | Number of unique users who placed bids |
| `Total Bids` | Total number of individual bids placed |
| `Total Received Bids Or Proposals` | Combined count of all bids and proposals |
| `Has Bids` | Boolean flag: product has received any bids |
| `Has Received Bids Or Proposals` | Boolean flag: product has bids or proposals |
| `Visits` | Number of page views/clicks on the listing |

#### Auction Details

| Field | Meaning |
|---|---|
| `End Date` | Auction end date (formatted) |
| `End Date Time` | Auction end timestamp with time |
| `Winner Bid` | Winning bid amount (if auction ended) |
| `Current Bid Increment` | Minimum increment required for next bid |
| `Auction` | Auction metadata and details |
| `Offer Type ID` | Type of offer (auction, fixed price, etc.) |
| `Offer Status` | Current offer status (active, ended, closed) |

#### Pricing Information

| Field | Meaning |
|---|---|
| `Price` | Current/final price in numeric format |
| `Price Formatted` | Price formatted with currency symbol (e.g., R$ 45.000,00) |
| `Commercial Condition` | Condition details (new, used, refurbished) |
| `Installment Payment Terms` | Payment plan options available |
| `Payment Items` | Accepted payment methods |

#### Product & Seller Information

| Field | Meaning |
|---|---|
| `Product` | Full product object (name, specs, category) |
| `Offer Description` | Detailed product description |
| `Group Offer` | Related products or bundled offers |
| `Seller` | Seller/dealer name and reputation |
| `Manager` | Account manager or representative |
| `Store` | Store name (if multi-store seller) |
| `Stores` | Array of store locations |

#### User & Status Information

| Field | Meaning |
|---|---|
| `Status ID` | Internal status code |
| `Is Favorite` | Boolean: marked as favorite by user |
| `Is Shopping` | Boolean: added to shopping cart |
| `Shopping Offer Type` | Type in shopping context |

#### Metrics & Metadata

| Field | Meaning |
|---|---|
| `System Metric` | Internal performance or ranking metric |
| `Offer Detail` | Extended offer metadata |

***

### How to Use

1. **Gather URLs** — Visit SuperBid.net, navigate to your target category (e.g., *Carros & Motos*), and apply filters (price, location, condition). Copy the full search URL including query parameters.

2. **Build the input** — Paste URLs into the `urls` array. If scraping multiple pages, add each page's URL separately:

```json
   "urls": [
     "https://www.superbid.net/categorias/carros-motos?pageNumber=1&pageSize=30&orderBy=score:desc",
     "https://www.superbid.net/categorias/carros-motos?pageNumber=2&pageSize=30&orderBy=score:desc"
   ]
```

3. **Configure limits** — Set `max_items_per_url` based on your needs (default 20, recommended max 200 for speed).

4. **Handle failures** — Set `ignore_url_failures: true` for large batches to prevent a single failed URL from halting the entire job.

5. **Run & export** — Start the actor and download results as JSON, CSV, or Excel.

**Best practices:**

- Use pagination (`pageNumber`) rather than single large URLs for better reliability.
- Filter results server-side (e.g., by price, location) before scraping to reduce volume.
- Monitor the initial run on 1–2 URLs before scaling to dozens.

***

### Use Cases & Business Value

- **Price intelligence:** Build historical price datasets to identify trends and seasonal patterns in automotive markets.
- **Competitive monitoring:** Track competitor inventory turnover, pricing strategies, and auction success rates.
- **Dealer analytics:** Analyze which product attributes (mileage, condition, seller rating) correlate with faster sales.
- **Investment insights:** Identify undervalued vehicles or market gaps before competitors.
- **Data journalism:** Research and report on secondhand market dynamics across regions.

The SuperBid scraper delivers granular auction mechanics that simple price-scraping tools miss—bid activity, proposal counts, seller reputation, and engagement metrics all in one dataset.

***

### Conclusion

The **SuperBid Product Search Scraper** transforms SuperBid's vast auction catalog into actionable business intelligence. With 40+ fields per product and flexible pagination support, it enables comprehensive market analysis, competitor tracking, and price benchmarking. Start scraping today and unlock insights hidden in Brazil's largest online auction platform.

# Actor input Schema

## `urls` (type: `array`):

Add the URLs of the product search list urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.

## `ignore_url_failures` (type: `boolean`):

If true, the scraper will continue running even if some URLs fail to be scraped.

## `max_items_per_url` (type: `integer`):

The maximum number of items to scrape per URL.

## Actor input object example

```json
{
  "urls": [
    "https://www.superbid.net/categorias/carros-motos?pageNumber=2&pageSize=30&orderBy=score:desc"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 20
}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "urls": [
        "https://www.superbid.net/categorias/carros-motos?pageNumber=2&pageSize=30&orderBy=score:desc"
    ],
    "ignore_url_failures": true,
    "max_items_per_url": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("stealth_mode/superbid-product-search-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "urls": ["https://www.superbid.net/categorias/carros-motos?pageNumber=2&pageSize=30&orderBy=score:desc"],
    "ignore_url_failures": True,
    "max_items_per_url": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("stealth_mode/superbid-product-search-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "urls": [
    "https://www.superbid.net/categorias/carros-motos?pageNumber=2&pageSize=30&orderBy=score:desc"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 20
}' |
apify call stealth_mode/superbid-product-search-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=stealth_mode/superbid-product-search-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/PPXtgYIyIWdnc2kHW/builds/jKOaxUKEogA67XgOP/openapi.json
