skinport.com APIskinport.com ↗
Access Skinport CS2 skin listings, item details, sales history, and aggregated pricing via 4 endpoints. Filter by category, exterior, and sort by price or date.
curl -X GET 'https://api.parse.bot/scraper/978fc4bf-bc5a-4c23-b652-804404dcdcdb/get_market_items?sort=date&order=desc' \ -H 'X-API-Key: $PARSE_API_KEY'
Fetch market listings for items with search, sorting, and category filters. Returns paginated results from the Skinport browse API.
| Param | Type | Description |
|---|---|---|
| skip | integer | Number of items to skip for pagination. |
| sort | string | Sort field. Accepted values: 'date', 'price'. |
| order | string | Sort order. Accepted values: 'asc', 'desc'. |
| query | string | Search query to filter items by name. |
| category | string | Category filter. Accepted values: 'Knife', 'Rifle', 'Gloves', 'Pistol', 'SMG', 'Heavy', 'Agent', 'Charm', 'Sticker', 'Container'. |
| exterior | string | Exterior filter. Accepted values: 'Factory New', 'Minimal Wear', 'Field-Tested', 'Well-Worn', 'Battle-Scarred'. |
{
"type": "object",
"fields": {
"items": "array of item listing objects with saleId, url, marketName, salePrice, wear, category, exterior, etc.",
"filter": "object containing total count and available filter options",
"success": "boolean, whether the request succeeded",
"requestId": "string, unique request identifier"
},
"sample": {
"data": {
"items": [
{
"url": "m9-bayonet-fade-factory-new",
"wear": 0.008,
"saleId": 81018456,
"category": "Knife",
"currency": "USD",
"exterior": "Factory New",
"salePrice": 121866,
"marketName": "★ M9 Bayonet | Fade (Factory New)"
}
],
"filter": {
"total": 18628
},
"message": null,
"success": true,
"requestId": "abc123"
},
"status": "success"
}
}About the skinport.com API
The Skinport API provides access to CS2 skin marketplace data across 4 endpoints, covering live market listings, per-listing details, aggregated sales statistics, and a full catalog price list. The get_market_items endpoint lets you search and filter active listings by category, exterior condition, and keyword, returning structured records with sale IDs, prices, and wear data ready for downstream use.
Market Listings and Item Details
get_market_items returns paginated listing objects from the Skinport marketplace. Each record includes fields like saleId, url, marketName, salePrice, wear, category, and exterior. You can narrow results with the query parameter for keyword search, category for weapon type (Knife, Rifle, Gloves, Pistol, SMG, Heavy, Agent, Charm), and exterior for condition (Factory New through Battle-Scarred). Results are sortable by date or price in either direction using the sort and order parameters, with skip for pagination. The response also includes a filter object containing the total listing count and available filter facets.
get_item_details requires both a sale_id and a matching item_slug — the two must refer to the same listing or the request returns a not-found error. When matched correctly, the data object in the response includes the full item record with seller information, a list of similarItems, otherSales of the same item, trend data, sales history suitable for charting, a rating, offers, and a relatedItem object. This makes it useful for building per-listing detail pages or comparisons.
Sales History and Price List
get_sales_history accepts a market_hash_name such as AK-47 | Redline (Field-Tested) and returns price and volume statistics across four time windows: last_24_hours, last_7_days, last_30_days, and last_90_days. Each window exposes min, max, avg, median, and volume values, along with direct links via item_page and market_page fields.
get_price_list returns the full Skinport item catalog with current pricing metadata. Each record includes min_price, max_price, mean_price, median_price, quantity, and Unix timestamps for created_at and updated_at. You can request prices in a specific currency via the currency parameter and restrict results to tradable items only with the tradable boolean flag. This endpoint is suited for bulk price comparison and catalog indexing tasks.
- Track price trends for specific CS2 skins using 24h, 7d, 30d, and 90d statistics from get_sales_history
- Build a skin deal-finder by filtering get_market_items by exterior and sorting by price ascending
- Monitor new listings for a specific item type by querying get_market_items with a keyword and sorting by date
- Compare seller offers and similar listings for a specific sale using get_item_details' similarItems and otherSales fields
- Index the full Skinport catalog with min/max/median pricing using get_price_list for bulk price comparison
- Filter tradable-only items from the price list using the tradable parameter for trade-bot pricing feeds
- Compute market spread or volatility for an item by combining get_price_list mean/median with get_sales_history volume data
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Skinport have an official developer API?+
What does get_item_details return beyond basic listing data?+
data object containing the full item record with seller info, a similarItems array, an otherSales list for the same item, trends, a history array suitable for charting price over time, a rating, offers, and a relatedItem object. Both sale_id and item_slug are required and must match the same listing.Does get_sales_history return individual transaction records?+
Can I retrieve a seller's full listing history or profile data?+
How does pagination work in get_market_items?+
skip parameter — pass the number of items already retrieved to fetch the next page. The filter object in the response includes a total count, which you can use to determine when all results have been fetched.