Subito.it API

Search Italy's major classifieds site and pull ads, prices, photos and shop details as JSON.

The API.SH Subito.it API turns public Subito.it pages into structured JSON. Search ads across Italy by keyword with category, region, province, town, ad type, price range, seller type, shipping and sort. Each result has price, condition, features, photos, location and posting and expiry dates. Fetch one ad for the full description, the seller's feedback score and reply time and, for business sellers, the shop with its website, opening hours and phone. Private sellers' names and contact details are never returned.

Get a free API key Try it in the playground

2 endpoints
from $1 / 1,000 calls
1,000 free credits / month
failed calls free

Search Subito.it ads

GET https://api.api.sh/subito/v1/search

{ "success": true }

1 credit · $1 per 1,000 calls

What you can build with the Subito.it API

Used-goods price research

Search an item across Italian regions with price filters to see the going rate for phones, bikes, furniture or tools on Subito.it.

/search

New ad alerts

Poll a saved search sorted by date, or ask the listing route for the latest matching ad, and send new Subito.it listings to Telegram, Slack or email.

/search /listing

Dealer and shop lead lists

Filter for business sellers and pull each shop's name, website, opening hours, phone and categories to build B2B lead lists.

/search /listing

Regional market analysis

Compare supply and asking prices by region, province and town for a category such as cars or real estate.

/search

Resale and arbitrage tools

Watch for underpriced ads with shipping, then read the full ad and the seller's feedback score before you act.

/search /listing

Subito.it data you get

Field names from real responses. Numbers come parsed, URLs absolute, dates in ISO 8601.

Subito.it API endpoints and prices

Every Subito.it endpoint costs 1 credit per call: credits are $1 per 1,000 on a monthly plan, $2 pay-as-you-go. Pricing

Search and discovery1

Search Subito.it ads

/subito/v1/search

$1 · $2 PAYG

1 credit

Products, listings and places1

Subito.it ad details

/subito/v1/listing

$1 · $2 PAYG

1 credit

Call the Subito.it API

Search Subito.it ads: GET https://api.api.sh/subito/v1/search

curl "https://api.api.sh/subito/v1/search?q=iphone" \
  -H "x-api-key: $APISH_KEY"

import os, requests

res = requests.get(
    "https://api.api.sh/subito/v1/search",
    params={"q": "iphone"},
    headers={"x-api-key": os.environ["APISH_KEY"]},
    timeout=120,
)
res.raise_for_status()
data = res.json()

const url = new URL("https://api.api.sh/subito/v1/search");
url.searchParams.set("q", "iphone");

const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json();

# Google Sheets (API.SH add-on)
=APISH("/subito/v1/search", "q", "iphone")

# Zapier, Make, n8n (verified node): pick the API.SH app,
# choose "Subito.it" and "Search Subito.it ads".

# AI agents (Claude, ChatGPT, Cursor): add the
# API.SH MCP server https://api.sh/mcp

Create a free accountConfirm your email and get 1,000 free credits every month. No card needed.
Create an API keyOne key works for all 482 platforms.
Send the requestJSON back in one call. Add output=csv or output=ndjson for files.

Why API.SH for Subito.it data

Public data only: no Subito.it login, cookies or account needed
One key and one response shape for Subito.it and 481 other platforms
Built and maintained by API.SH, not third-party publishers
Pay per call; errors on our side cost nothing
Live status for every endpoint

API.SH vs the official Subito.it API

Subito.it does not offer an open public API for reading ads; its integrations, such as shipping partners, serve sellers. API.SH reads public Subito.it ads and returns them as JSON with no developer account.

Instead of a home-made Telegram bot that breaks when the site changes, or separate Apify actors for cars, homes and shops, API.SH gives one key, one JSON shape and a fixed price per call.

Subito.it API questions

What Subito.it data can I get?+

Ad search with category, location, price, seller type and shipping filters (/subito/v1/search) and one full ad with description, features, photos, seller feedback and the business shop (/subito/v1/listing).

How much does the Subito.it API cost?+

Every Subito.it endpoint costs 1 credit per call. On a monthly plan 1,000 credits cost $1 (Starter is $50/month for 50,000 credits). Pay-as-you-go is $2 per 1,000 credits, with top-ups from $15 that never expire.

Is there a free trial?+

Yes. Every account gets 1,000 free credits every month. That is 1,000 calls to /subito/v1/listing at 1 credit each.

Is there an official Subito.it API?+

Not an open one. Subito.it has no public developer API for reading ads. API.SH covers that gap with public ad data as JSON.

Do I need a Subito.it account or login?+

No. API.SH reads public Subito.it pages only. No endpoint uses a login, cookies or anyone's account.

Can I get notified about new Subito.it ads?+

Yes. Call /subito/v1/listing with latest=1 and your search parameters to get the newest matching ad, or poll /subito/v1/search sorted by date, and compare ids against the last run.

Does it return seller phone numbers?+

Only for business sellers, where the shop's phone and website are public. Private sellers' names, phone numbers and email addresses are never returned and are masked in ad text.

How do I get started?+

1. Sign up at api.sh. 2. Copy your API key. 3. Call /subito/v1/search with q=iphone and a region, then pass an ad url to /subito/v1/listing. Request examples and every parameter are in the docs at https://api.sh/docs. You can also use the JS or Python SDK, Google Sheets, Zapier, Make, n8n or the MCP server at https://api.sh/mcp.