# UN Security Council Sanctions Scraper | Sanctions List (`parseforge/unsc-sanctions-scraper`) Actor Extract UN Security Council Consolidated Sanctions List entries with name, aliases, nationality, date of birth, designation date, and committee. Filter by list or country. Built for compliance teams, KYC platforms, and sanctions screening across global finance. - **URL**: https://apify.com/parseforge/unsc-sanctions-scraper.md - **Developed by:** [ParseForge](https://apify.com/parseforge) (community) - **Categories:** Other, News - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $19.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. 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 ![ParseForge Banner](https://github.com/ParseForge/apify-assets/blob/ad35ccc13ddd068b9d6cba33f323962e39aed5b2/banner.jpg?raw=true) ## ๐Ÿ›ก๏ธ UN Security Council Sanctions List Scraper > ๐Ÿš€ **Export the UN Consolidated Sanctions List in seconds.** Pull every listed individual and entity into CSV, Excel, JSON, or XML. > ๐Ÿ•’ **Last updated:** 2026-05-25 ยท **๐Ÿ“Š 10 fields** per record ยท **all UN sanctions regimes** ยท **official UN XML source** The UN Security Council Consolidated Sanctions List is the master register of individuals and entities subject to sanctions imposed by the Security Council under all its sanctions regimes. This Actor reads the official UN XML feed and turns each record into a clean tabular row. Coverage includes every active regime (ISIL/Al-Qaida, Taliban, DPRK, Iran-historic, Libya, Somalia, DRC, CAR, Yemen, Mali, South Sudan, and others), with both individuals and entities supported. Filter by entity type and by specific sanctions regime code. | ๐ŸŽฏ Target Audience | ๐Ÿ’ก Primary Use Cases | |---|---| | Compliance officers, KYC and AML teams, sanctions screening engineers, risk analysts, journalists, NGOs | Build sanctions screening lists, monitor regime updates, populate KYC pipelines, support investigative reporting | ### ๐Ÿ“‹ What the UNSC Sanctions Scraper does - Pulls every individual and entity from the UN Consolidated List - Optional filter by sanctions regime (DRC, IRQ, LIB, ISIL, SOM, ...) - Optional filter for individuals only or entities only - Exports clean tabular data to CSV, Excel, JSON, or XML - No account or token required > ๐Ÿ’ก **Why it matters:** Sanctions data underpins KYC, AML, and trade compliance. This Actor delivers the official UN list in minutes. ### ๐ŸŽฌ Full Demo (_๐Ÿšง Coming soon_) ### โš™๏ธ Input
FieldTypeRequiredDescription
entityTypeselectNoboth, individuals, or entities. Default both.
listTypestringNoOptional regime code (e.g. DRC, IRQ, LIB, ISIL, SOM)
maxItemsintegerNoMax records to return. Free plan capped at 10.
```json { "entityType": "both", "maxItems": 10 } ```` ```json { "entityType": "individuals", "listType": "ISIL", "maxItems": 100 } ``` > โš ๏ธ **Good to Know:** This Actor reflects the live UN XML feed. Records can change as the Security Council adds, modifies, or removes designations. ### ๐Ÿ“Š Output | Field | Type | Description | |---|---|---| | ๐Ÿ‘ค `name` | string | Full name (individuals) or entity name | | ๐Ÿท๏ธ `type` | string | Individual or Entity | | ๐Ÿ†” `dataId` | string | UN DataID | | ๐Ÿ”ข `referenceNumber` | string | UN reference number | | ๐Ÿ“œ `listType` | string | Sanctions regime code | | ๐Ÿ“… `listedOn` | string | First listing date | | ๐Ÿ”„ `lastUpdated` | string | Last update date | | ๐ŸŒ `nationality` | string | Nationality (individuals) | | ๐Ÿ“ `comments` | string | Designation comments | | ๐Ÿ•’ `scrapedAt` | string | Run timestamp | | โŒ `error` | string | Null on success | Sample record: ```json { "name": "MOHAMMED OMAR GHULAM RABBANI", "type": "Individual", "dataId": "6908721", "referenceNumber": "TAi.155", "listType": "TAi", "listedOn": "2001-01-25", "lastUpdated": "2013-09-27", "nationality": "Afghanistan", "comments": "Member of the Taliban Supreme Council...", "scrapedAt": "2026-05-25T17:46:02.873Z", "error": null } ``` ### โœจ Why choose this Actor | ๐Ÿ”ฅ Reason | Why it matters | |---|---| | ๐Ÿ†“ No account or token | Run immediately | | ๐ŸŒ Official UN XML source | Authoritative, audit-friendly | | ๐Ÿ›ก๏ธ Full regime coverage | ISIL/Al-Qaida, Taliban, DPRK, Libya, DRC, Somalia, ... | | โšก Tabular output | Drops straight into compliance tooling | | ๐Ÿ” Schedule daily | Catch designation changes | ### ๐Ÿ“ˆ How it compares to alternatives | Approach | Setup | Cost | Output Quality | |---|---|---|---| | Parse UN XML yourself | Heavy plumbing | Free | Inconsistent | | Commercial sanctions vendors | Contracts | Expensive | Excellent | | **This Actor** | **None** | **Pay-per-use** | **Clean tabular** | ### ๐Ÿš€ How to use 1. [Create a free Apify account with $5 credit](https://console.apify.com/sign-up?fpr=vmoqkp) 2. Open the UNSC Sanctions Scraper 3. Pick entity type and optional regime code 4. Set `maxItems` 5. Click Start and download CSV, Excel, JSON, or XML ### ๐Ÿ’ผ Business use cases #### KYC and AML screening Refresh your blocked-party list daily and feed it into your screening engine. #### Trade compliance Surface added or modified designations for shipping, banking, and procurement teams. #### Risk and investigations Use the official UN reference numbers to cross-link with other watchlists. #### Investigative journalism Track regime additions and identify new actors named by the Security Council. ### ๐Ÿ”Œ Automating UNSC Sanctions Scraper Pipe results into Make, Zapier, n8n, Slack, Airbyte, GitHub Actions, or Google Drive via Apify integrations. ### ๐ŸŒŸ Beyond business use cases #### Research Study sanctions trends and regime activity across decades. #### Personal Stay aware of designations relevant to your travel or business interests. #### Non-profit Power transparency and human-rights dashboards. #### Experimentation Train entity-resolution and watchlist-matching models. ### ๐Ÿค– Ask an AI assistant about this scraper Open this Actor's page in [ChatGPT](https://chat.openai.com/), [Claude](https://claude.ai/), [Perplexity](https://www.perplexity.ai/), or [Copilot](https://copilot.microsoft.com/) and ask for help wiring it into your workflow. ### โ“ Frequently Asked Questions **Q: Do I need an account?** A: No. The UN XML feed is fully public. **Q: How often does the UN update the list?** A: Frequently. Many regimes change multiple times per month. **Q: Can I filter by regime?** A: Yes. Use the `listType` parameter. **Q: Can I get individuals only or entities only?** A: Yes. Use `entityType`. **Q: How many records are on the list?** A: The official list contains thousands of designations across all regimes. **Q: Does this replace a commercial sanctions vendor?** A: It covers the UN list specifically. Many compliance teams combine it with OFAC, EU, UK, and other regimes. **Q: Can I schedule daily?** A: Yes. Use Apify Schedules. **Q: Can I export to Excel?** A: Yes. Apify exports CSV, Excel, JSON, XML. **Q: Is this affiliated with the UN?** A: No. This is an independent tool. **Q: Will it break if the XML schema changes?** A: We monitor and update. ### ๐Ÿ”Œ Integrate with any app Apify supports Make, Zapier, n8n, Slack, Airbyte, GitHub Actions, Google Sheets, Google Drive, AWS, Azure, BigQuery, Snowflake, and any webhook-aware tool. ### ๐Ÿ”— Recommended Actors | Actor | What it does | |---|---| | [UK Courts and Tribunals](https://apify.com/parseforge/uk-courts-tribunals-scraper) | UK senior court and tribunal judgments | | [FINRA BrokerCheck](https://apify.com/parseforge/finra-brokercheck-scraper) | US securities-broker disclosures | | [WIPO Brand Database](https://apify.com/parseforge/wipo-brand-database-scraper) | Global trademark search | | [CourtListener Opinions](https://apify.com/parseforge/court-listener-opinions-scraper) | Free US federal court opinions | > ๐Ÿ’ก **Pro Tip:** browse the complete [ParseForge collection](https://apify.com/parseforge). **๐Ÿ†˜ Need Help?** [Open our contact form](https://tally.so/r/BzdKgA) > **โš ๏ธ Disclaimer:** This is an independent tool not affiliated with the United Nations. Only publicly available data published on the UN Consolidated Sanctions List is collected. # Actor input Schema ## `entityType` (type: `string`): Filter by individuals, entities, or both. ## `listType` (type: `string`): Optional filter by UN sanctions regime code (e.g. DRC, IRQ, LIB, ISIL, SOM). ## `maxItems` (type: `integer`): Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000 ## Actor input object example ```json { "entityType": "both", "maxItems": 10 } ``` # 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 = { "maxItems": 10 }; // Run the Actor and wait for it to finish const run = await client.actor("parseforge/unsc-sanctions-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 = { "maxItems": 10 } # Run the Actor and wait for it to finish run = client.actor("parseforge/unsc-sanctions-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 '{ "maxItems": 10 }' | apify call parseforge/unsc-sanctions-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=parseforge/unsc-sanctions-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "UN Security Council Sanctions Scraper | Sanctions List", "description": "Extract UN Security Council Consolidated Sanctions List entries with name, aliases, nationality, date of birth, designation date, and committee. Filter by list or country. Built for compliance teams, KYC platforms, and sanctions screening across global finance.", "version": "0.1", "x-build-id": "MBOPXRQGoBkrtY7Dq" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~unsc-sanctions-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-unsc-sanctions-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/parseforge~unsc-sanctions-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-unsc-sanctions-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/parseforge~unsc-sanctions-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-unsc-sanctions-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": { "entityType": { "title": "Entity Type", "enum": [ "both", "individuals", "entities" ], "type": "string", "description": "Filter by individuals, entities, or both.", "default": "both" }, "listType": { "title": "Sanctions Regime (optional)", "type": "string", "description": "Optional filter by UN sanctions regime code (e.g. DRC, IRQ, LIB, ISIL, SOM)." }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000" } } }, "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 } } } } } } } } } } ```