Skinport 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.
What is the Skinport 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.
curl -X GET 'https://api.parse.bot/scraper/978fc4bf-bc5a-4c23-b652-804404dcdcdb/get_market_items?skip=0&sort=date&order=asc&query=AK-47&category=Knife&exterior=Factory+New' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace skinport-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Skinport SDK — browse CS2 skin marketplace, drill into details, check pricing."""
from parse_apis.skinport_api import Skinport, Category, Sort, Exterior, Currency, ListingNotFound
client = Skinport()
# Search for Factory New knives sorted by price ascending
for listing in client.listingsummaries.search(
category=Category.KNIFE, exterior=Exterior.FACTORY_NEW, sort=Sort.PRICE, limit=3
):
print(listing.market_name, listing.sale_price, listing.wear)
# Drill into the first result's full details (seller, rating, offers)
item = client.listingsummaries.search(category=Category.RIFLE, limit=1).first()
if item:
detail = item.details()
print(detail.market_name, detail.seller.name, detail.rating_value, detail.offer_count)
# Fetch sales history for a specific item
try:
stats = client.saleshistories.get(market_hash_name="AK-47 | Redline (Field-Tested)")
print(stats.market_hash_name, stats.last_7_days.median, stats.last_30_days.volume)
except ListingNotFound as exc:
print(f"Item not found: {exc}")
# Browse the full price catalog in EUR
for entry in client.priceentries.list(currency=Currency.EUR, limit=3):
print(entry.market_hash_name, entry.min_price, entry.quantity)
print("exercised: listingsummaries.search / details / saleshistories.get / priceentries.list")
Browse the Skinport marketplace for CS2 item listings. Supports filtering by category, exterior condition, and free-text search. Results are paginated via skip offset and sortable by date or price. Returns up to 60 items per page plus filter metadata (total count, available exterior/other filters).
| Param | Type | Description |
|---|---|---|
| skip | integer | Number of items to skip for pagination. |
| sort | string | Sort field for results. |
| order | string | Sort direction for results. |
| query | string | Free-text search query to filter items by name. |
| category | string | Category filter for item type. |
| exterior | string | Exterior condition filter. |
{
"type": "object",
"fields": {
"items": "array of market listing objects with saleId, url, marketName, salePrice, wear, category, exterior, etc.",
"filter": "object containing total count and available filter options (components array)",
"success": "boolean indicating whether the request succeeded",
"requestId": "string unique request identifier"
},
"sample": {
"data": {
"items": [
{
"url": "talon-knife-doppler-factory-new+phase-2",
"name": "Doppler",
"wear": 0.0145,
"title": "Talon Knife",
"family": "Doppler",
"rarity": "Covert",
"saleId": 82547399,
"shortId": "AJWJJKFDDA7",
"category": "Knife",
"currency": "USD",
"exterior": "Factory New",
"souvenir": false,
"stattrak": false,
"salePrice": 98115,
"marketName": "★ Talon Knife | Doppler (Factory New)",
"subCategory": "Talon Knife",
"marketHashName": "★ Talon Knife | Doppler (Factory New)",
"suggestedPrice": 89940
}
],
"filter": {
"total": 3638094,
"components": [
{
"data": [],
"name": "price",
"type": "priceBar",
"appid": -1,
"resolved": []
}
]
},
"message": null,
"success": true,
"requestId": "f52985bb-99f0-674f-9e8b-87a22d136bbc"
},
"status": "success"
}
}About the Skinport API
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.
The Skinport API is a managed, monitored endpoint for skinport.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when skinport.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official skinport.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- 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 | 100 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.