Mexico's hottest promociones, from Promodescuentos, as clean JSON
The Promodescuentos API turns www.promodescuentos.com, the Spanish-language deal community of Mexico, into JSON in six actions.
6 active endpoints, on 1 and 3 credit tiers.
- POST/promodescuentos/v1/search
- POST/promodescuentos/v1/deals
- POST/promodescuentos/v1/category_deals
- POST/promodescuentos/v1/deal
- POST/promodescuentos/v1/comments
- POST/promodescuentos/v1/categories
What Promodescuentos endpoints does ReefAPI ship?
6 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.
Promodescuentos API
3 of 6 endpoints, ready to run
Find deals by keyword, hottest or newest first, with temperature and price filters.
// Press "Try it" and this pane shows exactly what the // live site returned this second — including an empty // result, if that is the truth. No key, no account.
How the Promodescuentos API works
Promodescuentos is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.
No OAuth app, no request signing, no per-site account. One key covers all 585 engines.
Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.
Credits, not seats. Failed and blocked calls are never charged, and cache hits cost nothing.
One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.
Track the hottest iphone deals on Promodescuentos
Three calls, from a keyword to the deal in full and what the community says about it.
iphone deals of the last year at 100° or more, hottest first.
The deal in full: price, comparison price, discount, merchant, voucher code and expiry.
The comments under it, most helpful first (95 on this deal when measured).
Which iphone offers the community rated highest, what they cost and whether they still work.
curl -X POST https://api.reefapi.com/promodescuentos/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"iphone","sort":"new"}'{
"ok": true,
"data": { … },
"meta": {
"api": "promodescuentos",
"endpoint": "search",
"mode": "live",
"latency_ms": …,
"record_count": …
},
"error": null
}What a Promodescuentos deal row carries
Every search, feed and category row carries the same fields; deal adds the description, all categories, images and the outbound link. Measured on www.promodescuentos.com on 2026-10-18.
| field | meaning | note |
|---|---|---|
| deal_id | The deal's id on Promodescuentos | pass it to deal and comments as it is |
| temperature | Community vote score in degrees | can be negative; sort=hot orders by it |
| price / next_best_price | Deal price and the comparison price the poster gave | MXN; null when not given |
| discount_pct | Computed from the two prices | the site's own percentage is source_discount_pct |
| voucher_code | The code to use at checkout | null when the deal has none |
| merchant / link_host | The shop and the domain the deal links to | |
| is_expired / expires_at | Expired flag and the end date the poster set | ISO 8601 UTC |
| comment_count | Comments under the deal | the comments action returns them |
In search and feed rows a deal without a price and a free deal both show price null with price_is_zero_or_missing true; the deal action tells them apart (price 0 and is_free true for a free deal).
What Promodescuentos publishes — measured 2026-10-18
Promodescuentos is Mexico's Pepper deal community. These are the numbers and limits measured on the live site.
'iphone' matched 890 deals of the last year; 30 per page, sortable by relevance, newest, hottest, price or latest comment.
Temperature, price (MXN), posting date, category, hide expired and hide in-store-only deals; each one checked against the unfiltered count.
Trending, new, hottest (99 deals in the current period) and discussions; new and trending report 10,000, a cap.
15 main categories with their community-favourite subcategories; category tecnologia listed 549 deals in its default view.
Price, printed price, comparison price, discount, merchant, voucher code, shipping, temperature, status, start and end date, categories, images and description.
Median 1562 ms for a search page and 1051 ms for a deal, measured over two runs.
Vote history, user profiles and alerts (login-only on the site). The hottest feed has no day/week/month switch.
What people build with Promodescuentos
The jobs this data is most often used for.
endpoints
credits per call
Deal alerts: poll deals list=new or a keyword search with sort=new and push matching deals to your users.
Price tracking: compare a product's deal price and comparison price across Promodescuentos posts over time.
Voucher code collection: gather the codes posted for a shop with search and read voucher_code.
Market research: measure which shops and categories get the hottest deals in Mexico by temperature.
What Promodescuentos data costs
The cheapest call here is 1 credit, so $15/mo (Pro) buys 10,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.
Full pricing →- 1,000 free credits on signup, no card
- One key, all 585 APIs, one credit pool
- Failed and blocked calls are never charged
- Credits roll over and never expire
Call it in two lines
Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.
curl -X POST https://api.reefapi.com/promodescuentos/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"iphone","sort":"new"}'import requests
r = requests.post(
"https://api.reefapi.com/promodescuentos/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "iphone",
"sort": "new"
},
)
print(r.json()["data"])Have a question? We got answers.
The questions people actually ask before wiring up Promodescuentos.
Get a free key →Do I need a Promodescuentos account?▾
No. This API reads the deals Promodescuentos publishes to every visitor, without login, and returns them as JSON with the same fields on every row. Vote history, user profiles and alerts stay out: they need a login on the site.
How do I get only hot deals?▾
Use min_temperature on search, for example min_temperature=100 (the 'iphone' search went from 890 to 658 deals), or sort=hot for the hottest first. The hottest feed in deals lists the hottest deals of the current period (99 when measured).
Can I filter by price and date?▾
Yes. min_price and max_price filter by the deal price in MXN (100 to 500 left 109 of 890 'iphone' deals), and time_frame limits the posting date to the last 7 or 30 days, the last year (the site's default) or all time.
How do I monitor new deals?▾
Call deals with list=new and read the newest posts first, 30 per page; deal_id is stable, so you can store the ids you have seen. Search with sort=new does the same for one keyword.
Do I get the voucher code and the shop?▾
Yes. Every row carries voucher_code (null when there is none), the merchant name and id, and link_host, the domain of the shop the deal points to. The deal action adds the outbound link.
How many results can I page through?▾
30 deals a page. meta.total, meta.last_page and meta.has_more come from the site's own counter. The new and trending feeds report 10,000 deals, which is a cap: meta.total_capped says so.
Which other Pepper sites are covered?▾
Each Pepper community has its own API on ReefAPI: mydealz (Germany), hotukdeals (UK), Dealabs (France), Chollometro (Spain), Pepper.pl (Poland), Preisjäger (Austria), Pepper.com NL (Netherlands) and Promodescuentos (Mexico), all with the same six actions and fields.
What is the Promodescuentos API?▾
Promodescuentos API is a ReefAPI endpoint group for promodescuentos deals from www.promodescuentos.com as json: search the community's promociones by keyword with temperature, price, date and category filters, read the trending, new and hottest feeds, and get every deal in full with price, old price, discount, voucher code, shipping and comments. It returns live JSON through POST requests under /promodescuentos/v1.
Is the Promodescuentos API free to try?▾
Yes. ReefAPI starts with 1,000 free credits, no card required. Promodescuentos calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Promodescuentos login or account?▾
No login to Promodescuentos is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Promodescuentos data?▾
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Promodescuentos API use?▾
Promodescuentos actions currently cost 1-3 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call Promodescuentos from an AI assistant or MCP client?▾
Yes. Connect ReefAPI once through MCP and your assistant can call promodescuentos actions with the same key, credit pool and JSON envelope used by normal REST requests.
Is the Promodescuentos API a Promodescuentos scraper?▾
It is the managed alternative to a DIY Promodescuentos scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same promodescuentos deals from www.promodescuentos.com as json: search the community's promociones by keyword with temperature, price, date and category filters, read the trending, new and hottest feeds, and get every deal in full with price, old price, discount, voucher code, shipping and comments back as clean JSON.
320 E-commerce & Marketplaces APIs on the same key
One key, one credit pool, one response envelope. If you are pulling Promodescuentos, you are one call away from the rest of the category — no second contract, no second integration.
Need something this API does not do?
Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.
Try it on your own data before you pay anything
The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 584 APIs, and the same envelope everywhere.
Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-10-18.