Yes. The Free tier is 600 requests a month at 100 requests a minute, across every endpoint in the catalogue, with no credit card. Nothing about it expires.

What happens when I hit the quota?

Requests return 429 with the limit, what you have used, and which window you tripped — nothing is queued, and nothing is charged. The monthly quota resets on the 1st (UTC). There is no rollover: unused requests do not carry into the next month.

Do failed requests use up my quota?

A 5xx does not. If a source breaks on our side, the request is excluded from your monthly count. A 4xx does count — a wrong parameter is still a request we answered. Per-minute throttling counts everything, so a retry loop is still throttled.

Which tier do I need?

Start on Free. Every response carries the remaining quota in its headers, and the dashboard reads the same number enforcement uses, so you will see the ceiling coming rather than discovering it.

How is Zapi different from RapidAPI or Apify?

Zapi focuses on a consistent REST contract — one API key, one response format, one error pattern for every source. No need to learn per-provider quirks like on traditional marketplaces, and no need to set up scraping workflows like on Apify.

What about the legality of accessing public data?

Zapi only accesses data that is publicly available without a login. Responsibility for how it is ultimately used stays with the developer — make sure your use case complies with the original source's ToS and the regulations in your operating region.

Is there an official SDK?

One: zpi-sdk, for TypeScript and JavaScript. It carries a typed error hierarchy, retries only what is safe to retry, submits bulk jobs, and verifies webhook signatures. Everything else is plain REST — cURL or any HTTP client works.

Can I request a source that isn’t in the catalogue yet?

Yes, through the community Discord, on any tier.

HRTA Gold

Indonesian retail gold from Hartadinata Abadi — price and buyback per gramasi, plus the full EMASKU catalogue.

12 endpoints113 calls12/12 passing

Get API key

Price board

Price and buyback per gramasi, across every bar series.

GET/v1/finance:hrta-gold/price

passing · 0.3s30m cache

Parameters

Name	Type	In	Description
series	string	query	Keep only this series, case-insensitive. Omit for every series.
denomination	number	query	Keep only this bar weight in grams.

Example response

{"project":"finance:hrta-gold",  "data": {"asOf":"2026-08-29","count":20,    "items": [      {"setAt":"2026-08-29T11:40:30+07:00","series":"Gold","spread":79500,"buyPrice":318000,"isOrigin":true,"seriesId":1,"weightId":1,"weightGram":0.1,"buybackPrice":238500,"buyPricePerGram":3180000,"buybackPricePerGram":2385000      },      {"setAt":"2026-08-29T11:40:30+07:00","series":"Gold","spread":152250,"buyPrice":748500,"isOrigin":true,"seriesId":1,"weightId":2,"weightGram":0.25,"buybackPrice":596250,"buyPricePerGram":2994000,"buybackPricePerGram":2385000      },      {"setAt":"2026-08-29T11:40:30+07:00","series":"Gold","spread":120000,"buyPrice":1312500,"isOrigin":true,"seriesId":1,"weightId":3,"weightGram":0.5,"buybackPrice":1192500,"buyPricePerGram":2625000,"buybackPricePerGram":2385000      }    ],"metal":"gold","total":20,"series":null,"dataset":"price","currency":"IDR","provider":"hrta-gold","updatedAt":"2026-08-29T11:40:30+07:00","denomination":null,    "seriesAvailable": [      "Gold",      "Prime"    ],    "denominationsAvailable": [      0.1,      0.25,      0.5    ]  },"timestamp":"2026-08-29T09:08:38Z"}

Errors

401Missing or invalid x-api-key
404Not found or private
429Rate limit or monthly quota reached

Series

Bar and jewellery collections, each tied to a brand.

GET/v1/finance:hrta-gold/series

passing · 0.1s1h cache

Parameters

Name	Type	In	Description
brand	string	query	Keep only series of this brand, case-insensitive.

Example response

