Contact

If you encounter any issues or need to exchange information, please feel free to contact us through the following link: My profile

CustoJusto.pt Product Search Scraper: Extract Portuguese Classified Listings Data

Introduction

CustoJusto.pt stands as Portugal's premier classified advertisements platform, connecting buyers and sellers across diverse categories including real estate, vehicles, electronics, furniture, and services. With millions of active listings and daily updates, CustoJusto serves as the digital marketplace where Portuguese consumers and businesses conduct transactions, making it an invaluable data source for market research, competitive intelligence, and business development.

For businesses analyzing the Portuguese market, tracking competitor pricing, sourcing inventory, or conducting real estate research, manually collecting data from CustoJusto is impractical. The platform's extensive listings across multiple categories require systematic extraction to gather actionable intelligence efficiently.

The CustoJusto.pt Product Search Scraper automates this data collection process, enabling extraction of detailed listing information including seller details, pricing, location data, and multimedia content. Whether monitoring real estate markets in Lisbon, tracking electronics pricing trends, or analyzing vehicle inventory across Portugal, this scraper delivers structured data at scale.

Scraper Overview

The CustoJusto.pt Product Search Scraper is a specialized data extraction tool designed to systematically collect classified listing information from Portugal's largest marketplace platform. Using advanced web automation techniques, it navigates through search results and category pages to extract comprehensive product and service listings.

Key advantages include configurable retry mechanisms for handling network issues, flexible pagination controls for large datasets, and proxy support for reliable access. The tool is particularly valuable for market researchers analyzing Portuguese consumer markets, real estate professionals tracking property listings, retail businesses monitoring competitor pricing, and procurement specialists sourcing products.

The scraper handles various search parameters including category-specific queries, keyword searches, price sorting options, and pagination controls. It maintains data accuracy while implementing ethical scraping practices, allowing users to focus extraction on specific product categories, price ranges, or geographic regions relevant to their research objectives.

Input and Output Details

Example url 1: https://www.custojusto.pt/beja/imobiliario/q/casa?sp=2

Example url 2: https://www.custojusto.pt/portugal/imobiliario/q/casa

Example url 3: https://www.custojusto.pt/portugal/veiculos/q/suv

Example Screenshot of product information page:

Input Format

The scraper accepts JSON configuration for precise control over data extraction from CustoJusto.pt.

Scrape with URLs:

{
  "proxy": {
    "useApifyProxy": false
  },
  "ignore_url_failures": true,
  "max_retries_per_url": 2,
  "max_items_per_url": 20,
  "urls": [
    "https://www.custojusto.pt/portugal/imobiliario",
    "https://www.custojusto.pt/portugal/veiculos/automoveis",
    "https://www.custojusto.pt/portugal/electronica"
  ]
}

The urls parameter: Add URLs of product search or category pages from CustoJusto.pt. You can paste URLs individually or use bulk edit to add prepared lists. This method is ideal when targeting specific categories or pre-filtered search results.

The ignore_url_failures parameter: When set to true, the scraper continues running even if some URLs fail after maximum retries. This ensures one problematic URL doesn't halt your entire extraction job.

When providing URLs, all "Scrape with search filters" options are disabled. The system collects data only from specified URLs.

Scrape with Search Filters:

{
  "keyword": "apartamento Lisboa",
  "sort_by": "2",
  "page": 1,
  "max_items_per_url": 20,
  "max_retries_per_url": 2,
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "PT"
  }
}

The keyword parameter: Enter search terms to find specific items (e.g., "apartamento Lisboa", "iPhone 14", "Mercedes Benz", "sofá"). Use Portuguese terminology for best results.

The sort_by parameter: Sort listings by:

• "" (empty) - Relevance (default sorting)
• "2" - Price (ascending or descending based on platform logic)

The page parameter: Specify the starting page number for scraping. Useful for resuming interrupted scrapes or targeting specific result ranges.

When using search filters, leave the urls field empty in the "Scrape with URLs" configuration.

General Options:

The max_items_per_url parameter: Limit items per URL or search filter. Default value is 20, balancing batch size with comprehensive data collection.

The max_retries_per_url parameter: Set retry attempts for each URL if scraping encounters bot detection or page load failures. Default is 2, balancing thoroughness with efficiency.

The proxy parameter: Proxy configuration is essential for avoiding detection. For CustoJusto.pt, Portuguese proxies provide optimal access and performance.

Output Format

The scraper returns structured listing data with each field serving specific analytical purposes:

• User ID: Unique identifier for the listing owner. Essential for tracking seller activity, identifying power sellers, and analyzing listing patterns across users.

