logo
languageENdown
menu

Subito Listing Scraper

Turn Subito listing-page URLs into structured records with titles, categories, locations, prices, listing links, and available seller details.

Overview

Subito Listing Scraper turns public Subito listing pages into a structured table for reviewing classified ads at scale. Each result keeps the listing title and detail-page link together with its category, location, displayed price, category-specific characteristics, and any available dealer or public contact details.

The table is useful when manually opening every ad would make it difficult to compare a market consistently. It preserves the labels and values displayed on Subito, giving commerce, research, and operations teams a traceable snapshot that can be sorted, filtered, and compared while retaining the link back to each original listing.

Data notes

Records reflect listings publicly visible from the submitted Subito pages at collection time. The entered page address is retained for provenance, while the listing address identifies the individual ad. Price values keep the text formatting shown on the site; the data does not normalize currencies, convert values, or calculate discounts.

The six attribute columns are category-specific. For a vacation rental they can contain values such as floor area, room counts, or other listing characteristics, but their meaning may differ for vehicles, electronics, services, and other categories. Review them together with “Category” rather than comparing an attribute position across unrelated categories. A blank price, dealer, phone number, keyword, or attribute means that value was not present in the collected public listing. Removed, private, signed-in-only, or otherwise inaccessible content is not covered.

What the results look like

Each record represents one listing found on a submitted Subito page:

Listing titleCategoryLocationListing URLAttribute 1
Salerno - Costiera AmalfitanaCase vacanzaSalerno(SA)https://www.subito.it/case-vacanza/salerno-costiera-amalfitana-salerno-659659223.htm100 mq
Appartamento vicino al mareCase vacanzaSalerno(SA)https://www.subito.it/case-vacanza/appartamento-vicino-al-mare-salerno-000000000.htm75 mq

The output also includes “Entered URL,” “Keyword,” “Price,” “Attribute 2” through “Attribute 6,” “Dealer,” and “Phone number.”

Use cases

  • For regional supply reviews, group records by “Category” and “Location,” then count “Listing URL” values to compare the visible inventory across areas.
  • For pricing research, compare “Price” within the same “Category” and “Location,” and keep “Listing URL” available for checking the source ad behind an outlier.
  • For property-listing comparisons, review “Attribute 1” through “Attribute 6” beside “Listing title” and “Category” to identify ads with relevant category-specific characteristics.
  • For seller coverage analysis, compare “Dealer” and “Phone number” across “Listing URL” records to distinguish ads with publicly displayed contact information from listings where those values are absent.

Scope & Boundaries

Each run accepts 1 to 10,000 Subito URLs and covers listings publicly visible from those pages; individual fields may be blank when a listing does not show them.

  • Good for
  • Use it when you have one or more Subito listing-page URLs and need the visible listings in a structured table.
  • Use it for classified-ad inventory reviews, regional listing comparisons, price research, and seller coverage analysis.
  • Do not use for
  • Do not use it for private, signed-in, or message-only Subito data.
  • Do not use it when every listing must include a price, dealer, or phone number because those values are not shown on every public listing.

Failure Handling

Failure and retry behavior declared by the author. We recommend including it in your system prompt when integrating.

  1. 1If a run stops before completion, retry the same small URL set once; if it stops again, reduce the number of URLs.
  2. 2If no records are returned, confirm that the submitted page is public, still available, and contains listing cards, then retry with that page URL.

Input

Parameters required to call this app, generated from the input.schema in manifest.json.

FieldBusiness nameTypeRequiredDefaultEnum / ConstraintsExampleDescription
subito_urlsSubito listing-page URLsarray<string>Yesup to 10000 items["https://www.subito.it/annunci-campania/affitto-vacanze/case-vacanza/salerno/salerno/"]Public Subito listing or search-page URLs to collect, with one URL per item.

Output

Field structure of a single record, generated from the output.schema in manifest.json.

FieldBusiness nameTypeExampleDescription
entered_urlEntered URLstringhttps://www.subito.it/annunci-campania/affitto-vacanze/case-vacanza/salerno/salerno/?o=1Submitted Subito page URL associated with the record, including a page marker when present.
keywordKeywordstringSearch keyword associated with the source page when one is available.
categoryCategorystringCase vacanzaCategory displayed for the listing.
titleListing titlestringSalerno - Costiera AmalfitanaTitle displayed for the listing.
listing_urlListing URLstringhttps://www.subito.it/case-vacanza/salerno-costiera-amalfitana-salerno-659659223.htmPublic Subito detail-page address for the listing.
locationLocationstringSalerno(SA)Location text displayed for the listing.
pricePricestringPrice text displayed for the listing, preserving its original formatting when available.
attribute_1Attribute 1string100 mqFirst category-specific characteristic displayed for the listing.
attribute_2Attribute 2string5Second category-specific characteristic displayed for the listing.
attribute_3Attribute 3string5Third category-specific characteristic displayed for the listing.
attribute_4Attribute 4string1Fourth category-specific characteristic displayed for the listing.
attribute_5Attribute 5stringFifth category-specific characteristic displayed for the listing.
attribute_6Attribute 6stringSixth category-specific characteristic displayed for the listing.
dealerDealerstringDealer or seller label displayed for the listing when available.
phone_numberPhone numberstringPublic contact number displayed for the listing when available.

