The ProductService API from Refurbed — 2 operation(s) for productservice.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/refurbed-productservice-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Affiliate Partner BuybackBidService Product Service API
version: '1.0'
description: The refurbed affiliate partner API allows to retrieve info about markets, products and instances including the buybox info (current price, grading, warranty).
contact:
name: Refurbed Affiliate Partner Integrations Team
email: integrations@refurbed.com
servers:
- url: https://api.refurbed.com
security:
- APIKeyAuth: []
tags:
- name: ProductService
paths:
/refb.partner.affiliate.v1.ProductService/GetProduct:
post:
summary: Gets a single product.
description: "Known errors:\n- UNAUTHENTICATED\n - when no authorization header is sent\n - when authorization header is malformed or invalid\n- PERMISSION_DENIED\n - when the authorized user does not have permissions for this operation\n- NOT_FOUND\n - when the product is not found"
operationId: GetProduct
responses:
'200':
description: A successful response.
content:
application/json:
schema:
$ref: '#/components/schemas/GetProductResponse'
default:
description: An unexpected error response.
content:
application/json:
schema:
$ref: '#/components/schemas/Status'
tags:
- ProductService
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/GetProductRequest'
required: true
/refb.partner.affiliate.v1.ProductService/ListProducts:
post:
summary: Lists products.
description: "Known errors:\n- UNAUTHENTICATED\n - when no authorization header is sent\n - when authorization header is malformed or invalid\n- PERMISSION_DENIED\n - when the authorized user does not have permissions for this operation\n- INVALID_ARGUMENT\n - when pagination limit is too large (>100)\n - when both \"ending_before\" and \"starting_after\" are specified in pagination"
operationId: ListProducts
responses:
'200':
description: A successful response.
content:
application/json:
schema:
$ref: '#/components/schemas/ListProductsResponse'
default:
description: An unexpected error response.
content:
application/json:
schema:
$ref: '#/components/schemas/Status'
tags:
- ProductService
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ListProductsRequest'
required: true
components:
schemas:
Attribute:
type: object
properties:
id:
type: string
format: int64
description: Primary key.
name:
type: string
description: Human-readable name.
type:
$ref: '#/components/schemas/AttributeType'
description: Type fo the attribute.
value_str:
$ref: '#/components/schemas/StringValue'
description: Value is set if type is ENUM.
value_num:
$ref: '#/components/schemas/NumericValue'
description: Value is set if type is NUMERIC.
description: An Attribute.
MediaType:
type: string
enum:
- UNSPECIFIED
- IMAGE
default: UNSPECIFIED
Status:
type: object
properties:
code:
type: integer
format: int32
message:
type: string
details:
type: array
items:
$ref: '#/components/schemas/Any'
CategoryFilter:
type: object
properties:
any_of:
type: array
items:
type: string
format: int64
is_recursive:
type: boolean
description: 'If set to true selected category and all its subcategories will
be considered recursively.'
ListProductsRequest.Sort:
type: object
properties:
order:
$ref: '#/components/schemas/SortOrder'
by:
$ref: '#/components/schemas/ListProductsRequest.Sort.By'
Product:
type: object
properties:
id:
type: string
format: int64
description: Primary key.
name:
type: string
description: Human-readable name.
category_id:
type: string
format: int64
description: Identifier of category this product is linked with.
category_path:
type: array
items:
type: string
description: Human-readable names of category hierarchy path (e.g. ["Smartphones", "Apple"]).
attributes:
type: array
items:
$ref: '#/components/schemas/Attribute'
description: List of attributes assigned to this product.
medias:
type: array
items:
$ref: '#/components/schemas/Media'
description: List of media assigned to this product.
buybox:
$ref: '#/components/schemas/Buybox'
description: 'Buybox data, defines the price and conditions (grading, warranty) by which
this best instance for a given product is sold.'
description: A product.
EnumValueCond:
type: object
properties:
eq:
type:
- string
- 'null'
description: An enum attribute value condition.
Any:
type: object
properties:
'@type':
type: string
additionalProperties: {}
ListProductsRequest:
type: object
properties:
pagination:
$ref: '#/components/schemas/Int64Pagination'
sort:
$ref: '#/components/schemas/ListProductsRequest.Sort'
filter:
$ref: '#/components/schemas/ListProductsRequest.Filter'
site_market_code:
type: string
description: The code of a site market where the products are sold.
required:
- site_market_code
back_link:
type:
- string
- 'null'
description: 'URL linking back to partner''s site.
If provided, it is used to populate a query parameter for each
product buybox link.'
required:
- site_market_code
SortOrder:
type: string
enum:
- ASC
- DESC
default: ASC
Int64Pagination:
type: object
properties:
limit:
type:
- integer
- 'null'
format: int64
description: 'Limit on the number of results to be returned. Between 1 and 100.
Default and maximum is 100.'
ending_before:
type: string
format: int64
starting_after:
type: string
format: int64
description: Paginates resources with int64 primary key.
AttributeType:
type: string
enum:
- UNSPECIFIED
- ENUM
- NUMERIC
default: UNSPECIFIED
description: "A type of an attribute.\n\n - ENUM: An enumerated attribute has a string value, e.g. Colour = black.\n - NUMERIC: A numeric attribute has a numeric value with an optional unit, e.g.\nMemory = 2 GB"
ProductIDFilter:
type: object
properties:
any_of:
type: array
items:
type: string
format: int64
NumericValueCond:
type: object
properties:
eq:
type:
- number
- 'null'
format: double
description: A numeric attribute value condition.
StringValue:
type: object
properties:
value:
type: string
OfferGrading:
type: string
enum:
- UNSPECIFIED
- A
- B
- C
default: UNSPECIFIED
description: The grading of the item being sold.
AttributesFilter:
type: object
properties:
all_of:
type: array
items:
$ref: '#/components/schemas/Expression'
GetProductRequest:
type: object
properties:
site_market_code:
type: string
description: Code of a site market where the product is sold.
required:
- site_market_code
id:
type: string
format: int64
description: Primary key of the product to get.
required:
- id
back_link:
type:
- string
- 'null'
description: 'URL linking back to partner''s site.
If provided, it is used to populate a query parameter for product
buybox link.'
required:
- site_market_code
- id
OfferWarranty:
type: string
enum:
- UNSPECIFIED
- M12
- M18
- M24
- M30
- M36
default: UNSPECIFIED
description: "The warranty the merchant provides to the customer. Only 12 months is supported.\n\n - M12: 12 months.\n - M18: 18 months, deprecated. Only 12 months is supported for new offers.\n - M24: 24 months, deprecated. Only 12 months is supported for new offers.\n - M30: 30 months, deprecated. Only 12 months is supported for new offers.\n - M36: 36 months, deprecated. Only 12 months is supported for new offers."
Buybox:
type: object
properties:
instance_id:
type: string
format: int64
description: Primary key of the linked instance.
instance_name:
type: string
description: Human-readable name of the linked instance.
grading:
$ref: '#/components/schemas/OfferGrading'
description: Grading of the item sold.
grading_name:
type: string
description: Human-readable name of the grading.
warranty:
$ref: '#/components/schemas/OfferWarranty'
description: Warranty of the item sold.
currency_code:
$ref: '#/components/schemas/CurrencyCode'
description: Currency in which the item is sold.
price:
type: string
description: Price at which the item is sold.
link:
type: string
description: 'URL to the item on refurbed marketplace.
If a back link is specified in the original request an additional query
parameter will be included in the link.'
description: A Buybox.
Expression:
type: object
properties:
attribute_id:
type: string
format: int64
cond_enum:
$ref: '#/components/schemas/EnumValueCond'
cond_numeric:
$ref: '#/components/schemas/NumericValueCond'
description: An attribute expression.
NumericValue:
type: object
properties:
value:
type: number
format: double
unit:
type:
- string
- 'null'
ProductNameFilter:
type: object
properties:
matches:
type:
- string
- 'null'
ListProductsRequest.Sort.By:
type: string
enum:
- POPULARITY
- PRICE
default: POPULARITY
description: " - POPULARITY: Sort by popularity.\n\nNOTE: ASC and DESC will return the same result.\n - PRICE: Sort by price."
ListProductsRequest.Filter:
type: object
properties:
id:
$ref: '#/components/schemas/ProductIDFilter'
name:
$ref: '#/components/schemas/ProductNameFilter'
category_id:
$ref: '#/components/schemas/CategoryFilter'
attributes:
$ref: '#/components/schemas/AttributesFilter'
CurrencyCode:
type: string
enum:
- UNSPECIFIED
- AED
- AFN
- ALL
- AMD
- ANG
- AOA
- ARS
- AUD
- AWG
- AZN
- BAM
- BBD
- BDT
- BGN
- BHD
- BIF
- BMD
- BND
- BOB
- BOV
- BRL
- BSD
- BTN
- BWP
- BYR
- BZD
- CAD
- CDF
- CHE
- CHF
- CHW
- CLF
- CLP
- CNY
- COP
- COU
- CRC
- CUC
- CUP
- CVE
- CZK
- DJF
- DKK
- DOP
- DZD
- EGP
- ERN
- ETB
- EUR
- FJD
- FKP
- GBP
- GEL
- GHS
- GIP
- GMD
- GNF
- GTQ
- GYD
- HKD
- HNL
- HRK
- HTG
- HUF
- IDR
- ILS
- INR
- IQD
- IRR
- ISK
- JMD
- JOD
- JPY
- KES
- KGS
- KHR
- KMF
- KPW
- KRW
- KWD
- KYD
- KZT
- LAK
- LBP
- LKR
- LRD
- LSL
- LTL
- LYD
- MAD
- MDL
- MGA
- MKD
- MMK
- MNT
- MOP
- MRO
- MUR
- MVR
- MWK
- MXN
- MXV
- MYR
- MZN
- NAD
- NGN
- NIO
- NOK
- NPR
- NZD
- OMR
- PAB
- PEN
- PGK
- PHP
- PKR
- PLN
- PYG
- QAR
- RON
- RSD
- RUB
- RWF
- SAR
- SBD
- SCR
- SDG
- SEK
- SGD
- SHP
- SLL
- SOS
- SRD
- SSP
- STD
- SVC
- SYP
- SZL
- THB
- TJS
- TMT
- TND
- TOP
- TRY
- TTD
- TWD
- TZS
- UAH
- UGX
- USD
- USN
- UYI
- UYU
- UZS
- VEF
- VND
- VUV
- WST
- XAF
- XAG
- XAU
- XBA
- XBB
- XBC
- XBD
- XCD
- XDR
- XOF
- XPD
- XPF
- XPT
- XSU
- XUA
- YER
- ZAR
- ZMW
- ZWL
default: UNSPECIFIED
description: "Currency codes as specified in ISO 4217.\n\n - AED: XTS = 963; // Code reserved for testing purposes."
GetProductResponse:
type: object
properties:
product:
$ref: '#/components/schemas/Product'
description: The product retrieved.
ListProductsResponse:
type: object
properties:
products:
type: array
items:
$ref: '#/components/schemas/Product'
description: The products found.
has_more:
type: boolean
description: Indicates whether there are more results available.
Media:
type: object
properties:
type:
$ref: '#/components/schemas/MediaType'
description: Type of the media.
url:
type: string
description: URL to the media.
description: A media.
securitySchemes:
APIKeyAuth:
type: apiKey
name: Authorization
in: header