Vesselfinder Vessel Search Scraper

What does VesselFinder Vessel Search Scraper do?

VesselFinder Vessel Search Scraper searches VesselFinder's global vessel database by name, flag state, or vessel type and returns all matching vessels with their details. Search for a company's entire fleet by name prefix, find all vessels under a specific flag, or browse vessels by type — with automatic pagination to retrieve all results.

Results are pushed directly to an Apify dataset. Combine with vesselfinder-vessel-scraper to enrich each result with live position data.

Why use VesselFinder Vessel Search Scraper?

• Fleet discovery — find all vessels operated under a company name (e.g. search "Meratus" to get all Meratus Line ships).
• Flag state research — retrieve all vessels registered under a specific country's flag.
• Vessel database building — build a comprehensive database of vessel particulars for a specific segment.
• Competitive intelligence — track fleet size and composition for shipping companies.

How to use VesselFinder Vessel Search Scraper

1. Open the Actor and click Try for free.
2. In the Input tab, enter a vessel name query, flag code, or vessel type (at least one required).
3. Set Max Results to limit how many vessels to return.
4. Click Start and wait for the run to finish.
5. Download results from the Output tab in JSON, CSV, or Excel format.

Input

At least one of query, flag, or vessel_type must be provided.

Field	Type	Description
query	string	Vessel name or partial name (e.g. "Meratus", "Ever Given")
flag	string	ISO 2-letter country code (e.g. "ID", "SG", "PA")
vessel_type	string	Vessel type filter (e.g. "general_cargo", "container", "tanker")
max_results	integer	Maximum number of results to return (default: 100)

{
    "query": "Meratus",
    "flag": "ID",
    "vessel_type": "",
    "max_results": 100
}

Output

Each item represents one vessel matching the search criteria.

{
    "name": "MERATUS JAYAPURA",
    "imo": "9456789",
    "mmsi": null,
    "flag": "ID",
    "vessel_type": "General Cargo",
    "length": 145.0,
    "gross_tonnage": 9800,
    "deadweight": 13500,
    "year_built": 2010,
    "url": "https://www.vesselfinder.com/vessels/details/9456789"
}

Data table

Field	Description
name	Vessel name
imo	IMO number (from vessel detail URL)
mmsi	MMSI number (not shown in search results, always null)
flag	2-letter flag country code
vessel_type	Vessel type classification
length	Length overall in metres
gross_tonnage	Gross tonnage
deadweight	Deadweight tonnage
year_built	Year the vessel was built
url	Direct VesselFinder vessel page URL

Tips

• Use partial names to find an entire fleet: "Meratus" finds all Meratus Line vessels.
• Combine flag and vessel_type without a name to browse specific segments (e.g. all Indonesian tankers).
• Set max_results to a high number (e.g. 1000) for comprehensive fleet listings, but expect longer run times.
• Use the returned URLs to feed into vesselfinder-vessel-scraper for live position data on each vessel.

FAQ and support

This Actor uses VesselFinder's publicly available vessel search for informational purposes only. Do not use the data for commercial redistribution without verifying VesselFinder's terms of service.

For bugs or feature requests, open an issue on the Actor's Issues tab.