Subito Scraper API

Extract structured product data from public Subito pages as JSON. Send a product URL and receive the fields exposed by the target page.

Get your API key Read the documentation1,000 free credits per month, no card required.

Decide before you build

Endpoint: POST /scrape/retail
Scrapers: Subito product pages
Cost: from 1 credit / call
Free plan: 1,000 credits / month
Call pattern: sync, POST
On failure: credits refunded
Response format: JSON
Concurrency: by plan tier

E-commerce & Retail requests are synchronous. Cost depends on the options selected for the request.

Try the Subito scraper on your own targetRun a request against a public product page and inspect the JSON before you integrate.

Open the live test

What you get back

product data

Subito data in JSON

Retrieve the product information exposed by the public Subito page.

Title, description and product images
Price, currency and stock when available
Brand, identifiers and product variations
Categories and seller information

Request options

Control how the page is collected

Use rendering or proxy options only when the target requires them.

JavaScript rendering with useChrome
Premium proxy and country targeting
Public URL input; no account login required
Structured JSON in the same response

Call the Subito scraper

Send a public product URL to the E-commerce & Retail endpoint. The API returns the result in the same response.

Step 1Submit the Subito product URL and only the options required by the target.

bash

# POST - scrape a public product page
curl -X POST "https://api.scraping-bot.io/scrape/retail" \
  -u "yourUsername:yourApiKey" \
  -H "Content-Type: application/json" \
  -d '{
  "url": "https://example.com/product/123",
  "options": {
    "useChrome": false,
    "premiumProxy": false
  }
}'

Code example

Authenticate with your ScrapingBot username and API key, then read the returned JSON.

const auth = "Basic " + Buffer.from("yourUsername:yourApiKey").toString("base64");

const response = await fetch("https://api.scraping-bot.io/scrape/retail", {
  method: "POST",
  headers: { "Content-Type": "application/json", Authorization: auth },
  body: JSON.stringify({ url: "https://example.com/product/123", options: { useChrome: false, premiumProxy: false } }),
});

const result = await response.json();

Run this call in two minutesCreate an account, copy your API key, then use the example above.

Get your API key

Request parameters

Parameter	Type	Default	Description
`url`	string	—	Full public page URL, including https://.
`options.useChrome`	boolean	false	Render JavaScript when the target page requires a browser.
`options.premiumProxy`	boolean	false	Use a premium proxy for targets that require it.
`options.proxyCountry`	string	—	Country targeting with a premium proxy.

Response example

Example returned by the legacy Subito scraper documentation.

json

