Documentation / Reference

API Reference

POST /v1/source-product

https://api.getparthound.com/v1/source-product

Use JSON and a fresh x-parthound-operation-id of 22–64 URL-safe characters. Maximum request body: 64 KB.

Request fields

queryRequired; max 500 characters
manufacturerOptional; max 120 characters
modelOptional; max 120 characters
partNumberOptional; max 120 characters
constraints.colorsUp to 10 colors
constraints.quantityUp to 999
constraints.maxUnitPriceUsdOptional
constraints.conditionUp to 6 conditions
constraints.countryOptional

Response

Successful reports include paid, price, network, chain, normalized request, ranked matches, recommendation and humanSummary. Matches include source evidence, warnings, and verification status where available. Unknown details are not invented.

HTTP statuses

200 delivered · 400 invalid request · 402 payment required/uncertain · 409 duplicate · 413 payload too large · 429 rate limited · 502 source failure · 503 unavailable

Free health endpoint

GET https://api.getparthound.com/health

No self-service report recovery route. If payment is uncertain, do not pay again; contact support@getparthound.com.