Codashop APIcodashop.com ↗
Access Codashop's game credits catalog across 10+ countries. List products by country, search by keyword, and retrieve SKUs, pricing, and payment channels.
What is the Codashop API?
The Codashop API provides 3 endpoints to access Codashop's game top-up and credits catalog across multiple countries. Use list_products to browse all available titles by country, search_products to find games by keyword, or get_product_details to retrieve full SKU listings, prices, and payment channels for a specific product. Response fields include product names, thumbnail URLs, SKU amounts, stock status, and per-country payment options.
curl -X GET 'https://api.parse.bot/scraper/597d96b0-e557-4767-8550-b2d0ab574467/list_products?country=ng' \ -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 codashop-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.
from parse_apis.codashop_products_api import Codashop, Country, ProductNotFound
codashop = Codashop()
# Browse the Philippines catalog
ph_catalog = codashop.catalog(country=Country.PHILIPPINES)
# List all available products
for product in ph_catalog.list():
print(product.product_name, product.section, product.thumbnail_url)
# Search for a specific game
for result in ph_catalog.search(query="mobile legends"):
print(result.product_name, result.product_url, result.product_image)
# Get detailed product info with SKUs and pricing
page = ph_catalog.get_product(product_path="mobile-legends")
print(page.product.name, page.product.tagline)
print(page.total_skus)
for sku in page.skus:
print(sku.title, sku.price, sku.has_stock, sku.discount_percentage)
for category in page.sku_categories:
print(category.name, category.sort_order)
for channel in page.payment_channels:
print(channel.display_name, channel.min_price)
List all products available on Codashop for a given country. Returns products organized by sections (Popular, New, Web Store, etc.) with thumbnails and URLs. Product availability varies significantly by country — a product listed in one country may not exist in another.
| Param | Type | Description |
|---|---|---|
| country | string | Two-letter country code determining which regional catalog to query. |
{
"type": "object",
"fields": {
"locale": "string locale code derived from country (e.g., 'en-ng')",
"country": "string country code used for the request",
"products": "array of product objects with thumbnailUrl, productName, productUrl, sale, popularity, nofollow, section, sectionType, isExternal",
"total_products": "integer total number of unique products found"
},
"sample": {
"data": {
"locale": "en-ng",
"country": "ng",
"products": [
{
"sale": null,
"section": "POPULAR",
"nofollow": false,
"isExternal": false,
"popularity": 0,
"productUrl": "/en-ng/call-of-duty-mobile",
"productName": "Call of Duty: Mobile",
"sectionType": "feedProducts",
"thumbnailUrl": "https://cdn1.codashop.com/S/content/mobile/images/product-tiles/CODM_oct23-tile.png"
}
],
"total_products": 50
},
"status": "success"
}
}About the Codashop API
Product Catalog by Country
The list_products endpoint accepts a country parameter (e.g., ng, ph, id, my, th) and returns all game top-up products available in that country, organized into sections such as Popular, New, and Web Store. Each product object includes thumbnailUrl, productName, productUrl, sale, popularity, section, sectionType, and isExternal. Product availability varies significantly by country — a title available in Indonesia may not appear in Nigeria.
Search and Product Details
The search_products endpoint takes a query string (e.g., genshin, call of duty) and an optional country code. Results are scoped to that country's catalog and return productName, productUrl, productImage, imageAltText, and additionalSearchTerms. The get_product_details endpoint accepts a product_path slug (e.g., mobile-legends, genshin-impact) and a country code, returning the full skus array with fields like id, title, amount, price, strikethrough, hasStock, status, and tags, plus skuCategories and paymentChannels.
Payment Channels and SKU Categories
get_product_details also returns a paymentChannels array, where each entry carries id, displayName, tagline, imageUrl, status, and minPrice. This lets you present or filter payment options available to buyers in a given country. The skuCategories array groups SKUs by named tiers (with id, name, sortOrder, imageUrl), which is useful for building denomination selectors in purchase flows.
The Codashop API is a managed, monitored endpoint for codashop.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when codashop.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 codashop.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?+
- Build a cross-country game top-up price comparison tool using
get_product_detailsSKUpricefields across multiple country codes. - Populate a regional game credits storefront by listing all products per country with section groupings from
list_products. - Implement a game title search feature using
search_productswithqueryandcountryinputs to surface relevant top-up options. - Monitor stock availability for specific SKUs by checking
hasStockandstatusfields returned byget_product_details. - Display available payment methods for a product in a given country using the
paymentChannelsarray withdisplayNameandminPrice. - Track promotional pricing by comparing
priceandstrikethroughvalues in the SKU objects returned per product. - Catalog new and trending Codashop titles per region using the
sectionandsectionTypefields fromlist_products.
| 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 Codashop have an official public developer API?+
What does `get_product_details` return beyond pricing?+
product object (including tagline, shortDescription, metaDescription, thumbnailUrl, logoUrl, and countryCode), a skuCategories array for grouping denominations, and a paymentChannels array listing each available payment method with its displayName, status, and minPrice.How does country scope affect search results?+
search_products endpoint scopes results to the catalog of the specified country. A game available in the Philippines (ph) but not in Nigeria (ng) will appear in results for ph and not for ng. Always pass the appropriate country code to get relevant results for your target market.Does the API support retrieving purchase history or order status?+
Are all Codashop countries covered by the `list_products` endpoint?+
ng, ph, id, my, and th, covering several of Codashop's main markets. Not all countries Codashop operates in may be supported, and product availability varies per country. You can fork the API on Parse and revise it to add support for additional country codes.