API Reference

PartWiz API Reference

Full reference for every endpoint, parameter, and response field. All requests are HTTPS and authenticated with a Bearer token.

Base URLhttps://api.partwiz.app

Versionv1

Endpoints

POST/v1/enrichEnrich a single part number

Takes a part number and returns a complete enriched product record including specs, fitment, cross-references, SEO metadata, and FAQ content.

Request body

part_numberstringrequiredThe part number to enrich. OEM and IAM numbers are both supported.

brandstringoptionalOptional. Manufacturer or brand name to help resolve ambiguous part numbers.

languagestringoptionalISO 639-1 language code for generated content (e.g. "en", "de", "fr"). Defaults to "en".

fieldsarrayoptionalOptional whitelist of response fields to return (e.g. ["specs","fitment"]). Returns all fields if omitted.

Example request

POST /v1/enrich
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "part_number": "402061KA3B",
  "brand": "Nissan",
  "language": "en"
}

Response fields

part_numberstringNormalised part number.

namestringStandardised part name (English or requested language).

categorystringPart category (e.g. "Brakes", "Filters", "Engine").

brandstringOriginal manufacturer or OEM brand.

cross_referencesarrayList of equivalent part numbers from other brands, each with brand and part_number.

fitmentarrayVehicle compatibility list — make, model, and year range for each application.

specsobjectKey-value map of technical specifications relevant to the part type.

seoobjectSEO fields: title, meta description, keywords array, slug, and structured FAQ pairs.

faqarrayArray of {q, a} objects — compatibility and fitment questions ready for schema markup.

confidencenumberData confidence score 0–1. Values below 0.7 indicate lower certainty.

POST/v1/enrich/batchEnrich multiple parts at once

Accepts an array of part numbers and returns an array of enriched product records in the same order. Maximum 100 parts per batch request.

{
  "parts": [
    { "part_number": "402061KA3B", "brand": "Nissan" },
    { "part_number": "11427512300", "brand": "BMW" }
  ],
  "language": "en"
}

Batch requests are available on Starter plans and above. Each part in the batch counts against your monthly quota.

GET/v1/accountCheck usage and quota

Returns current plan, parts used this month, parts remaining, and rate limit status.

{
  "plan": "Starter",
  "parts_used": 847,
  "parts_limit": 2500,
  "reset_at": "2026-07-01T00:00:00Z"
}

Ready to start enriching parts?

Get your API key and 25 free parts today.

Get started free →