# OFAC Sanctions List Crawler - SDN & Consolidated Lists (`jungle_synthesizer/ofac-sanctions-crawler`) Actor Extract sanctioned entities from the US Treasury OFAC SDN and Consolidated Sanctions lists. Get names, aliases, addresses, ID documents, sanctions programs, and vessel data. Filter by entity type, program, country, or name. Built for KYC/AML compliance and sanctions screening. - **URL**: https://apify.com/jungle\_synthesizer/ofac-sanctions-crawler.md - **Developed by:** [BowTiedRaccoon](https://apify.com/jungle_synthesizer) (community) - **Categories:** Business, Other - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per event This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## 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 ## OFAC Sanctions List Crawler - SDN & Consolidated Lists Extract sanctioned entity data from the US Treasury OFAC SDN and Consolidated Sanctions lists. Get names, aliases, addresses, ID documents, sanctions programs, vessel data, and biographical details for individuals, entities, vessels, and aircraft on OFAC's sanctions lists. ### What does OFAC Sanctions List Crawler do? The OFAC Sanctions List Crawler downloads and parses the official XML sanctions lists published by the [Office of Foreign Assets Control (OFAC)](https://ofac.treasury.gov/), part of the US Department of the Treasury. It extracts structured data from three list types: the SDN (Specially Designated Nationals) list with ~18,700 entities, the Consolidated Sanctions List, and the Consolidated Advanced list with ~35,000+ entries. Filter results by entity type, sanctions program, country, or name to get exactly the records you need for KYC/AML compliance screening. ### OFAC Sanctions Crawler Features - **Downloads official OFAC XML lists** directly from the Treasury sanctions list service -- SDN, Consolidated, and Consolidated Advanced - **Extracts 17 structured fields** per entity including aliases, addresses, ID documents, sanctions programs, nationality, citizenship, and vessel data - **Filters by entity type** -- Individual, Entity/Organization, Vessel, or Aircraft - **Filters by sanctions program** -- IRAN, SDGT, UKRAINE-EO13662, CYBER2, and all other OFAC programs - **Filters by country** -- matches against addresses, nationality, and citizenship fields - **Searches by name** -- case-insensitive matching against primary names and all aliases (AKA, FKA, DBA) - **No proxy required** -- OFAC is a public government data service with no authentication or rate limits - **Fast execution** -- downloads and parses the full SDN list (~28 MB XML) in under 30 seconds ### OFAC Sanctions Crawler Output Fields | Field | Type | Description | |-------|------|-------------| | `uid` | string | OFAC unique identifier for this entity | | `entity_type` | string | Entity type: Individual, Entity, Vessel, or Aircraft | | `full_name` | string | Full name or entity name | | `first_name` | string | First name (individuals only) | | `last_name` | string | Last name or entity name | | `programs` | array | Sanctions programs (e.g., IRAN, SDGT, UKRAINE-EO13662) | | `title` | string | Title or position | | `remarks` | string | Additional remarks and notes from OFAC | | `nationality` | string | Nationality country or countries | | `citizenship` | string | Citizenship country or countries | | `date_of_birth` | string | Date of birth | | `place_of_birth` | string | Place of birth | | `aliases` | array | Alternative names (AKA, FKA, DBA) as formatted strings | | `addresses` | array | Known addresses as formatted strings | | `id_numbers` | array | ID documents (passport, national ID, tax ID) as formatted strings | | `vessel_info` | string | Vessel details (type, flag, call sign, owner, tonnage) for vessel entities | | `list_date` | string | Publication date of the sanctions list | ### Who Uses OFAC Sanctions Data? - **Compliance officers**: Screen customers, vendors, and business partners against the SDN list as part of KYC (Know Your Customer) and AML (Anti-Money Laundering) programs - **Financial institutions**: Automate sanctions screening for onboarding, transaction monitoring, and periodic re-screening of existing accounts - **Legal teams**: Research sanctioned entities, their aliases, and associated addresses for due diligence and regulatory filings - **Government contractors**: Verify subcontractors and suppliers are not on OFAC sanctions lists before awarding contracts - **Data analysts**: Monitor sanctions list changes over time, analyze entity networks, and build compliance dashboards ### How to Use the OFAC Sanctions Crawler #### Input Parameters | Parameter | Required | Default | Description | |-----------|----------|---------|-------------| | `listType` | No | `SDN` | Which list to download: SDN, Consolidated, or Consolidated Advanced | | `entityType` | No | All | Filter by entity type: Individual, Entity, Vessel, or Aircraft | | `program` | No | All | Filter by sanctions program code (e.g., IRAN, SDGT, CYBER2) | | `country` | No | All | Filter by country in addresses, nationality, or citizenship | | `searchName` | No | All | Case-insensitive name search across primary names and aliases | | `maxItems` | No | `100` | Maximum entities to return. Set to 0 for all results | #### Example Configurations **Get all Iranian sanctions entries (first 100):** ```json { "listType": "SDN", "program": "IRAN", "maxItems": 100 } ```` **Search for a specific name across the SDN list:** ```json { "listType": "SDN", "searchName": "Viktor Bout", "maxItems": 50 } ``` **Get all sanctioned vessels:** ```json { "listType": "SDN", "entityType": "Vessel", "maxItems": 100 } ``` ### Sample Output ```json { "uid": "7909", "entity_type": "Individual", "full_name": "John DOE", "first_name": "John", "last_name": "DOE", "programs": ["SDGT", "IRAN"], "title": "Director", "remarks": "DOB 15 Jan 1965; nationality Iran", "nationality": "Iran", "citizenship": "Iran", "date_of_birth": "15 Jan 1965", "place_of_birth": "Tehran, Iran", "aliases": ["a.k.a.: J. DOE", "f.k.a.: John D."], "addresses": ["123 Main St, Tehran, Iran"], "id_numbers": ["Passport A12345678 (Iran) issued 2019-01-01 expires 2029-01-01"], "vessel_info": null, "list_date": "04/05/2026" } ``` ### OFAC Sanctions Data FAQ **How do I extract sanctions data from the OFAC SDN list?** Use the OFAC Sanctions List Crawler to download and parse the official OFAC XML files. Select the SDN list (default), apply any filters you need (entity type, program, country, name), and the crawler returns structured JSON records with all entity details, aliases, addresses, and ID documents. **What OFAC sanctions lists are available?** Three lists are available: the SDN (Specially Designated Nationals) list with ~18,700 entities, the Consolidated Sanctions List with primary fields, and the Consolidated Advanced list with ~35,000+ entries and additional fields. All three are published by the US Treasury Office of Foreign Assets Control. **How often is the OFAC SDN list updated?** OFAC updates its sanctions lists as new designations are issued, typically weekly to bi-weekly. The crawler downloads the latest published version on each run. **Does this crawler require proxies or authentication?** No. OFAC sanctions data is published by the US government as a public service. No authentication, API keys, or proxies are required. **How long does a typical run take?** The full SDN list (~28 MB XML, ~18,700 entities) downloads and parses in under 30 seconds. Filtered queries return faster since parsing stops after hitting the maxItems limit. **What entity types are on the SDN list?** The SDN list contains four entity types: Individuals (people), Entities (companies and organizations), Vessels (ships), and Aircraft. Each type has different fields -- for example, vessel entities include vessel type, flag, call sign, and tonnage. ### Need a Custom Feature? If you need additional data fields, custom filtering logic, or integration with your compliance pipeline, file an issue or get in touch. # Actor input Schema ## `sp_intended_usage` (type: `string`): Please describe how you plan to use the data extracted by this crawler. ## `sp_improvement_suggestions` (type: `string`): Provide any feedback or suggestions for improvements. ## `sp_contact` (type: `string`): Provide your email address so we can get in touch with you. ## `listType` (type: `string`): Which OFAC sanctions list to download and parse. ## `entityType` (type: `string`): Filter results by entity type. Leave as 'All Types' for no filter. ## `program` (type: `string`): Filter by sanctions program code (e.g. IRAN, UKRAINE-EO13662, CYBER2, SDGT). Leave empty for all programs. ## `country` (type: `string`): Filter by country in addresses, nationality, or citizenship. Leave empty for all. ## `searchName` (type: `string`): Search by name (matches against primary name and aliases, case-insensitive). Leave empty for all. ## `maxItems` (type: `integer`): Maximum number of sanctioned entities to return. Set to 0 for all results. ## `proxyConfiguration` (type: `object`): Select proxies. OFAC is a government service and does not require proxies. ## Actor input object example ```json { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "listType": "SDN", "entityType": "", "program": "", "country": "", "searchName": "", "maxItems": 100, "proxyConfiguration": { "useApifyProxy": false } } ``` # Actor output Schema ## `results` (type: `string`): No description # 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 = { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "listType": "SDN", "entityType": "", "program": "", "country": "", "searchName": "", "maxItems": 100, "proxyConfiguration": { "useApifyProxy": false } }; // Run the Actor and wait for it to finish const run = await client.actor("jungle_synthesizer/ofac-sanctions-crawler").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 = { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "listType": "SDN", "entityType": "", "program": "", "country": "", "searchName": "", "maxItems": 100, "proxyConfiguration": { "useApifyProxy": False }, } # Run the Actor and wait for it to finish run = client.actor("jungle_synthesizer/ofac-sanctions-crawler").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 '{ "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "listType": "SDN", "entityType": "", "program": "", "country": "", "searchName": "", "maxItems": 100, "proxyConfiguration": { "useApifyProxy": false } }' | apify call jungle_synthesizer/ofac-sanctions-crawler --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=jungle_synthesizer/ofac-sanctions-crawler", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "OFAC Sanctions List Crawler - SDN & Consolidated Lists", "description": "Extract sanctioned entities from the US Treasury OFAC SDN and Consolidated Sanctions lists. Get names, aliases, addresses, ID documents, sanctions programs, and vessel data. Filter by entity type, program, country, or name. Built for KYC/AML compliance and sanctions screening.", "version": "1.0", "x-build-id": "HXIoo4JnDHR9ROvdo" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jungle_synthesizer~ofac-sanctions-crawler/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jungle_synthesizer-ofac-sanctions-crawler", "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/jungle_synthesizer~ofac-sanctions-crawler/runs": { "post": { "operationId": "runs-sync-jungle_synthesizer-ofac-sanctions-crawler", "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/jungle_synthesizer~ofac-sanctions-crawler/run-sync": { "post": { "operationId": "run-sync-jungle_synthesizer-ofac-sanctions-crawler", "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": { "sp_intended_usage": { "title": "What is the intended usage of this data?", "minLength": 1, "type": "string", "description": "Please describe how you plan to use the data extracted by this crawler." }, "sp_improvement_suggestions": { "title": "How can we improve this crawler for you?", "minLength": 1, "type": "string", "description": "Provide any feedback or suggestions for improvements." }, "sp_contact": { "title": "Contact Email", "minLength": 1, "type": "string", "description": "Provide your email address so we can get in touch with you." }, "listType": { "title": "Sanctions List", "enum": [ "SDN", "CONS_PRIM", "CONS_ADVANCED" ], "type": "string", "description": "Which OFAC sanctions list to download and parse.", "default": "SDN" }, "entityType": { "title": "Entity Type Filter", "enum": [ "", "Individual", "Entity", "Vessel", "Aircraft" ], "type": "string", "description": "Filter results by entity type. Leave as 'All Types' for no filter.", "default": "" }, "program": { "title": "Sanctions Program", "type": "string", "description": "Filter by sanctions program code (e.g. IRAN, UKRAINE-EO13662, CYBER2, SDGT). Leave empty for all programs.", "default": "" }, "country": { "title": "Country", "type": "string", "description": "Filter by country in addresses, nationality, or citizenship. Leave empty for all.", "default": "" }, "searchName": { "title": "Name Search", "type": "string", "description": "Search by name (matches against primary name and aliases, case-insensitive). Leave empty for all.", "default": "" }, "maxItems": { "title": "Max Items", "type": "integer", "description": "Maximum number of sanctioned entities to return. Set to 0 for all results.", "default": 100 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Select proxies. OFAC is a government service and does not require proxies.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } } ```