TRAVEL
Hotel Loyalty Promo Tracker (Accor, Marriott, IHG)
Track current hotel loyalty promotions from ALL Accor, Marriott Bonvoy and IHG One Rewards: title, bonus points, nights or discount, region, registration, book-by and stay-by dates, terms…
About this data
Track current hotel loyalty promotions from ALL Accor, Marriott Bonvoy and IHG One Rewards: title, bonus points, nights or discount, region, registration, book-by and stay-by dates, terms and offer links, with the date each promo was first seen.
From the actor’s Apify Store listing. The per-call endpoint may return a bounded subset; its own description is below.
Buy per call over x402
One endpoint at api.ssh.autos. Each call is one JSON POST, paid in USDC with no account or API key, and answered in the same HTTP response.
Marriott Bonvoy Promotions
POST /v1/travel/hotel-promotions
Read up to 20 current Marriott Bonvoy featured offers from one results page after the public page bootstrap.
Returns offer names, summaries, codes, categories, offer and terms links, terms text, stay-by dates and published member or registration flags.
Participating hotels and bonus details are included where present.
No offer-detail pages, full-catalogue crawl or persistent first-seen tracking.
Input
Send a JSON body to POST https://api.ssh.autos/v1/travel/hotel-promotions.
| Field | Type | Required | Notes |
|---|---|---|---|
maxResults | integer | optional | 1–20; default 10 |
Returned fields
The answer is JSON: records, a list of up to 20, and summary, the run status and counts. Each record has these 28 fields; a field the source does not publish comes back null.
28 fields per record
| Field | Type | Notes |
|---|---|---|
promoKey | string | Unique key: program:promoId, e.g. 'marriott:OFF-253878'. One row per promotion; stable across runs. |
program | string | Program slug: accor, marriott or ihg. one of accor, marriott, ihg |
programName | string | Program name: 'ALL - Accor Live Limitless', 'Marriott Bonvoy' or 'IHG One Rewards'. |
promoId | string | The program's id for the promotion: Marriott offer id (OFF-…), Accor offer path, IHG page path. |
offerCode | string | Reference or rate code printed with the offer (Accor offer reference, Marriott offer id, IHG code), when there is one. |
summary | string | Short description of the offer (up to 600 characters). |
category | string | The program's own label: Marriott offer category (Bonus Points, PointSavers, Hotel Deal …), Accor badge (Member Exclusive, Family), IHG section (Member offer, Hotel offer, Special offer …). |
bonusType | string | Headline benefit when it can be read from the copy: points (bonus points or a points multiplier), nights (free nights), discount (percent off) or credit (money to spend at the hotel). Empty when the… one of points, nights, discount, credit |
bonusAmount | number | Size of the benefit in bonusUnit, e.g. 2500 points, 4 (x4 multiplier), 15 (percent), 1 (night), 25 (USD credit). |
bonusUnit | string | Unit of bonusAmount: points, multiplier, percent, nights or a currency code (USD, EUR, GBP). |
memberExclusive | boolean | True when the offer is only for loyalty members. |
registrationRequired | boolean | True when members must register or activate the offer before the stay. |
regions | array of strings | Regions the offer applies to: from the program's regional offer pages (Accor) or the places the copy names. Empty = worldwide or not stated. |
regionLabel | string | The program's own region name, e.g. 'Europe & North Africa' (Accor). |
brand | string | Hotel brand of the offer page (IHG), e.g. 'Kimpton'. |
hotelName | string | The participating hotel when the offer is valid at a single hotel (Marriott). |
participatingHotels | integer | Number of participating hotels (Marriott). |
bookBy | string | Last booking date, YYYY-MM-DD, when published. |
stayFrom | string | First stay date, YYYY-MM-DD, when published. |
stayBy | string | Last stay date, YYYY-MM-DD, when published. |
isExpired | boolean | True when bookBy or stayBy is before the run date (only returned with includeExpired). |
offerUrl | string | Offer page link. |
termsUrl | string | Link to the offer's terms: a terms document when the program publishes one, otherwise the offer page that prints them. |
terms | string | Terms and conditions text (up to 4,000 characters), when published. |
firstSeenAt | string | Date (YYYY-MM-DD) this promotion was first returned by a run that used the same first-seen store; the run date when tracking is off. |
isNew | boolean | True when this run saw the promotion for the first time (tracking on); empty when tracking is off. |
source | string | Website the row was read from: all.accor.com, marriott.com or ihg.com. |
scrapedAt | string | When the row was collected (ISO 8601, UTC). |
Example call
npx agentcash@latest fetch https://api.ssh.autos/v1/travel/hotel-promotions -m POST -b '{"maxResults": 5}'The example values come from the API spec or the actor’s own sample input. Running it is a paid call.
What is and isn’t charged
You pay the call price for
- An answer, including a definitive “not found” or an empty result.
- Confirmed no matches returns records: [] (charged: it is an answer).
Free
- Invalid input (422), busy (503), source failure (502), timeout (504) and calls whose client hung up are never charged.
- Invalid input and source failures are not charged.
Prefer a subscription? Run it on Apify
This data source is a public actor on the Apify Store: Hotel Loyalty Promo Tracker (Accor, Marriott, IHG). Run it with your Apify account and plan for larger, scheduled or exported runs; it may offer more input options than the per-call endpoint.
How x402 payment works
- Your client sends the request. The API answers
402 Payment Requiredwith the price and where to pay. - The client pays from its own wallet: USDC on Base or Solana over x402, or over MPP on Tempo. No account, sign-up or API key.
- The client retries with the payment attached and gets the JSON answer in the same call. You are only charged for answers.
The AgentCash CLI in the example does all three steps for you and pays from your AgentCash wallet. Any x402 or MPP client works the same way.
Machine-readable: openapi.json · llms.txt