• List ID: Unique listing identifier within CustoJusto's system. Critical for database management, duplicate detection, and tracking individual listings over time.

• Title: Listing headline or product name. Primary descriptor for understanding product/service offered, used for categorization and keyword analysis.

• Category: Product or service category classification. Enables market segmentation, category-specific analysis, and filtering by business vertical.

• List Time: Timestamp when listing was posted. Crucial for freshness analysis, market velocity tracking, and identifying seasonal patterns.

• Name: Seller name or display name. Identifies listing creator for seller analysis and potential outreach.

• Company Ad: Boolean indicating if listing is from business account. Distinguishes commercial sellers from private individuals, important for B2B vs C2C analysis.

• Image Full URL: Primary listing image URL. Provides visual reference for product condition, quality assessment, and enriched data records.

• Image Count: Total number of images in listing. Indicates listing quality and seller effort, correlates with selling probability.

• Has Video: Boolean showing if listing includes video content. Signals premium listings and seller investment in presentation.

• Has Vtour: Boolean indicating virtual tour availability. Particularly relevant for real estate listings, shows advanced marketing efforts.

• Type: Listing type classification (offer, request, etc.). Differentiates between products for sale, wanted ads, and service offerings.

• Price: Listed price in euros. Fundamental for pricing analysis, competitive intelligence, and market value assessment.

• URL: Direct link to listing page on CustoJusto.pt. Reference for verification, accessing updated information, and direct listing access.

• Partner Banner: Indicator of partner/featured listing status. Identifies premium placements and advertising-supported listings.

• Show LI Banner: Banner display configuration. Technical metadata for listing presentation format.

• Premium Services: Array of premium features applied to listing. Shows investment in listing visibility, indicates serious sellers.

• Location Names: Geographic location data for listing. Essential for location-based analysis, regional market research, and geographic targeting.

• Category Name: Human-readable category name. User-friendly classification for reporting and analysis segmentation.

Example Output:

[
  {
  "user_id": null,
  "list_id": null,
  "title": "Herdade Do Couto, Idanha-A-Nova",
  "category": "1060",
  "list_time": "2026-01-06T20:00:06Z",
  "name": "UNU Fox River - Valença",
  "company_ad": true,
  "image_full_url": null,
  "image_count": 5,
  "has_video": false,
  "has_vtour": false,
  "type": "sell",
  "price": 5500000,
  "url": "/castelo-branco/imobiliario/terrenos-quintas/herdade-do-couto-idanha-a-nov-44018972",
  "partner_banner": "",
  "show_li_banner": true,
  "premium_services": null,
  "location_names": {
    "district": "Castelo Branco",
    "county": "Idanha-a-Nova",
    "parish": "Rosmaninhal"
  },
  "category_name": "Terrenos e Quintas",
  "from_url": "https://www.custojusto.pt/portugal/imobiliario/q/casa?sp=2&o=2"
}
]

Usage Guide

Option 1: Scraping with URLs

To use the scraper with URLs, navigate to CustoJusto.pt and perform searches using the platform's filters for category, location, price range, and other parameters. Copy resulting URLs into the urls array.

Configure your JSON with appropriate retry limits and proxy settings. Set reasonable max_items_per_url values to balance speed with system stability. Enable ignore_url_failures to prevent single URL failures from stopping the entire job.

Best practices:

• Test URLs individually before batch processing
• Monitor for blocked requests and adjust proxy settings
• Keep backup lists as URLs may change structure
• Use category-specific URLs for focused data collection

Troubleshooting:

• Adjust proxy settings if encountering access restrictions
• Reduce retry counts for timeout issues
• Verify URL formats match current CustoJusto structure
• Check that URLs contain valid category or search parameters

Option 2: Scraping with Search Filters

Use search filters to automatically generate searches without manually creating URLs. This method excels for systematic data collection across categories or keywords.

Step 1: Define Search Keyword

Enter Portuguese search terms in the keyword parameter:

• Real estate: "apartamento T2 Lisboa", "moradia Porto", "terreno Algarve"
• Vehicles: "Mercedes Benz", "BMW usado", "scooter 125cc"
• Electronics: "iPhone 14", "MacBook Pro", "PlayStation 5"
• Furniture: "sofá 3 lugares", "mesa jantar", "cama casal"
• Services: "mudanças", "limpezas domésticas", "reparações"

Step 2: Configure Sorting

Set the sort_by parameter:

• Leave empty ("") for relevance-based results (platform default)
• Use "2" for price-based sorting (useful for market pricing analysis)

Step 3: Set Pagination

Configure the page parameter to control starting point:

• Set to 1 for beginning of results
• Use higher values to resume interrupted scrapes
• Plan pagination based on max_items_per_url setting

Best Practices for Filter-Based Scraping

Keyword Strategy:

• Use Portuguese terminology for accurate results
• Include location names in keywords for geographic targeting
• Test keywords on CustoJusto.pt before bulk scraping
• Use specific model names/numbers for precise product matching

Category Coverage:

• Start with broad categories before narrowing to subcategories
• Use consistent keywords across similar searches for comparison
• Track category-specific trends over time
• Consider seasonal variations in listing volume

Price Analysis:

• Use price sorting to identify market ranges
• Extract both low and high price listings for complete picture
• Monitor pricing trends over multiple scraping sessions
• Compare prices across different regions

Data Validation and Quality Control

After extraction, verify:

• Listing data matches search criteria
• Prices are in expected ranges for category
• Location data is properly formatted
• Images and media references are accessible
• No duplicate listings across multiple scrapes
• Company vs private seller classification is accurate

Common Issue Resolution

Empty Results:

• Verify keywords match terms used on CustoJusto.pt
• Try broader search terms if specific queries return nothing
• Check category availability for searched items
• Test search on website directly first

Pagination Issues:

• Track page numbers to avoid gaps in collection
• Adjust max_items_per_url based on total available results
• Handle end-of-results gracefully when pages exceed available data
• Use consistent page increments for systematic coverage

Proxy Configuration:

• Use Portuguese proxies for optimal access
• Enable residential proxies for better detection avoidance
• Rotate proxies if encountering rate limiting
• Monitor proxy performance across scraping sessions

Advanced Techniques

Market Monitoring:

• Schedule regular scrapes to track listing changes
• Monitor new listings by focusing on recent posts
• Track price adjustments for same listings over time
• Identify fast-selling categories by listing turnover

Competitive Intelligence:

• Track competitor listings by seller name or company
• Monitor pricing strategies across similar products
• Analyze premium service usage by competitors
• Compare listing quality (images, videos, descriptions)

Geographic Analysis:

• Run parallel searches for different Portuguese regions
• Compare pricing across Lisbon, Porto, Algarve markets
• Identify regional product availability patterns
• Track urban vs rural listing differences

Category-Specific Research:

• Extract complete category inventories for market sizing
• Analyze subcategory distribution within main categories
• Track seasonal variations in category activity
• Identify emerging product trends within categories

Benefits and Applications

The CustoJusto.pt scraper delivers significant time savings, reducing hours of manual browsing into automated extraction. This efficiency enables focus on analysis rather than data gathering.

Primary Applications:

Real Estate Market Research: Track property listings across Portuguese cities, analyze pricing trends by location and property type, identify investment opportunities, and monitor market inventory levels.

Competitive Pricing Analysis: Monitor competitor product pricing, track market price ranges by category, identify pricing strategies, and adjust own pricing based on market data.

Inventory Sourcing: Identify products for resale or procurement, find specific items across Portugal, track availability of sought-after products, and discover wholesale opportunities.

Market Trend Analysis: Analyze demand patterns across categories, identify seasonal trends, track emerging product categories, and understand consumer preferences through listing data.

Seller Intelligence: Identify active sellers in target categories, analyze professional vs private seller distribution, track seller activity patterns, and discover potential business partners.

The scraper provides advantages through:

• Comprehensive listing data including pricing, location, and seller information
• Category-wide extraction for complete market visibility
• Multimedia content references for enriched data analysis
• Seller classification for B2B vs C2C segmentation
• Scalable extraction supporting both narrow and broad research scopes

Structured output integrates with analytics platforms, pricing tools, and business intelligence systems, enabling immediate use for market analysis, competitive research, and business development across Portuguese markets.

Conclusion

The CustoJusto.pt Product Search Scraper transforms manual marketplace research into efficient automated data collection. By providing structured access to Portugal's largest classified ads platform, it empowers businesses to make data-driven decisions about pricing, inventory, market entry, and competitive positioning.

Whether monitoring real estate markets, tracking product pricing, sourcing inventory, or conducting market research across Portuguese consumer categories, this scraper provides systematic extraction capabilities to accelerate business intelligence gathering.

Ready to streamline your CustoJusto.pt data collection? Start extracting valuable marketplace insights today and transform your Portuguese market research capabilities.

Related Actors

• Custojusto.pt Product Details Scraper: A specialized data extraction solution engineered to harvest comprehensive product information from Custojusto.pt's.

Your feedback

We are always working to improve Actors' performance. So, if you have any technical feedback about Custojusto.pt Product Search Scraper or simply found a bug, please create an issue on the Actor's Issues tab in Apify Console.