TruckPaper.com Scraper: Extract Commercial Truck Listings at Scale

---

What Is TruckPaper.com?

TruckPaper.com is one of North America's largest online marketplaces for buying and selling commercial trucks, trailers, and heavy equipment. It aggregates thousands of listings from dealers and private sellers across the US and beyond. Manually tracking inventory, pricing trends, or competitor stock is impractical at scale — the TruckPaper.com Cars Search Scraper automates that process, delivering clean, structured data from search result pages.

---

Overview

The TruckPaper Search Scraper collects listing cards directly from TruckPaper.com search result pages, transforming paginated results into machine-readable records with 60+ fields per listing.

Ideal for:

• Fleet buyers monitoring available inventory by category and region
• Dealers benchmarking competitor pricing and stock levels
• Market analysts tracking commercial vehicle supply and pricing trends
• Aggregator platforms syndicating truck listings across multiple channels

---

Input Format

{
  "urls": [
    "https://www.truckpaper.com/listings/search?Category=16013&page=2"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 50
}

Field	Type	Description
urls	array	One or more TruckPaper.com search result page URLs. Supports bulk entry. Example: filter by category, keyword, or location using the site's search filters, then paste the resulting URL.
ignore_url_failures	boolean	If true, the scraper continues running when a URL fails instead of stopping the entire run. Recommended for bulk jobs. Default: true.
max_items_per_url	integer	Maximum number of listings to collect per URL. Useful for limiting run size or sampling. Default: 20.

Tip: Build targeted URLs using TruckPaper's filter UI (category, year, condition, state) before pasting into the scraper. To paginate, increment the page= parameter across multiple URLs.

---

Output Format

Sample output

{
  "criteo_price": "17500",
  "is_premium_listing": false,
  "is_featured_listing": true,
  "is_dismantled": false,
  "is_for_rent_only": false,
  "buy_now_new_tab": true,
  "buy_now_url": null,
  "buy_now_button_text": "Buy Now",
  "custom_email_seller_text_for_rental": "",
  "custom_email_seller_text_for_retail": "",
  "use_featured_listing_border": false,
  "has_variants": false,
  "id": 254211317,
  "listing_type": "for sale",
  "listing_types": [
    "ForSale",
    "Auction"
  ],
  "alt_category_id": 211,
  "category_id": 16013,
  "base_category_id": 27,
  "legacy_base_category_id": 27,
  "retail_contact_crmid": null,
  "category_name": "Day Cab Trucks",
  "display_category_name": "Day Cab Trucks",
  "manufacturer_name": "FREIGHTLINER",
  "year": "2020",
  "model": "CASCADIA 126",
  "listing_title": "2020 FREIGHTLINER CASCADIA 126",
  "price_label": "Price",
  "retail_price": "USD $20,500",
  "serial_number": "3AKJHLDV9LSLH3845",
  "dealer": "Equipment Pro",
  "account_crmid": null,
  "dealer_crmid": null,
  "settings_crmid": null,
  "dealer_group_id": null,
  "dealer_contact": "Maria Bertram",
  "web_site": "https://www.equipmentproauctions.com",
  "premium_hosted_site": "https://www.equipmentproauctions.com",
  "price": 20500.0,
  "retail_phone_number_international_format": "+18326982881",
  "retail_phone_number": "(832) 698-2881",
  "retail_phone_number_unformatted": "+18326982881",
  "is_retail_phone_number_text_enabled": false,
  "whatsapp_unformatted_phone_number": null,
  "dealer_location": "Tomball, Texas 77377",
  "description": "2020 FREIGHTLINER CASCADIA 126 DAY CAB TRUCK TRACTOR\r\nDD13, 12.8 LITER 450 HP DIESEL ENGINE, DD12-1650-OHI HD 12 SPEED WITH OVERDRIVE. SEE SERVICE LOGS FOR ECM REPORTS. Fairing removal is available for an additional fee. If not arranged prior to pickup, the fairing must be removed after the equipment leaves the seller’s premises. **Load Out Mon - Friday 8:00-4:30**Call for appointment**Scroll down to view additional photos*",
  "condition": "Used",
  "specs": [
    {
      "key": "Mileage",
      "value": "627,920 mi"
    },
    {
      "key": "Engine Manufacturer",
      "value": "DETROIT"
    },
    {
      "key": "Horsepower",
      "value": "505 HP"
    },
    {
      "key": "Transmission",
      "value": "Automated"
    },
    {
      "key": "Transmission Manufacturer",
      "value": "DETROIT"
    },
    {
      "key": "Transmission Type",
      "value": "Detroit DT12"
    },
    {
      "key": "Number of Speeds",
      "value": "12 Spd"
    },
    {
      "key": "Suspension",
      "value": "AirLiner"
    }
  ],
  "detail_url": "/listing/for-sale/254211317/2020-freightliner-cascadia-126-day-cab-trucks",
  "employee_listing_view_model": {
    "sort_values": [],
    "company_specs": [],
    "contact_specs": [],
    "machine_specs": [],
    "wholesale_specs": [],
    "auction_specs": [],
    "searching_specs": [],
    "hash_value": "7d7416682a8df38062c14f773199984ee4ee3e8fe8c29977b2297b7c3218554f"
  },
  "is_free_shipping": false,
  "formatted_updated_on_time": "Wednesday, May 13, 2026 08:29 AM",
  "phone_click_to_track_url": null,
  "elastic_score": 4.0,
  "currency_code": "USD",
  "msrp_save_amount": null,
  "msrp_save_percentage": null,
  "listing_location": {
    "formatted_location": "Phoenix, Arizona 85043",
    "display_text": "Truck Location:",
    "google_maps_url": "https://www.google.com/maps/search/?api=1&hl=en&query=Phoenix+Arizona+85043",
    "show_street_address": false,
    "full_address": "",
    "city": "Phoenix",
    "state": "Arizona",
    "country": "USA",
    "postal_code": "85043",
    "latitude": -112.196998,
    "longitude": -112.196998,
    "location_i_d": 350017092932,
    "short_location": "Phoenix, Arizona"
  },
  "listing_image_model": {
    "display_image_media_id": 11008784559,
    "header_text": "Featured Listing",
    "image_url": [
      "https://media.sandhills.com/img.axd?id=11008784559&wid=4326209787&rwl=False&p=&ext=&w=350&h=220&t=&lp=&c=True&wt=False&sz=Max&rt=0&checksum=sWML399QmdUET2nOqLI%2fQb3MoAejY2wKZMB4rExUIwU%3d",
      "https://media.sandhills.com/img.axd?id=11008784560&wid=4326209787&rwl=False&p=&ext=&w=350&h=220&t=&lp=&c=True&wt=False&sz=Max&rt=0&checksum=sWML399QmdWo6Kbxze5uMw%2f1J8xoMFaQ%2bIwK1TaiDYI%3d",
      "https://media.sandhills.com/img.axd?id=11008784562&wid=4326209787&rwl=False&p=&ext=&w=350&h=220&t=&lp=&c=True&wt=False&sz=Max&rt=0&checksum=sWML399QmdWifwnQzfeNqoKHaqKzxkSUexmm9%2bcN79M%3d",
      "https://media.sandhills.com/img.axd?id=11008784563&wid=4326209787&rwl=False&p=&ext=&w=350&h=220&t=&lp=&c=True&wt=False&sz=Max&rt=0&checksum=sWML399QmdVrDADhUnbvwKwEqpaPo2r1Fp0FnlqMT1A%3d",
      "https://media.sandhills.com/img.axd?id=11008784564&wid=4326209787&rwl=False&p=&ext=&w=350&h=220&t=&lp=&c=True&wt=False&sz=Max&rt=0&checksum=sWML399QmdWTtVCSXmafIX36yEtxZCpJaQ1WEFDZCNI%3d",
      "https://media.sandhills.com/img.axd?id=11008784565&wid=4326209787&rwl=False&p=&ext=&w=350&h=220&t=&lp=&c=True&wt=False&sz=Max&rt=0&checksum=sWML399QmdWyoSH136NiKO8xCK6g3ywUdTUw7PFY6%2bE%3d"
    ],
    "alt_text": "2020 FREIGHTLINER CASCADIA 126 Used Day Cab Trucks for sale",
    "show_blur": true,
    "no_image": false,
    "image_count": 14,
    "image360_count": 0,
    "video_count": 1,
    "listing_types": [
      "ForSale",
      "Auction"
    ]
  },
  "top_output_specs_count": 2,
  "is_pre_trade": false,
  "is_private_party": false,
  "is_pre_at_result": null,
  "owner_crmid": null,
  "external_id": null
}

Each listing returns a structured record with the following fields:

Listing Identity & Flags

Field	Meaning
ID	Unique internal TruckPaper listing identifier
External ID	ID from the dealer's external system, if provided
Listing Title	Full display title of the listing
Listing Type	Primary type classification (e.g., retail, rental)
Listing Types	Array of all applicable type tags
Is Premium Listing	Whether the listing has paid premium placement
Is Featured Listing	Whether the listing is featured in results
Use Featured Listing Border	Visual featured badge flag
Is Dismantled	Whether the vehicle is listed for parts only
Is For Rent Only	Whether the vehicle is rental-only (not for sale)
Is Pre Trade	Pre-trade status flag
Is Private Party	Whether listed by a private seller vs. dealer
Has Variants	Whether the listing includes variant configurations
Is Pre At Result	Internal result positioning flag

Category & Classification

Field	Meaning
Category ID	Primary category identifier
Base Category ID	Top-level parent category ID
Alt Category ID	Alternative category classification
Legacy Base Category ID	Legacy system category reference
Category Name	Raw category name
Display Category Name	Human-readable category label shown on site

Vehicle Details

Field	Meaning
Manufacturer Name	Brand or make (e.g., Kenworth, Peterbilt)
Year	Model year of the vehicle
Model	Vehicle model designation
Serial Number	VIN or serial number, if disclosed
Condition	Listing condition (e.g., Used, New)
Specs	Key specifications object (may include mileage, engine, etc.)
Description	Full listing description text
Detail URL	Direct URL to the full listing page

Pricing & Commerce

Field	Meaning
Price	Listed asking price
Retail Price	Dealer's retail price (may differ from asking price)
Price Label	Display label for the price (e.g., "Call for Price")
Currency Code	Currency of the listed price (e.g., USD)
Criteo Price	Price value formatted for Criteo ad retargeting
MSRP Save Amount	Dollar savings vs. MSRP, if applicable
MSRP Save Percentage	Percentage savings vs. MSRP
Is Free Shipping	Whether free shipping is offered
Buy Now URL	Direct purchase URL, if enabled
Buy Now Button Text	CTA label on the buy button
Buy Now New Tab	Whether the buy link opens in a new tab

Dealer & Contact

Field	Meaning
Dealer	Dealer name
Dealer CRMID	Dealer's CRM system identifier
Account CRMID	Associated account CRM ID
Settings CRMID	Dealer settings profile CRM reference
Dealer Group ID	Group identifier for multi-location dealers
Dealer Contact	Primary contact name at the dealership
Retail Contact CRMID	CRM ID for the retail contact
Owner CRMID	Listing owner's CRM identifier
Web Site	Dealer's website URL
Premium Hosted Site	Whether the dealer has a premium hosted site
Retail Phone Number	Formatted dealer phone number
Retail Phone Number International Format	E.164 international format phone
Retail Phone Number Unformatted	Raw digits only
Is Retail Phone Number Text Enabled	Whether SMS is enabled for this number
Whatsapp Unformatted Phone Number	WhatsApp contact number, if available
Phone Click To Track URL	Tracked phone click URL for analytics
Custom Email Seller Text For Rental	Custom email template for rental inquiries
Custom Email Seller Text For Retail	Custom email template for purchase inquiries

Location

Field	Meaning
Dealer Location	Full dealer address/location
Listing Location	Specific location tied to this listing

Media & Display

Field	Meaning
Listing Image Model	Image metadata object (URLs, count, primary image)
Top Output Specs Count	Number of specs shown in the summary view
Employee Listing View Model	Internal employee/staff view metadata
Elastic Score	Search relevance score from Elasticsearch
Formatted Updated On Time	Human-readable last-updated timestamp

---

How to Use

1. Build your search URL — Use TruckPaper.com's search filters (category, year, state, condition) and copy the resulting URL from your browser.
2. Paginate if needed — Add multiple URLs with page=1, page=2, etc. to cover full result sets.
3. Configure the input — Paste URLs into the urls array. Set max_items_per_url to control volume per page.
4. Run the scraper — Start the actor and monitor the run log for any failed URLs.
5. Export — Download results as JSON, CSV, or Excel.

Best practices:

• Keep ignore_url_failures: true for multi-URL runs to avoid interruptions from occasional 404s or empty pages.
• Use category-specific URLs (via the Category= parameter) to get more targeted datasets.
• Cross-reference Detail URL to fetch full listing pages if deeper data is needed.

---

Use Cases & Business Value

• Inventory monitoring: Track available stock in specific truck categories or regions daily
• Pricing intelligence: Compare asking prices, MSRP savings, and retail pricing across dealers
• Lead generation: Extract dealer contact info and phone numbers for outreach
• Market research: Analyze supply volume, brand distribution, and condition breakdowns across the commercial truck market

---

Conclusion

The TruckPaper.com Cars Search Scraper turns paginated search results into rich, structured datasets with 60+ fields per listing. Whether you're sourcing inventory, tracking the market, or building a data pipeline, it eliminates manual effort and delivers consistent, analysis-ready data. Configure your search URL, set your limits, and run.