{
  "data": {
      "title": "Ferrari 208 turbo intercooler GTS - soli 5.300km",
      "description": "FERRARI 208 TURBO
Soli 5.300km
Eseguito tagliando completo con sostituzione cinghie
Vettura come nuova
PUNTA-TACCO SRL
Società che unisce passione e professionalità di due realtà esistenti sul territorio di Maranello da oltre 60 anni.
Nata per da un servizio a 360 gradi a tutti i clienti. 
Da noi puoi trovare consulenti esperti per la valutazione delle vetture, pratiche di finanziamento o leasing, pacchetti assicurativi; servizio di carrozzeria, meccanica e pulizia; per i più appassionati organizziamo eventi dedicati al interno dei nostri locali.
N.B. L'inserimento degli accessori viene effettuato in modo totalmente elettronico, per tanto ci scusiamo di eventuali errori pubblicati. Anche le caratteristiche alcune volte non vengono inserite complete. Non ci assumiamo la responsabilità di eventuali errori di pubblicazione, e vi invitiamo a contattarci sulle vettura di vostro interessa per avere maggiori informazioni.
",
      "image": "https://images.sbito.it/api/v1/sbt-ads-images-pro/images/22/22ac53f9-06e9-4e29-af10-81ff26501d96?rule=fullscreen-1x-auto",
      "price": 100000,
      "shippingFees": null,
      "currency": "EUR",
      "isInStock": true,
      "EAN13": null,
      "ASIN": null,
      "ISBN": null,
      "color": null,
      "brand": "FERRARI",
      "category": {
          "name": "Maranello",
          "url": "https://www.subito.it/annunci-emilia-romagna/vendita/auto/modena/maranello/"
      },
      "categories": [
          {
              "name": "Subito.it",
              "url": "https://www.subito.it/"
          },
          {
              "name": "Auto",
              "url": "https://www.subito.it/annunci-italia/vendita/auto/"
          },
          {
              "name": "Emilia-Romagna",
              "url": "https://www.subito.it/annunci-emilia-romagna/vendita/auto/"
          },
          {
              "name": "Modena (Prov)",
              "url": "https://www.subito.it/annunci-emilia-romagna/vendita/auto/modena/"
          },
          {
              "name": "Maranello",
              "url": "https://www.subito.it/annunci-emilia-romagna/vendita/auto/modena/maranello/"
          }
      ],
      "siteURL": "https://www.subito.it/auto/ferrari-208-turbo-intercooler-gts-soli-5-300km-modena-537808664.htm",
      "siteHtml": null,
      "productHasVariations": null,
      "statusCode": 200,
      "isFinished": null,
      "isDead": null,
      "htmlLength": 197425,
      "captchaFound": false,
      "isHtmlPage": true,
      "host": "www.subito.it",
      "images": [
          "https://images.sbito.it/api/v1/sbt-ads-images-pro/images/22/22ac53f9-06e9-4e29-af10-81ff26501d96?rule=fullscreen-1x-auto",
          "https://images.sbito.it/api/v1/sbt-ads-images-pro/images/98/986a0dd1-3cdf-45f5-b9ea-96549785a7ae?rule=fullscreen-1x-auto",
          "https://images.sbito.it/api/v1/sbt-ads-images-pro/images/59/5932db11-5739-4d1e-a2cd-a53c3c75ff55?rule=fullscreen-1x-auto",
          "https://images.sbito.it/api/v1/sbt-ads-images-pro/images/e3/e3bd6e0b-655a-48a7-8d33-ce0ad7270956?rule=fullscreen-1x-auto",
          "https://images.sbito.it/api/v1/sbt-ads-images-pro/images/58/5854267e-34d3-4930-ba21-3971e3a4e138?rule=fullscreen-1x-auto",
          "https://images.sbito.it/api/v1/sbt-ads-images-pro/images/be/be9adca3-8017-42ef-986a-5a97739d5fba?rule=fullscreen-1x-auto",
          "https://images.sbito.it/api/v1/sbt-ads-images-pro/images/c4/c4d8c966-128e-49d9-8dd1-bfcce366c4c0?rule=fullscreen-1x-auto",
          "https://images.sbito.it/api/v1/sbt-ads-images-pro/images/73/730e34ae-8bf2-4bd5-809b-20e24f1af6f2?rule=fullscreen-1x-auto",
          "https://images.sbito.it/api/v1/sbt-ads-images-pro/images/19/196db425-d004-4de3-8bd4-11a901e61168?rule=fullscreen-1x-auto",
          "https://images.sbito.it/api/v1/sbt-ads-images-pro/images/01/013d40f1-0c92-4d66-bb70-56991a75fb85?rule=fullscreen-1x-auto",
          "https://images.sbito.it/api/v1/sbt-ads-images-pro/images/07/072e9b4b-bfd0-4b0f-ae94-4b9ffdd3460b?rule=fullscreen-1x-auto",
          "https://images.sbito.it/api/v1/sbt-ads-images-pro/images/6c/6c086d87-e4fa-4f6f-92f3-80f11895821c?rule=fullscreen-1x-auto",
          "https://images.sbito.it/api/v1/sbt-ads-images-pro/images/f5/f55c6ff2-b559-4b3e-bdfb-d16a8d32a352?rule=fullscreen-1x-auto",
          "https://images.sbito.it/api/v1/sbt-ads-images-pro/images/e6/e60b9d0d-2777-406b-a898-cfab840f7996?rule=fullscreen-1x-auto",
          "https://images.sbito.it/api/v1/sbt-ads-images-pro/images/d0/d0c57b10-1684-43b3-b3ae-915ab313beae?rule=fullscreen-1x-auto",
          "https://images.sbito.it/api/v1/sbt-ads-images-pro/images/11/11cd35b0-5720-4664-8c65-85c749f1c0a5?rule=fullscreen-1x-auto",
          "https://images.sbito.it/api/v1/sbt-ads-images-pro/images/39/398fc0df-b39a-4026-b413-d06a963d3f80?rule=fullscreen-1x-auto",
          "https://images.sbito.it/api/v1/sbt-ads-images-pro/images/15/1579ceab-3da3-4443-bad3-5895a55b512d?rule=fullscreen-1x-auto",
          "https://images.sbito.it/api/v1/sbt-ads-images-pro/images/c5/c5bafb5d-14d9-406b-aad0-b52e6b62ca35?rule=fullscreen-1x-auto",
          "https://images.sbito.it/api/v1/sbt-ads-images-pro/images/04/04dfcb4d-e495-48c2-b641-ae1a03a0239c?rule=fullscreen-1x-auto",
          "https://images.sbito.it/api/v1/sbt-ads-images-pro/images/9d/9d6417fe-7ddd-45d7-a1aa-687da518f022?rule=fullscreen-1x-auto",
          "https://images.sbito.it/api/v1/sbt-ads-images-pro/images/9a/9adca488-f211-414e-8392-e7840e6b8af3?rule=fullscreen-1x-auto",
          "https://images.sbito.it/api/v1/sbt-ads-images-pro/images/be/be26d0ef-3011-450a-b87e-1550cd36467a?rule=fullscreen-1x-auto",
          "https://images.sbito.it/api/v1/sbt-ads-images-pro/images/d9/d909a832-92a8-49c3-94a4-74ad219237ab?rule=fullscreen-1x-auto",
          "https://images.sbito.it/api/v1/sbt-ads-images-pro/images/ed/ed371057-e22f-4066-b16f-d72342f43fc5?rule=fullscreen-1x-auto",
          "https://images.sbito.it/api/v1/sbt-ads-images-pro/images/f3/f37e59d7-6df1-4491-9274-ef42b82cc639?rule=fullscreen-1x-auto",
          "https://images.sbito.it/api/v1/sbt-ads-images-pro/images/7f/7fe147f2-3f76-48e8-8a01-afc89a9089ec?rule=fullscreen-1x-auto",
          "https://images.sbito.it/api/v1/sbt-ads-images-pro/images/cc/cc5f8522-070d-44f9-b79f-a006e8e3770a?rule=fullscreen-1x-auto",
          "https://images.sbito.it/api/v1/sbt-ads-images-pro/images/fc/fc708fa1-2c89-4204-bdee-09cc34789690?rule=fullscreen-1x-auto",
          "https://images.sbito.it/api/v1/sbt-ads-images-pro/images/94/94adec34-6c87-49fd-b9c3-86d8984a2aad?rule=fullscreen-1x-auto"
      ],
      "phoneNumber": null,
      "advertiserName": null,
      "originalPrice": null
  }
}

