Com APImoneyhero.com.hk ↗
Access Hong Kong credit card data from MoneyHero.com.hk — cashback rates, miles rewards, annual fees, income requirements, APR, and welcome offers via 3 endpoints.
What is the Com API?
The MoneyHero HK API covers Hong Kong credit cards across 3 endpoints, returning card names, cashback rates, miles rewards, annual fees, income requirements, interest rates, and welcome offer values in Traditional Chinese. The get_card_details endpoint delivers fee breakdowns, APR, Octopus auto-reload limits, and raw attributes for a specific card identified by its slug. search_credit_cards filters results by category including cashback, miles, dining, and travel.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/9f40f95b-71b0-4eab-903c-9bd5bdfa309c/list_credit_cards' \ -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 moneyhero-com-hk-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.
"""Walkthrough: MoneyHero HK Credit Card API — browse, filter, and drill into card details."""
from parse_apis.moneyhero_hong_kong_credit_card_api import MoneyHero, Category, CardNotFound
client = MoneyHero()
# List all available credit cards (single page); print first few summaries.
for card in client.creditcardsummaries.list(limit=3):
print(card.name, card.annual_fee, card.welcome_offer_value)
# Filter by category using the Category enum — e.g. cashback cards only.
cashback_card = client.creditcardsummaries.search(category=Category.CASHBACK, limit=1).first()
if cashback_card:
print(cashback_card.name, cashback_card.card_benefits, cashback_card.min_annual_income)
# Drill into full details from a summary via the .details() navigation op.
if cashback_card:
detail = cashback_card.details()
print(detail.name, detail.slug)
if detail.cashback:
print(detail.cashback.dining_cashback, detail.cashback.overseas_cashback)
if detail.fees:
print(detail.fees.annual_fee, detail.fees.foreign_currency_fee)
# Direct point-lookup by slug when you already know the card identifier.
try:
citi = client.creditcards.get(slug="citi-cash-back-card")
print(citi.name, citi.welcome_offer)
if citi.interest_rates:
print(citi.interest_rates.retail_apr, citi.interest_rates.interest_free_period)
except CardNotFound as exc:
print(f"Card not found: {exc.slug}")
print("exercised: creditcardsummaries.list / creditcardsummaries.search / summary.details / creditcards.get")
List all credit cards available on MoneyHero HK with basic comparison data. Returns card names, exclusive offers, welcome offer values, card benefits, minimum annual income requirements, annual fees, and slugs for detail lookups. The full catalog is returned in a single page.
No input parameters required.
{
"type": "object",
"fields": {
"cards": "array of card summary objects with name, image_url, exclusive_offer, welcome_offer_value, card_benefits, min_annual_income, annual_fee, detail_slug, detail_url",
"total": "integer - total number of cards returned"
}
}About the Com API
What the API Covers
The API exposes credit card comparison data sourced from MoneyHero.com.hk, a Hong Kong financial comparison platform. All text fields are in Traditional Chinese, reflecting the Hong Kong market. The three endpoints together cover the full browse-and-detail flow: listing all cards, filtering by category, and retrieving per-card details.
Endpoints and Key Fields
list_credit_cards returns an array of card objects alongside a total count. Each object includes name, image_url, exclusive_offer, welcome_offer_value, card_benefits, min_annual_income, and annual_fee. No input parameters are required — it returns the full card catalogue in a single call.
search_credit_cards accepts an optional category parameter. Accepted values include cashback, miles, dining, travel, best-deals, and all. The response mirrors the list structure but scoped to that category, and the returned category field confirms which filter was applied.
get_card_details takes a slug string (e.g. citi-cash-back-card) and returns the most granular data: a fees object covering annual_fee, annual_fee_waiver, foreign_currency_fee, minimum_payment, and late_payment_charge; a cashback object with separate rates for dining, overseas, local, local online shopping, and overseas online shopping; an octopus object with max_auto_reload; and arrays for features and highlights. The url field links to the canonical card detail page on MoneyHero.
Data Scope and Language
All card data reflects Hong Kong-issued cards and is presented in Traditional Chinese. Income requirements (min_annual_income) are in HKD. Slugs needed for get_card_details can be obtained from list_credit_cards or search_credit_cards response objects.
The Com API is a managed, monitored endpoint for moneyhero.com.hk — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when moneyhero.com.hk 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 moneyhero.com.hk 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 Hong Kong credit card comparison tool filtered by cashback, miles, or dining category using
search_credit_cards - Surface minimum annual income requirements to pre-qualify users before recommending specific cards
- Display APR and fee breakdowns from
get_card_detailsfor transparency in a personal finance app - Aggregate welcome offer values across all cards with
list_credit_cardsto rank promotions - Show Octopus card auto-reload limits for transit-focused card recommendations
- Compare foreign currency transaction fees across cards for users who travel frequently
- Populate a card detail page with highlights, features, and cashback tiers pulled from a single
get_card_detailscall
| 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 MoneyHero.com.hk have an official developer API?+
What does `get_card_details` return that `list_credit_cards` does not?+
get_card_details adds granular fields absent from the listing endpoints: the full fees object (annual fee waiver, foreign currency fee, late payment charge, minimum payment), itemised cashback rates by spend category (dining, overseas, local online), the octopus object with max auto-reload value, and features and highlights arrays. The listing endpoints return only summary fields sufficient for a comparison grid.Are miles reward rates included in the card data?+
get_card_details endpoint returns miles-related data within raw attributes and highlights where the card supports miles rewards. Dedicated structured fields for miles earn rates per dollar spent are not broken out as discrete named fields in the current response schema. You can fork this API on Parse and revise it to add a structured miles object alongside the existing cashback object.Does the API cover personal loan or mortgage products from MoneyHero?+
How do I find the correct slug to pass to `get_card_details`?+
list_credit_cards or search_credit_cards first. Each card object in the response includes a slug field (e.g. dbs-black-world-mastercard) that can be passed directly as the slug parameter to get_card_details.