Responses
pypricecharting.responses
ErrorResponse
Bases: PriceChartingModel
Error response from any endpoint
Returned with a 4xx or 5xx status code. The clients raise error.APIError instead of
returning it.
https://www.pricecharting.com/api-documentation
error_message = None
class-attribute
instance-attribute
Why the request failed.
ProductResponse
Bases: ProductSummary
api/product response
Prices are in pennies. Price keys mean different conditions for video games, cards and comics, noted below as video games / cards / comics.
https://www.pricecharting.com/api-documentation#api-product
genre = None
class-attribute
instance-attribute
Product genre, such as "RPG". See types.Genre for video game genres.
asin = None
class-attribute
instance-attribute
Amazon ASIN.
epid = None
class-attribute
instance-attribute
eBay ePID.
tcg_id = None
class-attribute
instance-attribute
TCGplayer ID. Trading cards only.
sales_volume = None
class-attribute
instance-attribute
Units sold per year.
loose_price = None
class-attribute
instance-attribute
Video games: item only, no box or manual. Cards: ungraded. Comics: ungraded.
cib_price = None
class-attribute
instance-attribute
Video games: item with box and manual. Cards: grade 7 or 7.5. Comics: 4.0 or 4.5.
new_price = None
class-attribute
instance-attribute
Video games: new and sealed. Cards: grade 8 or 8.5. Comics: 6.0 or 6.5.
graded_price = None
class-attribute
instance-attribute
Video games: new, graded by WATA or VGA. Cards: grade 9. Comics: 8.0 or 8.5.
box_only_price = None
class-attribute
instance-attribute
Video games: original box only. Cards: grade 9.5. Comics: 9.2.
manual_only_price = None
class-attribute
instance-attribute
Video games: original manual only. Cards: PSA 10. Comics: 9.8.
bgs_10_price = None
class-attribute
instance-attribute
Cards: BGS 10. Comics: 10.0.
condition_9_price = None
class-attribute
instance-attribute
Cards: grade 1. Comics: 2.0 (Good).
condition_10_price = None
class-attribute
instance-attribute
Cards: grade 2. Comics: 9.6 (Near Mint+).
condition_13_price = None
class-attribute
instance-attribute
Cards: grade 3. Comics: 3.0.
condition_14_price = None
class-attribute
instance-attribute
Cards: grade 4. Comics: 5.0.
condition_15_price = None
class-attribute
instance-attribute
Cards: grade 5. Comics: 7.0.
condition_16_price = None
class-attribute
instance-attribute
Cards: grade 6. Comics: 9.0.
condition_17_price = None
class-attribute
instance-attribute
Cards: CGC 10. Comics: 9.4.
condition_18_price = None
class-attribute
instance-attribute
Cards: SGC 10.
condition_19_price = None
class-attribute
instance-attribute
Cards: CGC 10 Pristine.
condition_20_price = None
class-attribute
instance-attribute
Cards: BGS 10 Black.
condition_21_price = None
class-attribute
instance-attribute
Cards: TAG 10.
condition_22_price = None
class-attribute
instance-attribute
Cards: ACE 10.
gamestop_price = None
class-attribute
instance-attribute
GameStop pre-owned price.
retail_loose_buy = None
class-attribute
instance-attribute
Recommended price for a retailer to buy a loose copy.
retail_loose_sell = None
class-attribute
instance-attribute
Recommended price for a retailer to sell a loose copy.
retail_cib_buy = None
class-attribute
instance-attribute
Recommended price for a retailer to buy a complete-in-box copy.
retail_cib_sell = None
class-attribute
instance-attribute
Recommended price for a retailer to sell a complete-in-box copy.
retail_new_buy = None
class-attribute
instance-attribute
Recommended price for a retailer to buy a new copy.
retail_new_sell = None
class-attribute
instance-attribute
Recommended price for a retailer to sell a new copy.
ProductsResponse
Bases: PriceChartingModel
api/products response
https://www.pricecharting.com/api-documentation#api-products
products = Field(default_factory=list)
class-attribute
instance-attribute
Up to 20 best matches for the search.
OffersResponse
Bases: PriceChartingModel
api/offers response
https://www.pricecharting.com/api-documentation#offers
OfferDetailsResponse
Bases: PriceChartingModel
api/offer-details response
https://www.pricecharting.com/api-documentation#offer-details
buyer = None
class-attribute
instance-attribute
Buyer contact and shipping details. Set once the offer sells.
id = None
class-attribute
instance-attribute
PriceCharting product ID, not the offer ID.
cost_basis = None
class-attribute
instance-attribute
What the seller paid for the item, in pennies.
price = None
class-attribute
instance-attribute
Current price in pennies, or the sale price if sold. Includes any shipping premium.
price_max = None
class-attribute
instance-attribute
Listing price in pennies, or the starting price of a reverse auction.
price_min = None
class-attribute
instance-attribute
Lowest price in pennies of a reverse auction. Not set for standard listings.
shipping_premium = None
class-attribute
instance-attribute
Extra the buyer paid for international shipping, in pennies.
best_competing_price = None
class-attribute
instance-attribute
Lowest Marketplace price in pennies for the same product and includes.
value = None
class-attribute
instance-attribute
Current value in pennies of a collection item.
is_best_priced_offer = None
class-attribute
instance-attribute
Whether this is the lowest priced offer for the product.
is_collection = None
class-attribute
instance-attribute
Whether the item is in the seller's collection instead of listed for sale.
is_price_descending = None
class-attribute
instance-attribute
Whether the offer is a reverse auction, dropping toward price_min.
pending_reason = None
class-attribute
instance-attribute
Why offer_status is pending.
offer_url = None
class-attribute
instance-attribute
Relative URL of the offer page. Prepend route.BASE_URL for a full link.
image_url = None
class-attribute
instance-attribute
Relative URL of the offer's main image.
seller_id = None
class-attribute
instance-attribute
Seller's user ID.
sku = None
class-attribute
instance-attribute
Seller's internal SKU. Only returned to the seller.
start_time = None
class-attribute
instance-attribute
Date the offer was published. Resets when the offer is revised.
sale_time = None
class-attribute
instance-attribute
Date the offer sold. 0001-01-01 if it hasn't happened.
shipped_time = None
class-attribute
instance-attribute
Date the seller told PriceCharting the offer shipped. 0001-01-01 if it hasn't happened.
ended_time = None
class-attribute
instance-attribute
Date the offer ended, by sale or by the seller. 0001-01-01 if it hasn't happened.
refunded_time = None
class-attribute
instance-attribute
Date the offer was refunded. 0001-01-01 if it hasn't happened.
OfferPublishResponse
Bases: PriceChartingModel
api/offer-publish response
https://www.pricecharting.com/api-documentation#offer-publish
offer_url = None
class-attribute
instance-attribute
Relative URL of the offer page. Prepend route.BASE_URL for a full link.
condition_string = None
class-attribute
instance-attribute
Condition shown to buyers, such as "Normal Wear".
include_string = None
class-attribute
instance-attribute
What comes with the item, such as game only or game and box.
price = None
class-attribute
instance-attribute
Listing price in pennies.
cost_basis = None
class-attribute
instance-attribute
What the seller paid for the item, in pennies.
sku = None
class-attribute
instance-attribute
Seller's internal SKU.
is_collection = None
class-attribute
instance-attribute
Whether the item is in the seller's collection instead of listed for sale.
quantity = None
class-attribute
instance-attribute
Number of copies owned. Collections only.
start_time = None
class-attribute
instance-attribute
Date the offer was published.
OfferFeedbackResponse
Bases: PriceChartingModel
api/offer-feedback response
https://www.pricecharting.com/api-documentation#offer-feedback
OfferShipResponse
Bases: PriceChartingModel
api/offer-ship response
https://www.pricecharting.com/api-documentation#offer-ship
shipped_time = None
class-attribute
instance-attribute
Date PriceCharting was notified, not when the carrier received the item.
OfferEndResponse
Bases: PriceChartingModel
api/offer-end response
https://www.pricecharting.com/api-documentation#offer-end
OfferRefundResponse
Bases: PriceChartingModel
api/offer-refund response
https://www.pricecharting.com/api-documentation#offer-refund