# Fbi Wanted (`dromb/fbi-wanted`) Actor This actor provides access to the official FBI Wanted list - **URL**: https://apify.com/dromb/fbi-wanted.md - **Developed by:** [Dmitriy Gyrbu](https://apify.com/dromb) (community) - **Categories:** Automation, Developer tools, Other - **Stats:** 2 total users, 1 monthly users, 50.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.40 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. 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 ## FBI Wanted Scraper Extract structured public FBI wanted and fugitive records for OSINT, compliance research, watchlist monitoring, and investigative data workflows. ### 🌟 Value Proposition The FBI Wanted Scraper provides a high-fidelity, structured interface to the official FBI Wanted database. Instead of manually browsing posters, this tool allows you to programmatically retrieve fugitive data, filter by specific criteria, and integrate the results into your own security, compliance, or research pipelines. ### 🚀 Use Cases - **OSINT Research**: Collect data on specific fugitives or crime types for investigative reports. - **Watchlist Monitoring**: Maintain updated lists of wanted individuals for internal risk screening. - **Due Diligence & Compliance**: Enrich background checks with public fugitive data. - **Public Safety Research**: Analyze trends in wanted persons by race, sex, or field office. - **Investigative Data Enrichment**: Cross-reference UIDs and names with other public datasets. ### 🛠 How It Works #### Operations The actor supports four main operations: 1. **Search (`search`)** - The primary operation. - **Default**: Leave `query` empty to retrieve the most recent wanted records. - **Keyword Search**: Enter a name or keyword in the `query` field to find specific individuals. - **Filters**: Narrow results by `race`, `sex`, `hair`, `eyes`, `status`, or `field_offices`. - **Limit**: Control the number of records returned (default 5, max 50). 2. **Item Detail (`item`)** - Retrieve the full, normalized record for a single person using their `uid` or the API `path_id`. 3. **Search Filters (`search_filters`)** - Automatically retrieve the current list of all valid filter values (e.g., all active FBI field offices) to help you build accurate queries. 4. **Probe (`probe`)** - A fast connectivity check that returns the total number of records currently in the FBI database. #### Input Example (Search) ```json { "operation": "search", "query": "fraud", "limit": 10, "race": "white" } ```` #### Output Structure - **Dataset**: Contains one record per wanted person. - **KVS `OUTPUT`**: Contains search metadata (total matches, page, source URL). | Field | Description | |-------|-------------| | `uid` | Unique FBI identifier for the individual. | | `title` | Full name of the person. | | `description` | Summary of crimes and reason for being wanted. | | `subjects` | Classifications (e.g., "Seeking Information"). | | `field_offices` | Associated FBI field offices. | | `reward_text` | Reward amount and conditions. | | `warning_message` | Cautions for the public when encountering the subject. | | `url` | Link to the official FBI wanted poster. | | `modified` | Date the record was last updated. | ### ⚠️ Disclaimers - **Data Source**: This actor interfaces with the official public FBI API (`https://api.fbi.gov`). - **No Affiliation**: This is an independent tool and is NOT affiliated with, endorsed by, or official software of the Federal Bureau of Investigation (FBI) or any U.S. government agency. - **Not Legal Advice**: The data provided is for informational purposes and does not constitute legal advice or a formal background check. - **Ethics**: Users are responsible for the lawful and ethical use of the retrieved data. ### ⚙️ Technical Notes - **Default Run**: When run with default settings, the actor performs a search for the most recent wanted records with a limit of 5. - **Stability**: The actor handles API pagination and normalization to ensure a consistent output format. # Actor input Schema ## `operation` (type: `string`): Operation to perform ## `query` (type: `string`): Search text applied to title. Leave empty to retrieve recent wanted records. ## `page` (type: `integer`): Page number (1-based) ## `limit` (type: `integer`): Items per page (max 50) ## `uid` (type: `string`): FBI Wanted uid ## `path_id` (type: `string`): pathId value ## `race` (type: `string`): Race filter ## `sex` (type: `string`): Sex filter ## `hair` (type: `string`): Hair color filter ## `eyes` (type: `string`): Eye color filter ## `status` (type: `string`): Status filter ## `person_classification` (type: `string`): Person classification filter ## `poster_classification` (type: `string`): Poster classification filter ## `field_offices` (type: `array`): Field offices filter ## `age_min` (type: `integer`): Minimum age ## `age_max` (type: `integer`): Maximum age ## Actor input object example ```json { "operation": "search", "query": "", "page": 1, "limit": 5 } ``` # Actor output Schema ## `dataset` (type: `string`): List of FBI wanted records. ## `runSummary` (type: `string`): Summary of the run found in KVS OUTPUT. # 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 = {}; // Run the Actor and wait for it to finish const run = await client.actor("dromb/fbi-wanted").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 = {} # Run the Actor and wait for it to finish run = client.actor("dromb/fbi-wanted").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 '{}' | apify call dromb/fbi-wanted --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=dromb/fbi-wanted", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Fbi Wanted", "description": "This actor provides access to the official FBI Wanted list", "version": "0.35", "x-build-id": "xUE1NOzOgjr5suNsX" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dromb~fbi-wanted/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dromb-fbi-wanted", "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/dromb~fbi-wanted/runs": { "post": { "operationId": "runs-sync-dromb-fbi-wanted", "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/dromb~fbi-wanted/run-sync": { "post": { "operationId": "run-sync-dromb-fbi-wanted", "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", "required": [ "operation" ], "properties": { "operation": { "title": "Operation", "enum": [ "probe", "search_filters", "search", "item" ], "type": "string", "description": "Operation to perform", "default": "search" }, "query": { "title": "Query", "type": "string", "description": "Search text applied to title. Leave empty to retrieve recent wanted records.", "default": "" }, "page": { "title": "Page", "type": "integer", "description": "Page number (1-based)", "default": 1 }, "limit": { "title": "Limit", "maximum": 50, "type": "integer", "description": "Items per page (max 50)", "default": 5 }, "uid": { "title": "UID", "type": "string", "description": "FBI Wanted uid" }, "path_id": { "title": "Path ID", "type": "string", "description": "pathId value" }, "race": { "title": "Race", "type": "string", "description": "Race filter" }, "sex": { "title": "Sex", "type": "string", "description": "Sex filter" }, "hair": { "title": "Hair", "type": "string", "description": "Hair color filter" }, "eyes": { "title": "Eyes", "type": "string", "description": "Eye color filter" }, "status": { "title": "Status", "type": "string", "description": "Status filter" }, "person_classification": { "title": "Person Classification", "type": "string", "description": "Person classification filter" }, "poster_classification": { "title": "Poster Classification", "type": "string", "description": "Poster classification filter" }, "field_offices": { "title": "Field Offices", "type": "array", "description": "Field offices filter", "items": { "type": "string" } }, "age_min": { "title": "Age Min", "minimum": 0, "maximum": 120, "type": "integer", "description": "Minimum age" }, "age_max": { "title": "Age Max", "maximum": 120, "type": "integer", "description": "Maximum age" } } }, "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 } } } } } } } } } } ```