Credits, failures and limits

Case	Credits	Notes
Standard request	from 1 credit / call	Current plans start at this rate.
JavaScript rendering	Additional credits	Enable only when the target requires it.
Premium proxy	Additional credits	Use for targets that require a premium proxy.
Unsuccessful request	Not deducted	Only successful requests count towards the monthly limit.

E-commerce & Retail API or Raw HTML scraper?

	E-commerce & Retail API	Raw HTML scraper
Endpoint	/scrape/retail	/scrape/raw-html
Returns	Structured product JSON	Rendered page HTML
Flow	One synchronous request	One synchronous request
Starting cost	from 1 credit / call	from 1 credit / call
Use it when	You need parsed product fields	You need your own extraction logic

Questions about the Subito API

Does the Subito scraper access private data?: No. This guide covers public product pages and does not require signing in to a Subito account.
Are all fields always available?: No. Returned data depends on what the public Subito page exposes and what the extractor supports.
Can I collect multiple pages at once?: Each request takes one public URL. Submit one request per page you need to collect.
When should I use a premium proxy?: Use it only when a target requires it or when you need country targeting for a public page.

Source: ScrapingBot API documentation.

Other e-commerce & retail scrapers

PrestaShop Scraper API Cdiscount Scraper API Amazon Scraper API Adidas Scraper API Nike Scraper API Instant Gaming Scraper API

Browse the E-commerce & Retail category for the complete list of guides, or visit the ScrapingBot blog for implementation guides.

4.9

★★★★★

133 Google reviews

Trusted by developers using E-commerce & Retail data.
Customer reviews apply to ScrapingBot's service overall, not specifically to this scraper.

Start scraping Subito today

1,000 free credits every month. No card required, cancel anytime.

Get your API key Talk to us