{"project":"finance:hrta-gold",  "data": {"count":12,    "items": [      {"name":"Anabul Custom","brand":"EMASKU","image":"https://hrtagold.id/api/v1/assets/collections/collections_EJeVZGgkrj.webp","active":true,"brandId":1,"isOrigin":true,"seriesId":18      },      {"name":"Anabul","brand":"EMASKU","image":"https://hrtagold.id/api/v1/assets/collections/collection_rlKfkcPCnE.webp","active":true,"brandId":1,"isOrigin":true,"seriesId":11      },      {"name":"BSI Gold","brand":"EMASKU","image":null,"active":true,"brandId":1,"isOrigin":false,"seriesId":8      },      {"name":"Moment","brand":"EMASKU","image":"https://hrtagold.id/api/v1/assets/collections/collection_eXVWJygNzD.webp","active":true,"brandId":1,"isOrigin":true,"seriesId":2      },      {"name":"Gold","brand":"EMASKU","image":"https://hrtagold.id/api/v1/assets/collections/collection_scWCtxLvVj.webp","active":true,"brandId":1,"isOrigin":true,"seriesId":1      },      {"name":"Prime","brand":"EMASKU","image":"https://hrtagold.id/api/v1/assets/collections/collection_hDAynrFBMo.webp","active":true,"brandId":1,"isOrigin":true,"seriesId":4      },      {"name":"Ardore in Love","brand":"ARDORE","image":"https://hrtagold.id/api/v1/assets/collections/collections_mM6tEULFNz.webp","active":true,"brandId":2,"isOrigin":true,"seriesId":17      },      {"name":"Ardore Heritage","brand":"ARDORE","image":"https://hrtagold.id/api/v1/assets/collections/collections_qLxM2yRWI7.webp","active":true,"brandId":2,"isOrigin":true,"seriesId":16      }    ],"total":12,"dataset":"series","provider":"hrta-gold"  },"timestamp":"2026-08-29T09:08:38Z"}

Errors

401Missing or invalid x-api-key
404Not found or private
429Rate limit or monthly quota reached

Sub-series

Second level of the collection tree.

GET/v1/finance:hrta-gold/sub-series

passing · 0.1s1h cache

Parameters

Name	Type	In	Description
seriesId	number	query	Keep only sub-series of this series.
brand	string	query	Keep only sub-series of this brand, case-insensitive.

Example response

{"project":"finance:hrta-gold",  "data": {"count":34,    "items": [      {"name":"Cat","brand":"EMASKU","active":true,"brandId":1,"seriesId":18,"subSeriesId":47      },      {"name":"Dog","brand":"EMASKU","active":true,"brandId":1,"seriesId":18,"subSeriesId":48      },      {"name":"Dog","brand":"EMASKU","active":true,"brandId":1,"seriesId":11,"subSeriesId":35      },      {"name":"Cat","brand":"EMASKU","active":true,"brandId":1,"seriesId":11,"subSeriesId":34      },      {"name":"Christmas","brand":"EMASKU","active":true,"brandId":1,"seriesId":2,"subSeriesId":10      },      {"name":"Amanah","brand":"EMASKU","active":true,"brandId":1,"seriesId":2,"subSeriesId":11      },      {"name":"Wedding Samawa","brand":"EMASKU","active":true,"brandId":1,"seriesId":2,"subSeriesId":14      },      {"name":"Wedding International","brand":"EMASKU","active":true,"brandId":1,"seriesId":2,"subSeriesId":13      }    ],"total":34,"dataset":"sub-series","provider":"hrta-gold"  },"timestamp":"2026-08-29T09:08:38Z"}

Errors

401Missing or invalid x-api-key
404Not found or private
429Rate limit or monthly quota reached

Brands

Brands the mint sells under.

GET/v1/finance:hrta-gold/brands

passing · 0.1s1h cache

Parameters

Name	Type	In	Description
x	string	query	Unused — the brand list takes no parameters.

Example response

{"project":"finance:hrta-gold",  "data": {"count":2,    "items": [      {"name":"EMASKU","brandId":1      },      {"name":"ARDORE","brandId":2      }    ],"total":2,"dataset":"brands","provider":"hrta-gold"  },"timestamp":"2026-08-29T09:08:38Z"}

Errors

401Missing or invalid x-api-key
404Not found or private
429Rate limit or monthly quota reached

Name	Type	In	Description
x	string	query	Unused — the category list takes no parameters.

Sub-categories

Second level of the product tree, with its parent category.

GET/v1/finance:hrta-gold/sub-categories

passing · 0.1s1h cache

Parameters

Name	Type	In	Description
categoryId	number	query	Keep only sub-categories of this category.

Example response