Record Schema

Output is returned record by record. detail.output.idFieldHint

output.schema
{
  "type": "object",
  "properties": {
    "entered_url": {
      "type": "string",
      "title": "Entered URL",
      "description": "Submitted Subito page URL associated with the record, including a page marker when present.",
      "prefill": "https://www.subito.it/annunci-campania/affitto-vacanze/case-vacanza/salerno/salerno/?o=1"
    },
    "keyword": {
      "type": "string",
      "title": "Keyword",
      "description": "Search keyword associated with the source page when one is available.",
      "prefill": ""
    },
    "category": {
      "type": "string",
      "title": "Category",
      "description": "Category displayed for the listing.",
      "prefill": "Case vacanza"
    },
    "title": {
      "type": "string",
      "title": "Listing title",
      "description": "Title displayed for the listing.",
      "prefill": "Salerno - Costiera Amalfitana"
    },
    "listing_url": {
      "type": "string",
      "title": "Listing URL",
      "description": "Public Subito detail-page address for the listing.",
      "prefill": "https://www.subito.it/case-vacanza/salerno-costiera-amalfitana-salerno-659659223.htm"
    },
    "location": {
      "type": "string",
      "title": "Location",
      "description": "Location text displayed for the listing.",
      "prefill": "Salerno(SA)"
    },
    "price": {
      "type": "string",
      "title": "Price",
      "description": "Price text displayed for the listing, preserving its original formatting when available.",
      "prefill": ""
    },
    "attribute_1": {
      "type": "string",
      "title": "Attribute 1",
      "description": "First category-specific characteristic displayed for the listing.",
      "prefill": "100 mq"
    },
    "attribute_2": {
      "type": "string",
      "title": "Attribute 2",
      "description": "Second category-specific characteristic displayed for the listing.",
      "prefill": "5"
    },
    "attribute_3": {
      "type": "string",
      "title": "Attribute 3",
      "description": "Third category-specific characteristic displayed for the listing.",
      "prefill": "5"
    },
    "attribute_4": {
      "type": "string",
      "title": "Attribute 4",
      "description": "Fourth category-specific characteristic displayed for the listing.",
      "prefill": "1"
    },
    "attribute_5": {
      "type": "string",
      "title": "Attribute 5",
      "description": "Fifth category-specific characteristic displayed for the listing.",
      "prefill": ""
    },
    "attribute_6": {
      "type": "string",
      "title": "Attribute 6",
      "description": "Sixth category-specific characteristic displayed for the listing.",
      "prefill": ""
    },
    "dealer": {
      "type": "string",
      "title": "Dealer",
      "description": "Dealer or seller label displayed for the listing when available.",
      "prefill": ""
    },
    "phone_number": {
      "type": "string",
      "title": "Phone number",
      "description": "Public contact number displayed for the listing when available.",
      "prefill": ""
    }
  },
  "required": [
    "listing_url"
  ],
  "additionalProperties": false
}

Integration

This app can be integrated via MCP, API, SDK, or file export — all channels share the same capabilities and pricing. Every request authenticates with the Authorization: Bearer header using an API Key (long-lived, created in the Open Platform console); MCP clients can also sign in with OAuth, no key required. More options such as CLI and Skill are on the way.

With the MCP (Model Context Protocol), you can call this app directly from AI clients like Claude and Cursor. Pick your client and auth mode, then copy the config below.

Client config

Replace the value after Bearer with your long-lived API Key. Works in any client, CI, or headless environment.

mcpServers config
{
  "mcpServers": {
    "YiJacobJohnRaku__subito-listing-scraper": {
      "type": "http",
      "url": "https://mcp-v2.octoparse.com?pin=YiJacobJohnRaku/subito-listing-scraper",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}

Let AI set it up for you

Don't want to edit configs by hand? Copy the install prompt and paste it into any AI client — it will complete the setup its own way. (The prompt asks the AI to request your API Key from you, so credentials never end up in chat history or shared configs.)

detail.access.mcp.composeHint

Pricing

returned record

Charged by the number of records successfully returned. Failed tasks are not charged.

$0.014/ record

Multiple billing events accumulate independently — see each item for details. Failed tasks are not charged.

Try It Now

Fill in the parameters and run — results come from a real call.

Example
Parameters are validated against input.schema before submission
Please fill in the required parameters first
$0.014 / record