MarketCheck Universal Intelligence Toolkit

An Apify Actor that serves as a universal interface and intelligence layer for the MarketCheck API ecosystem. Decode VINs, search inventory, run valuations, check recalls, and execute raw endpoint calls across cars, RVs, motorcycles, powersports, and heavy equipment.

Get a MarketCheck API Key

You must bring your own MarketCheck API key. This Actor does not provide API access.

Sign up

1. Go to MarketCheck Universe
2. Sign up (Google, GitHub, Microsoft, or email)
3. Navigate to API Keys in your account
4. Generate a new API key

API plans

Plan	Monthly quota	Rate limit
Free	500 API calls	5 RPS
Basic	5,000 API calls	5 RPS
Standard	Pay-per-use	40 RPS
Enterprise	Custom	Custom

MarketCheck offers 500 free API calls per month on the Free plan — ideal for testing and light usage. The Basic plan includes 5,000 calls/month. Unused quota does not roll over. See MarketCheck Quota and Rate Limits for details.

Third-party APIs (recallCheck, VINData, CarsXE)

Some endpoints use licensed 3rd party APIs (AutoRecalls, VINData, CarsXE). To use them:

1. Subscription: The Free plan does not include access to 3rd party APIs. You need Basic ($299/mo) or higher.
2. Terms & conditions: You must view and accept terms & conditions for each 3rd party API in the MarketCheck Universe → API Subscriptions portal under "Licensed 3rd party API's."

Without both a qualifying plan and accepted terms, calls to recallCheck or raw endpoints like autorecalls-car will return 403 Forbidden.

Job types

Job type	Description	Verticals
decodeVin	Decode 17-char VIN to specs	cars only
searchInventory	Search active listings	all
vehicleValuation	VIN decode → search comparables → pricing stats	all (VIN decode: cars only)
marketSnapshot	Cars: MDS, sales, popular. Others: inventory stats	all
recallCheck	Recall info by VIN	cars only
rawEndpointCall	Call any registered or custom endpoint	all

Verticals

• cars — Full support (decode, search, valuation, recall, MDS/sales/popular snapshot)
• rv — Search, valuation, market snapshot (inventory stats)
• motorcycles — Search, valuation, market snapshot
• powersports — Maps to motorcycle endpoints
• heavy_equipment — Search, valuation, market snapshot

Input example

{
  "apiKey": "YOUR_MARKETCHECK_API_KEY",
  "jobType": "vehicleValuation",
  "vertical": "cars",
  "vin": "1HGBH41JXMN109186",
  "searchCriteria": { "zip": "90210", "radius": 100 },
  "strictness": "balanced",
  "outputMode": "summary"
}

Output example (vehicle valuation)

{
  "jobType": "vehicleValuation",
  "vertical": "cars",
  "input": { "vin": "1HGBH41JXMN109186" },
  "vehicle": {
    "make": "Subaru",
    "model": "Ascent",
    "year": 2019,
    "trim": "Touring"
  },
  "summary": {
    "listingCount": 100,
    "medianPrice": 20150,
    "averagePrice": 20440,
    "fairPriceLow": 19300,
    "fairPriceHigh": 21200
  }
}

Full validation

Run end-to-end validation across all verticals (~18 API calls):

$MARKETCHECK_API_KEY=your_key npm run validate

Deploy to Apify

1. Push this repo to GitHub (or use Apify’s Git integration)
2. Go to Apify Console → Create Actor
3. Connect your repository and deploy

Security

• The Actor never stores, logs, or exposes your API key
• All requests go through official MarketCheck API endpoints
• No scraping or proxying of MarketCheck data sources

References

• MarketCheck API docs
• MarketCheck Universe — sign up and API keys
• Apify Platform