{"project":"finance:hrta-gold",  "data": {"count":17,    "items": [      {"name":"Anting Giwang","category":"Earrings","categoryId":2,"subCategoryId":8      },      {"name":"Anting Cuff","category":"Earrings","categoryId":2,"subCategoryId":7      },      {"name":"Anting","category":"Earrings","categoryId":2,"subCategoryId":6      },      {"name":"Klip","category":"Brooch","categoryId":3,"subCategoryId":17      },      {"name":"Pin","category":"Brooch","categoryId":3,"subCategoryId":16      },      {"name":"Cincin Pria","category":"Ring","categoryId":4,"subCategoryId":14      },      {"name":"Cincin Kawin","category":"Ring","categoryId":4,"subCategoryId":13      },      {"name":"Cincin Fashion","category":"Ring","categoryId":4,"subCategoryId":12      }    ],"total":17,"dataset":"sub-categories","provider":"hrta-gold"  },"timestamp":"2026-08-29T09:08:38Z"}

Errors

401Missing or invalid x-api-key
404Not found or private
429Rate limit or monthly quota reached

Carats

Purity grades paired with the carat label each is sold under.

GET/v1/finance:hrta-gold/carats

passing · 0.1s1h cache

Parameters

Name	Type	In	Description
x	string	query	Unused — the carat list takes no parameters.

Example response

{"project":"finance:hrta-gold",  "data": {"count":7,    "items": [      {"carat":"6K","grade":"300"      },      {"carat":"8K","grade":"375"      },      {"carat":"17K","grade":"750"      },      {"carat":"24K","grade":"99.9"      },      {"carat":"16K","grade":"700"      },      {"carat":"18K","grade":"791"      },      {"carat":"9K","grade":"416"      }    ],"total":7,"dataset":"carats","provider":"hrta-gold"  },"timestamp":"2026-08-29T09:08:38Z"}

Errors

401Missing or invalid x-api-key
404Not found or private
429Rate limit or monthly quota reached

Colours

Gold colours offered across the jewellery lines.

GET/v1/finance:hrta-gold/colors

passing · 0.1s1h cache

Parameters

Name	Type	In	Description
x	string	query	Unused — the colour list takes no parameters.

Example response

{"project":"finance:hrta-gold",  "data": {"count":2,    "items": [      {"name":"Kuning"      },      {"name":"Putih"      }    ],"total":2,"dataset":"colors","provider":"hrta-gold"  },"timestamp":"2026-08-29T09:08:38Z"}

Errors

401Missing or invalid x-api-key
404Not found or private
429Rate limit or monthly quota reached

Weights

Every bar weight the mint recognises.

GET/v1/finance:hrta-gold/weights

passing · 0.1s1h cache

Parameters

Name	Type	In	Description
activeOnly	enum	query	Keep only weights the mint still lists. Default false. One of true, false.

Example response

{"project":"finance:hrta-gold",  "data": {"count":19,    "items": [      {"active":true,"weightId":1,"weightGram":0.1      },      {"active":true,"weightId":19,"weightGram":0.2      },      {"active":true,"weightId":2,"weightGram":0.25      },      {"active":true,"weightId":3,"weightGram":0.5      },      {"active":true,"weightId":4,"weightGram":1      },      {"active":true,"weightId":5,"weightGram":2      },      {"active":false,"weightId":18,"weightGram":3      },      {"active":true,"weightId":6,"weightGram":5      }    ],"total":19,"dataset":"weights","provider":"hrta-gold"  },"timestamp":"2026-08-29T09:08:38Z"}

Errors

401Missing or invalid x-api-key
404Not found or private
429Rate limit or monthly quota reached

Weight groups

How bar weights are banded for the shop filters.

GET/v1/finance:hrta-gold/weight-groups

passing · 0.1s1h cache

Parameters

Name	Type	In	Description
x	string	query	Unused — the weight group list takes no parameters.

Example response

