# Sanctions & Watchlist Screening Scraper: OFAC + UK (`scrapemint/sanctions-watchlist-scraper`) Actor Download and screen official government sanctions lists: OFAC SDN and Consolidated (US Treasury) and UK HMT. List mode returns filterable entities with aliases, addresses and sanction programs; screen mode checks your names against every list. Keyless, fresh each run, no API key. - **URL**: https://apify.com/scrapemint/sanctions-watchlist-scraper.md - **Developed by:** [Ken M](https://apify.com/scrapemint) (community) - **Categories:** Business - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Sanctions & Watchlist Screening Scraper: OFAC + UK Download and search the official government sanctions lists, or screen your own list of names against them, in one run. Built on keyless public downloads that refresh with every run, so you always work from the current list. ### Lists covered - **OFAC SDN** — US Treasury Specially Designated Nationals (the list nearly every company worldwide screens against). - **OFAC Consolidated** — additional US non-SDN sanctions. - **UK HMT** — the UK OFSI consolidated list. Each entity is normalized into one shape with its **aliases**, **addresses**, **nationalities** and **sanction programs/regimes**. ### Two modes **List** — return sanctioned entities, filtered by type (individual/entity/vessel/aircraft), program/regime (e.g. `RUSSIA`, `IRAN`, `SDGT`), country, or a name keyword. **Screen** — pass `screenNames` (people or companies you want to check); the actor returns one row per match, tagged `exact` or `partial`, showing which name/alias matched and the full sanctioned-entity record. ### Who it's for Fintechs, banks, crypto exchanges, payment firms and marketplaces that must screen customers and counterparties for AML/sanctions compliance; plus law firms, KYC vendors and due-diligence teams. ### Output List mode — one row per entity: `source`, `uid`, `name`, `type`, `programs`, `title`, `aliases`, `addresses`, `nationalities`, `remarks`, `sourceUrl`. Screen mode — one row per match: the above plus `query`, `matchType` (exact/partial), `matchedName`, `matchedField` (name/alias). ### Important This is a **public-data feed, not certified compliance software**. Matching is normalized exact/substring, not phonetic or fuzzy, and lists can lag official updates. Treat every hit as a **candidate to review**, not a determination, and keep your own compliance process and records. ### Pricing Pay per event: **$0.01 per record** (per entity in list mode, per match in screen mode). The first **2 rows per run are free**. ### Examples Screen names: ```json { "mode": "screen", "screenNames": ["Ismail Haniyeh", "Acme Trading LLC"] } ```` List all Russia-program individuals: ```json { "mode": "list", "program": "RUSSIA", "type": "individual", "maxRows": 500 } ``` # Actor input Schema ## `mode` (type: `string`): "List" returns sanctioned entities (with filters). "Screen" checks your own names against the lists and returns matches. ## `sources` (type: `array`): Which official lists to include. ## `screenNames` (type: `array`): One or more person or company names to check against the selected lists. Exact and partial (substring) matches are returned. ## `type` (type: `string`): Filter to one type. ## `program` (type: `string`): Filter by sanction program or regime, e.g. IRAN, RUSSIA, SDGT, CUBA. ## `country` (type: `string`): Filter by country in the entity's address or nationality. ## `keyword` (type: `string`): Case-insensitive match on the entity name or any alias. ## `maxRows` (type: `integer`): Cap on rows returned. Controls total cost. First 2 rows per run are free. ## Actor input object example ```json { "mode": "list", "sources": [ "ofac-sdn", "ofac-consolidated" ], "screenNames": [], "type": "", "program": "", "country": "", "keyword": "", "maxRows": 200 } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "mode": "list", "sources": [ "ofac-sdn", "ofac-consolidated" ] }; // Run the Actor and wait for it to finish const run = await client.actor("scrapemint/sanctions-watchlist-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "mode": "list", "sources": [ "ofac-sdn", "ofac-consolidated", ], } # Run the Actor and wait for it to finish run = client.actor("scrapemint/sanctions-watchlist-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "mode": "list", "sources": [ "ofac-sdn", "ofac-consolidated" ] }' | apify call scrapemint/sanctions-watchlist-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scrapemint/sanctions-watchlist-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Sanctions & Watchlist Screening Scraper: OFAC + UK", "description": "Download and screen official government sanctions lists: OFAC SDN and Consolidated (US Treasury) and UK HMT. List mode returns filterable entities with aliases, addresses and sanction programs; screen mode checks your names against every list. Keyless, fresh each run, no API key.", "version": "0.1", "x-build-id": "Q2CWb46PmfsYCIVkJ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapemint~sanctions-watchlist-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapemint-sanctions-watchlist-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/scrapemint~sanctions-watchlist-scraper/runs": { "post": { "operationId": "runs-sync-scrapemint-sanctions-watchlist-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/scrapemint~sanctions-watchlist-scraper/run-sync": { "post": { "operationId": "run-sync-scrapemint-sanctions-watchlist-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "mode": { "title": "Mode", "enum": [ "list", "screen" ], "type": "string", "description": "\"List\" returns sanctioned entities (with filters). \"Screen\" checks your own names against the lists and returns matches.", "default": "list" }, "sources": { "title": "Lists to load", "type": "array", "description": "Which official lists to include.", "items": { "type": "string", "enum": [ "ofac-sdn", "ofac-consolidated", "uk-hmt" ], "enumTitles": [ "OFAC SDN (US)", "OFAC Consolidated (US)", "UK HMT (OFSI)" ] }, "default": [ "ofac-sdn", "ofac-consolidated" ] }, "screenNames": { "title": "Names to screen (screen mode)", "type": "array", "description": "One or more person or company names to check against the selected lists. Exact and partial (substring) matches are returned.", "default": [], "items": { "type": "string" } }, "type": { "title": "Entity type (list mode)", "enum": [ "", "individual", "entity", "vessel", "aircraft" ], "type": "string", "description": "Filter to one type.", "default": "" }, "program": { "title": "Program / regime contains (list mode)", "type": "string", "description": "Filter by sanction program or regime, e.g. IRAN, RUSSIA, SDGT, CUBA.", "default": "" }, "country": { "title": "Country contains (list mode)", "type": "string", "description": "Filter by country in the entity's address or nationality.", "default": "" }, "keyword": { "title": "Name contains (list mode)", "type": "string", "description": "Case-insensitive match on the entity name or any alias.", "default": "" }, "maxRows": { "title": "Max rows per run", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Cap on rows returned. Controls total cost. First 2 rows per run are free.", "default": 200 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```