REST API

Embed live recommerce prices into your platform

The RecommerceIQ API gives you programmatic access to real-time resale and buyback prices across 1M+ daily price points — covering smartphones, tablets, laptops, and smartwatches across Europe and the United States.

Request API accessDocumentation →
1 day
Time to go live
1M+
Daily price points
30+
Platforms monitored
Daily
Data refresh rate

Go live in 1 business day

01

Request access

Contact us via the demo form. API credentials are provisioned within one business day.

02

Authenticate

Catalog API V1 uses Bearer token auth; Prices API V1 passes the token directly. Both headers are named Authorization.

03

Query prices

Use the Catalog V1 or Prices V1 endpoints for new integrations. Legacy endpoints remain available.

04

Go live

Most clients complete integration and go live within 1 business day.

What the API covers

Device categories

  • Smartphones
  • Tablets
  • Laptops & PCs
  • Smartwatches

Condition grades

Aesthetic

  • Brand New (R)
  • Excellent (N)
  • Very Good (A)
  • Good (B)
  • Acceptable (C)

Battery

  • New (new)
  • Used (std)

Markets

  • United States
  • Germany, France, Italy
  • Netherlands, Spain
  • UK, Austria, and more

Authentication

All requests require an API token provided by the RecommerceIQ team, passed in the Authorization header. The header format differs by API group.

Base URL: https://dashboard.recommerceiq.com

Catalog API V1 — Authorization: Bearer <token>

curl --request GET \
  --url https://dashboard.recommerceiq.com/api/v1/catalog/YOUR_ITEM_ID/prices \
  --header 'Authorization: Bearer YOUR_API_KEY'

Prices API V1 — Authorization: <token>

curl --request GET \
  --url https://dashboard.recommerceiq.com/api/v1/prices/dictionary/pc \
  --header 'Authorization: YOUR_API_KEY'

Current APIs

Recommended

Use these V1 endpoints for all new integrations.

Catalog API

V1

Use this API if you have shared your product catalog with us. We pre-map your internal SKUs to our database during onboarding, so you can query prices using your own IDs directly — no device-level attribute matching needed on your side.

GET/api/v1/catalog/:externalID/prices

Retrieve resale and trade-in prices for a catalogue item by your internal ID. Returns aggregate prices by country and competitor, plus individual active listings (add-on).

externalID — your catalogue item internal ID (required)
GET/api/v1/catalog/:externalID/buybox/:vendorName/:vendorCountry

Retrieve the current Buy Box price for a specific vendor and market for a given catalogue item.

externalID — your catalogue item internal ID (required)vendorName — e.g. ebay (required)vendorCountry — e.g. de (required)

Prices API

V1

Use this API if you have not shared a catalog with us. You query prices by passing device attributes directly (brand, model, grade, storage, etc.) and we return matching market prices in real time — no prior SKU mapping required.

GET/api/v1/prices/dictionary/:category

Retrieve available brands, models, grades, and specifications for a device category. Use this to build your query parameters for the search endpoints.

category — smartphone | pc | tablet | smartwatch (required)
POST/api/v1/prices/pc/search

Search resale and trade-in prices for a specific PC configuration. Returns prices by country, by competitor, and active listings.

brandgrade — A | B | C | N | R (required)battery — std | new (optional, default std)modeldisplayprocessorramstorage
POST/api/v1/prices/smartphone/search

Search resale and trade-in prices for a specific smartphone. Available upon request.

Upon request
POST/api/v1/prices/tablet/search

Search resale and trade-in prices for a specific tablet. Available upon request.

Upon request
POST/api/v1/prices/smartwatch/search

Search resale and trade-in prices for a specific smartwatch. Available upon request.

Upon request

Need full request & response schemas?

The complete documentation includes parameter definitions, example payloads, and error codes for every endpoint.

Full documentation →

Legacy APIs

Legacy

These endpoints remain available and are not being deprecated, but new integrations should use the V1 APIs above.

Buyback API

Legacy
GET/api/buyback/configuration

Fetch global account configuration including available device categories.

GET/api/buyback/configuration/:slug

Fetch category-level configuration including brands, models, storage options, and grade definitions for a specific device category.

slug — pc | smartphone | tablet | smartwatch (required)
POST/api/buyback/price

Request a buyback price for a specific device. Supports smartphones, tablets, smartwatches, and PCs. Returns a single price value.

brandcategorymodelstoragegrademaximum_battery_capacitycharger_includedoriginal_box_included

Resell API

Legacy
POST/api/resell/price

Request a resale price for a specific smartphone. Returns a single price value. Tablets, smartwatches, and PCs are not yet supported on this endpoint.

brandcategory — smartphone onlynamegrade
POST/api/resell/price/history

Request historical resale prices for a smartphone by vendor, with daily min, max, average, and median prices. Tablets, smartwatches, and PCs are not yet supported.

brandcategory — smartphone onlygradenamebattery — std | new (optional, default std)

Catalog API

Legacy
GET/api/catalog/:externalId/prices/buyback

Fetch trade-in prices for a catalogue item by your feed ID, returned by country and grade.

externalId — your catalogue item ID as listed in the feed (required)

Ready to integrate?

Request API access and we will have your credentials ready within one business day.

Request accessDocumentation →