Skip to content

Amex (American Express)
CompanyTypes Amex
Engine Browser (Pipeline)
Credentials id, card6Digits, password
OTP —
Phase chain INIT → HOME → PRE-LOGIN → LOGIN → BIND-API-MEDIATOR → API-DIRECT-SCRAPE → TERMINATE
Source Banks/Amex/AmexPipeline.ts

Quick example

import { CompanyTypes, createScraper } from '@sergienko4/israeli-bank-scrapers';

const scraper = createScraper({
  companyId: CompanyTypes.Amex,
  startDate: new Date('2024-01-01'),
});

const result = await scraper.scrape({
  id: '123456789',
  card6Digits: '123456',
  password: 'mypassword',
});

Known quirks

  • Two-screen login — the PRE-LOGIN phase clicks "המשך עם סיסמה" (continue with password) before the password field becomes visible.
  • Per-card response shape — data.cardsList[].cardChargeNext.billingSumSekel. The hard-model card-cycle path extracts this per-card via the last4Digits field match.
  • Amex + Isracard share a sequential test group (scripts/run-real-suite.ts WORKER_GROUPS) — Amex must finish before Isracard logs in on the same customer-side session.

Hard-model post-auth

After login, Amex uses the hard-model post-auth path (withBrowserApiDirect): instead of the generic AUTH-DISCOVERY / ACCOUNT-RESOLVE / DASHBOARD / SCRAPE / BALANCE-RESOLVE chain, the AMEX_SHAPE IApiDirectScrapeShape (Banks/Amex/scrape/AmexShape.ts) declares the exact card-list and transactions API calls, issued directly through the live login page; balance is card-cycle, so there is no separate balance call. See api-direct-scrape for the phase contract.