Introduction

What you can build

• Resale intake and offer generation: identify items and price them as sellers submit products for buyout or consignment
• Instant offers: compute a trade-in or buyback offer on an item a customer presents
• Listing tools: suggest an asking price inside a listing draft
• Inventory pricing: price inventory before you acquire it, or set asking prices across stock you hold
• Authentication documentation: state a value on a certificate you issue (additional terms apply — see Usage Policy)
• Internal pricing tools: support buying, pricing, and margin decisions inside your business

How pricing may be used

Three rules govern every integration. They apply the same way whether your users are consumers or businesses.

Scope. A price may be requested and shown for one item, for the person who submitted it, at the time they ask. Prices may not appear on browsable, searchable, or public surfaces — model index pages, price-history pages, "look up any item" search, comparison tables, or indexable pages — and may not be swept across a catalog on a schedule.

Form. A price may be rendered into an output your product produces: an offer, a published listing, a certificate, a record of a decision already made. A rendered output is written once and not updated — saved drafts and working state are not rendered outputs. A price may not be retained as a Price Hero estimate. Once a person commits a number as their own asking or offer price, that number is their commercial decision and yours to keep. See Storing and caching.

Position. Pricing supports what your product does. It may not be what your product is. An application whose purpose is to return a valuation is not licensed on self-serve terms.

Where the transaction happens

It does not matter, and you do not need to be a party to it. A reseller using Price Hero pricing to decide what to bid on a third-party marketplace is a permitted use even though the sale settles somewhere else entirely. What matters is how the price is scoped, stored, and positioned in your product — not whose checkout the money moves through.

Examples

Permitted:

• A retailer computing an instant trade-in offer on an item a customer brings in
• A reseller pricing inventory before bidding, wherever the purchase happens
• A crosslisting or listing tool suggesting an asking price as a merchant prepares a listing (distribution to a large population of merchants requires a signed agreement)
• A consignment or buyout platform setting intake prices on submitted items
• An authentication service stating a value on a certificate it issues
• An internal tool supporting buying and pricing decisions

Not permitted:

• A valuation or price-check product where the estimate is the deliverable
• Price history pages, price indexes, or per-model pages as browsable surfaces. A history chart shown for a single item inside a sell or offer flow is permitted — see Historical estimates
• Publishing prices in marketing, media, or indexable pages
• Bulk or scheduled pricing of a catalog
• Comparing Price Hero output against another provider's

If your integration doesn't clearly sit on one side of this, ask before you build: mailys@pricehero.ai.

Core capabilities

Getting started

1. Create your account and generate an API key from the Developer Dashboard
2. Follow the Quickstart guide to make your first request
3. Read about Authentication and Credits
4. Explore the full API Reference (defaults to v3; use the version control in the sidebar to open legacy v1 / v2)

Base URL

All API requests are made to:

https://api.pricehero.ai

All endpoints are available under /v3/ (current) or /v1/ and /v2/ for legacy clients.