BIN Lookup Scraper

Look up public card issuer metadata for one to five 6–8 digit BIN/IIN prefixes using the Binlist v3 public endpoint. The Actor can return scheme, type, brand, prepaid status, issuer, country, currency, coordinates, and card-number metadata when the source provides them.

Data and billing semantics

Only source-backed lookup records with at least one BIN-specific metadata field enter the dataset. Every countable row has recordType: "bin-lookup", found: true, dataAvailable: true, an exact source URL, and a timestamp. Nulls, blanks, empty containers, non-finite values, duplicates, and unknown fields are rejected by the validator.

Not-found, rate-limit, HTTP, timeout, invalid-response, and invalid-input evidence is stored in the OUTPUT key only, so PAY_PER_EVENT result data does not include failed lookups. A run with zero countable records exits nonzero; a partial run succeeds with warnings and exact counts.

Public-source boundary

Binlist documents a free limit of five requests per hour with a burst allowance of five. Accordingly, this Actor:

• accepts at most five BIN/IIN values per run;
• performs serialized direct HTTPS requests with a fixed transparent Actor User-Agent;
• uses no proxy, browser, fingerprint modification, retry, login, key harvesting, or rate-limit bypass;
• redirects nowhere and caps each JSON response at 128 KiB.

Full primary account numbers are not required and are rejected. Supply only the first 6–8 BIN/IIN digits.

Input

{
  "bins": ["45717360"],
  "requestTimeoutSecs": 15
}

bins is required, unique after normalization, and limited to five strings containing exactly 6–8 digits. requestTimeoutSecs is optional and bounded from 5 to 30 seconds.

Local verification

npm ci --omit=dev --omit=optional --ignore-scripts
npm test
npm run lint
apify validate-schema
apify run --purge --input-file qa-inputs/local-validation.json
npm run validate

This Actor uses the public Binlist data as returned. BIN metadata can be incomplete or inaccurate and must not be treated as proof of identity, authorization, fraud, or card validity.