{ "openapi": "3.0.1", "info": { "title": "Public Person Finder", "description": "Research any public figure instantly. Enter a name and get a fully cited intelligence report aggregating Wikipedia, sanctions lists, social media, news archives, and business registries.", "version": "0.0", "x-build-id": "WAZCSs2ClED1hJkdC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tri_angle~public-person-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tri_angle-public-person-finder", "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/tri_angle~public-person-finder/runs": { "post": { "operationId": "runs-sync-tri_angle-public-person-finder", "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/tri_angle~public-person-finder/run-sync": { "post": { "operationId": "run-sync-tri_angle-public-person-finder", "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": [ "name", "anthropicApiKey" ], "properties": { "name": { "title": "Person to research", "type": "string", "description": "The full name, social handle, or pseudonym of the person you want to research. Use the most widely known version of their name for best results - e.g. Elon Musk, Barack Obama, @cristiano." }, "prompt": { "title": "Research focus (optional)", "type": "string", "description": "What do you want to know about this person? Add a focus here to get a more targeted report. For example: \"business interests and investments\", \"political career and controversies\", or \"recent news\". Leave empty for a general overview." }, "anthropicApiKey": { "title": "Anthropic API key", "type": "string", "description": "Your API key from Anthropic. The Actor uses Claude AI to plan the research and write the final report, so this key is required. Get yours at console.anthropic.com under API Keys. Each run makes two short AI calls - typical cost is a few cents." }, "anthropicModel": { "title": "AI model (advanced)", "type": "string", "description": "The Claude AI model used to write the report. The default (claude-sonnet-4-6) is a good balance of quality and cost. Leave this as-is unless you have a specific reason to change it.", "default": "claude-sonnet-4-6" }, "enabledPlugins": { "title": "Data sources", "uniqueItems": true, "type": "array", "description": "Choose which sources to search. Leave empty to use all standard sources. UK Companies House and SEC EDGAR are off by default - turn them on if the person has UK or US business connections.", "items": { "type": "string", "enum": [ "wikipedia", "opensanctions", "social-media-finder", "google-search", "rag-web-browser", "rss", "registry-uk", "registry-sec-edgar" ], "enumTitles": [ "Wikipedia - biography, background, and identity (free)", "OpenSanctions - global sanctions lists and political watchlists (free)", "Social Media Finder - profiles on Facebook, LinkedIn, Instagram, TikTok, YouTube, GitHub, and 7 more (Apify Actor)", "Google Search - top search results for this person (Apify Actor, paid)", "Web browser - reads the full content of top websites (Apify Actor, free)", "News feeds - recent articles from BBC, The Guardian, NYT, AP, Le Monde, and Al Jazeera (free)", "UK Companies House - British company directorships (free, opt-in)", "SEC EDGAR - US public company filings naming this person (free, opt-in)" ] } }, "rssFeeds": { "title": "Custom RSS feeds (advanced)", "type": "array", "description": "Replaces the default news feeds entirely. Any RSS or Atom feed URLs you enter here will be used instead of the built-in list - the defaults (BBC, The Guardian, NYT, AP, Le Monde, Al Jazeera) will not run. To keep the standard outlets and add your own, you must include their feed URLs here as well. Leave empty to use the default set. Example feed URLs: https://feeds.bbci.co.uk/news/rss.xml, https://rss.nytimes.com/services/xml/rss/nyt/HomePage.xml", "items": { "type": "string" } }, "proxyConfig": { "title": "Proxy settings", "type": "object", "description": "Proxy used when fetching from Wikipedia, OpenSanctions, registries, and news feeds. Apify Actors called as sub-Actors (e.g. Google Search) use their own proxy settings. The default (Apify Proxy) works for most users - only change this if you have a specific reason.", "default": { "useApifyProxy": true, "apifyProxyGroups": [] } } } }, "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 } } } } } } } } } }