{"project":"finance:hrta-gold",  "data": {"count":3,    "items": [      {"name":"MICRO GOLDBAR","range":"Range (0.10 gr - 0.25 gr)","active":true,"groupId":1,        "weights": [          {"weightId":1,"weightGram":0.1          },          {"weightId":19,"weightGram":0.2          },          {"weightId":2,"weightGram":0.25          }        ],"weightCount":3      },      {"name":"SMALL GOLDBAR","range":"Range (0.50 gr - 100.00 gr)","active":true,"groupId":2,        "weights": [          {"weightId":3,"weightGram":0.5          },          {"weightId":4,"weightGram":1          },          {"weightId":5,"weightGram":2          },          {"weightId":6,"weightGram":5          },          {"weightId":7,"weightGram":10          },          {"weightId":8,"weightGram":25          },          {"weightId":9,"weightGram":50          },          {"weightId":10,"weightGram":100          }        ],"weightCount":8      },      {"name":"GOLDBAR","range":"Range (125.00 gr - 1000.00 gr)","active":true,"groupId":3,        "weights": [          {"weightId":11,"weightGram":125          },          {"weightId":12,"weightGram":150          },          {"weightId":16,"weightGram":175          },          {"weightId":15,"weightGram":200          },          {"weightId":17,"weightGram":250          },          {"weightId":13,"weightGram":500          },          {"weightId":14,"weightGram":1000          }        ],"weightCount":7      }    ],"total":3,"dataset":"weight-groups","provider":"hrta-gold"  },"timestamp":"2026-08-29T09:08:38Z"}

Errors

401Missing or invalid x-api-key
404Not found or private
429Rate limit or monthly quota reached

Products

Full catalogue with live price, business price, stock and series tree.

GET/v1/finance:hrta-gold/products

passing · 0.2s30m cache

Parameters

Name	Type	In	Description
page	number	query	Page of products. Default 1.
limit	number	query	Products per page. Default 12, max 100 — the upstream's own ceiling.

Example response

{"project":"finance:hrta-gold",  "data": {"page":1,"count":24,    "items": [      {"sku":"GBMLK-26G001/01-99","name":"EMASKU GOLD SERIES 5 GR","uuid":"3babb0a1-3972-5eb1-359c-a71bce4059fe","brand":"EMASKU","grade":"999.9","price":12385000,"stock":214,"active":true,        "images": [          "https://hrtagold.id/api/v1/assets/products/product_pEYCzk943t_image_1.webp"        ],"series":"Gold","brandId":1,"category":"Gold Bar","itemCode":"86821260006-1","preorder":false,"seriesId":1,"weightId":6,"isPopular":false,"productId":323,"signature":false,"subSeries":"Royale","viewCount":75367,"bestSeller":false,"isBusiness":true,"isDiscount":false,"newArrival":false,        "thumbnails": [          "https://hrtagold.id/api/v1/assets/products/product_pEYCzk943t_thumbnail_1.webp"        ],"weightGram":5,"description":"<div>- Harga akan selalu di update mengikuti harga emas dunia setiap harinya.</div><div>- Emas batangan EMASKU yang sudah dibeli dapat dijual kembali (buyback) ke seluruh jaringan …","subCategory":"Mini Gold Bar","subSeriesId":1,"businessPrice":11945000,"discountPrice":12385000,"discountPercent":0,"isRecommendation":true      }    ],"total":285,"dataset":"products","hasMore":true,"currency":"IDR","nextPage":2,"provider":"hrta-gold","pageCount":12  },"timestamp":"2026-08-29T09:08:38Z"}

Errors

401Missing or invalid x-api-key
404Not found or private
429Rate limit or monthly quota reached

Promotions

Promotions running on the storefront, with the discount band each advertises.

GET/v1/finance:hrta-gold/banners

passing · 0.1s1h cache

Parameters

Name	Type	In	Description
type	string	query	Keep only banners of this type, case-insensitive.

Example response

