Starvell APIstarvell.com ↗
Access Starvell.com's game currency and item marketplace: catalog, offers, seller profiles, prices in RUB, and reviews via 7 structured endpoints.
What is the Starvell API?
The Starvell API exposes 7 endpoints covering the full Russian-language game goods marketplace at starvell.com — from browsing the game catalog with list_games and searching it with search_games, to paginating offer listings with list_offers, fetching offer details via get_offer, and reading seller profiles and reviews. Each response returns structured fields including prices in RUB, seller ratings, KYC status, and attribute filters, without any manual site navigation.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/ab8a5cd8-8fbf-4c5f-8c27-05206d5db84b/list_games' \ -H 'X-API-Key: $PARSE_API_KEY'
Returns the full catalog of games and apps shown on the Starvell homepage, grouped into GAME, APP and MOBILE_GAME types, each with its URL slug and the slug of its first category. One request; no parameters; no pagination. Use game_slug together with a category_slug (from get_category.game.categories or search_games) to call list_offers.
No input parameters required.
{
"type": "object",
"fields": {
"games": "array of games; each has game_id (integer), name, game_slug, type (GAME|APP|MOBILE_GAME), is_new, first_category_slug, icon_url",
"total_by_type": "object mapping type -> total count of games of that type published by the site"
},
"sample": {
"data": {
"games": [
{
"name": "Roblox",
"type": "GAME",
"is_new": false,
"game_id": 1,
"icon_url": "https://cdn.starvell.com/game-icons/ebc5cfa7-a236-47b2-8dc1-f2c0799e0a23.png",
"game_slug": "roblox",
"first_category_slug": "packages"
},
{
"name": "Telegram",
"type": "APP",
"is_new": false,
"game_id": 14,
"icon_url": "https://cdn.starvell.com/game-icons/26039de2-9b81-4b37-b37a-58771a0fa50a.jpg",
"game_slug": "telegram",
"first_category_slug": "stars"
}
],
"total_by_type": {
"APP": 13,
"GAME": 13,
"MOBILE_GAME": 9
}
},
"status": "success"
}
}About the Starvell API
Game and Category Catalog
list_games returns every game and app on the Starvell homepage in a single request, grouped by type (GAME, APP, or MOBILE_GAME). Each entry includes game_slug, first_category_slug, and icon_url. To enumerate all categories under a game and inspect their filter options, pass game_slug and category_slug to get_category, which returns attribute filters (each with filter_id and option_id choices), numeric filters, service_fee_rate, and an offers_aggregate containing offers_count, low_price, and high_price in RUB. search_games accepts a keyword and returns matching games with their full categories[] arrays.
Browsing and Filtering Offers
list_offers paginates offers within a category using offset and limit (up to 150 per page). The attribute_filters parameter accepts comma-separated filter_id:option_id pairs sourced from get_category, letting you narrow results by server, region, or other game-specific attributes. Setting only_online to true restricts results to sellers currently online. Each offer in the response includes offer_id (UUID), price, availability, badges, a completion_rate, and a seller summary with username, rating, reviews_count, and kyc_status. The has_more flag signals whether additional pages exist.
Offer Detail and Seller Data
get_offer takes an offer_id UUID and returns the full offer: images, brief_description, delivery time, all attributes, is_active, offer_url, and the seller's review statistics within that specific category plus up to 20 recent reviews. get_seller_profile fetches a seller by username and returns their rating, reviews_count, review_stats (with rating_distribution), reviews_by_category, and all active offers grouped by game category. list_seller_reviews paginates a seller's reviews by seller_id (UUID), returning each review's rating, content, created_at, is_anonymous flag, and author object, plus aggregate review_stats.
The Starvell API is a managed, monitored endpoint for starvell.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when starvell.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 starvell.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 RUB price floors and ceilings for game currency across categories using
offers_aggregate.low_priceandhigh_pricefromget_category. - Build a seller reputation dashboard using
rating,reviews_count,kyc_status, andrating_distributionfromget_seller_profile. - Monitor new offer listings in a specific game category by polling
list_offerswithattribute_filtersscoped to a server or region. - Aggregate review sentiment per game category using
reviews_by_categorycounts fromget_seller_profileand full review text fromlist_seller_reviews. - Discover which games have the most active offer supply by comparing
offers_countacross categories returned byget_category. - Identify online sellers with verified KYC status in a category by filtering
list_offerswithonly_onlineand checkingkyc_statuson each offer's seller summary. - Index the full Starvell game catalog with type classifications (GAME, APP, MOBILE_GAME) using
list_gamesandtotal_by_type.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Starvell have an official developer API?+
What does `get_offer` return that `list_offers` does not?+
list_offers returns a summary per offer including price, availability, badges, and a seller summary. get_offer adds the full seller description, delivery time, offer images, the seller's per-category review statistics, and up to 20 recent reviews for that seller within the offer's category.How do attribute filters work in `list_offers`?+
get_category with the target game_slug and category_slug to retrieve filters[], each containing a filter_id and an array of option objects with option_id. Then pass one or more filter_id:option_id pairs as a comma-separated string to the attribute_filters parameter of list_offers. The filters_applied field in the response confirms which filters were sent.Are completed or historical orders and transaction prices exposed?+
What are the pagination limits for `list_offers` and `list_seller_reviews`?+
list_offers accepts a limit up to 150 offers per page; passing a higher value will be rejected. list_seller_reviews caps at 30 reviews per page, matching the site's own display limit. In both cases, increment offset by limit and check the has_more flag to determine whether another page exists.