Adverse Media Live Screening API

Here is a detailed API documentation, including a sample cURL command, parameter descriptions, response format, and key considerations.

📡 Adverse Media Live Search API (v3)

This API allows for real-time adverse media screening of individuals or entities. It is designed to assist compliance and risk professionals in identifying potential negative media mentions related to AML (Anti-Money Laundering), terrorism, fraud, and other risks.

📘 Endpoint (Preproduction)

POST https://api-preproduction.signzy.app/api/v3/ndd/adverse-media-live-search

📘 Endpoint (Production)

POST https://api.signzy.app/api/v3/ndd/adverse-media-live-search

🔐 Authorization

This API requires a Bearer token in the Authorization header.

Authorization: <your_api_token>

📥 Request

Headers

Header Name	Type	Required	Description
Authorization	string	✅	Bearer token for authentication
Content-Type	string	✅	Must be application/json

Body Parameters

{ "name": "Tahawwur Hussain Rana", "type": "individual" }

Field	Type	Required	Description
name	string	✅	Full name of the entity/person
type	string	✅	"individual" or "organization"

📤 Sample cURL

curl --location 'https://api-preproduction.signzy.app/api/v3/ndd/adverse-media-live-search' \ --header 'Authorization: <your_api_token>' \ --header 'Content-Type: application/json' \ --data '{ "name": "Tahawwur Hussain Rana", "type": "individual" }'

📥 Response

HTTP 200: Success

Returns a list of adverse media matches for the provided entity.

{ "result": [ { "Alias": "Tahawwur Hussain Rana", "AmlCategory": "Terror Financing", "Connected Entities": "Tahawwur Hussain Rana, National Investigation Agency", "Country": ["India"], "Date of Event": "01 May 2025", "Dob": null, "InputEntityName": "Tahawwur Hussain Rana", "InputType": "Individual", "Summary": "A Delhi court has permitted the National Investigation Agency...", "details": "Delhi court allows NIA to record Tahawwur Rana's voice...", "entities": [ { "name": "Tahawwur Hussain Rana", "type": "individual" }, { "name": "National Investigation Agency", "type": "organization" } ], "event_link": "https://www.indiatoday.in/...", "fuzzy_score": 100, "keywords": "terrorism, 26/11, NIA, investigation, court", "match_details": "Delhi court allows NIA to record Tahawwur Rana's voice...", "match_name": "Tahawwur Hussain Rana", "sentiment_status": "negative", "timestamp": "01 Oct 2023, GMT 10:00:00" }, ... ] }

🔑 Key Response Fields

Field	Type	Description
Alias	string	Alternative name or spelling of the entity
AmlCategory	string	AML risk category (e.g., Terror Financing, Fraud)
Connected Entities	string	Related entities mentioned in the media
Country	array	Country or countries referenced in the article
Date of Event	string (date)	Date of the adverse media event
Dob	string/null	Date of Birth if available
InputEntityName	string	The entity name as submitted in the request
InputType	string	Either "Individual" or "Organization"
Summary	string	Short summary of the article or event
details	string	Longer detail or excerpt from the article
entities	array	List of entities mentioned in the article
event_link	string	Direct link to the news article or source
fuzzy_score	integer	Matching confidence score (0–100)
keywords	string	Relevant keywords extracted from the article
match_details	string	Sentence or excerpt indicating match
match_name	string	Matched name found in the media
sentiment_status	string	Indicates tone: positive, neutral, or negative
timestamp	string	Article ingestion time with time zone

📊 Sentiment Analysis

Each result contains a sentiment_status that classifies the tone of the article:

negative: Indicates a potentially damaging context

neutral: No strong sentiment, factual mention

positive: Indicates favorable context (rare in adverse media)

Important: Results with negative sentiment should be prioritized during compliance reviews.

🌀 Notes

Fields may vary slightly depending on the article; use dynamic parsing where possible.

Events are deduplicated and sorted by timestamp.

High fuzzy_score (e.g., 100) indicates a strong match; lower scores should be reviewed manually.

The API supports multi-language sources but returns responses in English.

Be sure to store and monitor event_link and timestamp for audit logging and freshness tracking.

🧪 Use Cases

KYC/AML compliance checks during onboarding

Periodic re-screening of high-risk customers

Enhanced due diligence for politically exposed persons (PEPs)