{"project":"finance:hrta-gold",  "data": {"count":5,    "items": [      {"url":"https://hrtagold.id/en/promotion/promo-bundling-emasku-kemerdekaan","type":"promotion","title":"PROMO BUNDLING","active":true,"sequence":84,"description":"Promo Khusus EMASKU Kemerdekaan","imageMobile":"https://hrtagold.id/api/v1/assets/banners/banner_LeEZQj1BbC_mobile.webp","imageTablet":"https://hrtagold.id/api/v1/assets/banners/banner_aNCjYesZIv_tablet.webp","isPromotion":true,"promotionId":83,"imageDesktop":"https://hrtagold.id/api/v1/assets/banners/banner_r6ZSKfegdR_desktop.webp","discountRange":null      },      {"url":"https://hrtagold.id/en/promotion/promo-potongan-emasku","type":"promotion","title":"PROMO POTONGAN EMASKU","active":true,"sequence":85,"description":null,"imageMobile":"https://hrtagold.id/api/v1/assets/banners/banner_eRG5V9UxPu_mobile.webp","imageTablet":"https://hrtagold.id/api/v1/assets/banners/banner_pXVHMziOet_tablet.webp","isPromotion":true,"promotionId":81,"imageDesktop":"https://hrtagold.id/api/v1/assets/banners/banner_PuL2xEQkwB_desktop.webp","discountRange":"1%"      },      {"url":"https://hrtagold.id/en/promotion/gratis-ongkir-ke-seluruh-indonesia","type":"promotion","title":"GRATIS ONGKIR KE SELURUH INDONESIA","active":true,"sequence":86,"description":"Hanya Berlaku di Aplikasi HRTA Gold","imageMobile":"https://hrtagold.id/api/v1/assets/banners/banner_tRQBkO8sgS_mobile.webp","imageTablet":"https://hrtagold.id/api/v1/assets/banners/banner_81IHpQq7LC_tablet.webp","isPromotion":true,"promotionId":82,"imageDesktop":"https://hrtagold.id/api/v1/assets/banners/banner_AzD1h0pVvx_desktop.webp","discountRange":"1%"      }    ],"total":5,"dataset":"banners","provider":"hrta-gold"  },"timestamp":"2026-08-29T09:08:38Z"}

Errors

401Missing or invalid x-api-key
404Not found or private
429Rate limit or monthly quota reached

Try it

Live request with your key

const data = await client.run(  "finance:hrta-gold",  "price",  { series: "Gold", denomination: 1 });

HRTA Gold

Indonesian retail gold from Hartadinata Abadi — price and buyback per gramasi, plus the full EMASKU catalogue.

12 endpoints113 calls12/12 passing

Get API key

Price and buyback per gramasi, across every bar series.

GET/v1/…hrta-gold/price

passing · 0.3s30m cache

Try it

Parameters

series

string · query · optional

Keep only this series, case-insensitive. Omit for every series.

denomination

number · query · optional

Keep only this bar weight in grams.

Example response

{"project":"finance:hrta-gold",  "data": {"asOf":"2026-08-29","count":20,    "items": [      {"setAt":"2026-08-29T11:40:30+07:00","series":"Gold","spread":79500,"buyPrice":318000,"isOrigin":true,"seriesId":1,"weightId":1,"weightGram":0.1,"buybackPrice":238500,"buyPricePerGram":3180000,"buybackPricePerGram":2385000      },      {"setAt":"2026-08-29T11:40:30+07:00","series":"Gold","spread":152250,"buyPrice":748500,"isOrigin":true,"seriesId":1,"weightId":2,"weightGram":0.25,"buybackPrice":596250,"buyPricePerGram":2994000,"buybackPricePerGram":2385000      },      {"setAt":"2026-08-29T11:40:30+07:00","series":"Gold","spread":120000,"buyPrice":1312500,"isOrigin":true,"seriesId":1,"weightId":3,"weightGram":0.5,"buybackPrice":1192500,"buyPricePerGram":2625000,"buybackPricePerGram":2385000      }    ],"metal":"gold","total":20,"series":null,"dataset":"price","currency":"IDR","provider":"hrta-gold","updatedAt":"2026-08-29T11:40:30+07:00","denomination":null,    "seriesAvailable": [      "Gold",      "Prime"    ],    "denominationsAvailable": [      0.1,      0.25,      0.5    ]  },"timestamp":"2026-08-29T09:08:38Z"}

Errors

401Missing or invalid x-api-key
404Not found or private
429Rate limit or monthly quota reached

Code

const data = await client.run(  "finance:hrta-gold",  "price",  { series: "Gold", denomination: 1 });

HRTA Gold

Price board

Parameters

Example response

Errors

Series

Parameters

Example response

Errors

Sub-series

Parameters

Example response

Errors

Brands

Parameters

Example response

Errors

Categories

Parameters

Example response

Errors

Sub-categories

Parameters

Example response

Errors

Carats

Parameters

Example response

Errors

Colours

Parameters

Example response

Errors

Weights

Parameters

Example response

Errors

Weight groups

Parameters

Example response

Errors

Products

Parameters

Example response

Errors

Promotions

Parameters

Example response

Errors

Parameters

Example response

Errors

Code