DIdirectdigital
Exato - Consultas

Adverse media — company

Searches news published on the internet about a company and identifies which articles really refer to it and how serious they are. The optional context data (trade name, city and state, main activity, opening date, group companies) help tell similarly named companies apart.

Source: news published on the internet.

Returns: an executive summary, a risk assessment (score from 0 to 100, level, red flags, mitigating factors and whether manual review is recommended) and the negative articles that reached the minimum match, each with title, link, excerpt, outlet, date, summary, sentiment and the probability that it refers to the company.

Execution: synchronous; usually takes tens of seconds; no PDF.

Note:

  • Accepts only the numeric CNPJ format.
  • Code 1 also when nothing is found (Articles empty).
  • Code 2 when news was found but the relevance analysis could not be completed (match and sentiment scores come as 0).
  • Code 11 when the news search fails.
post/br/exato/adverse-media/company

Request

Query parameters

test_modeboolean

true returns simulated data, without querying the source. Queries that do not offer test mode return code 7.

lightweightboolean

Lightweight mode (internal use).

Request body application/x-www-form-urlencoded

cnpjstring

Company CNPJ, 14 digits, with or without mask; optional for foreign companies. E.g.: 11222333000181.

razao_socialstring required

Company legal name, at least 3 characters. It is the basis of the news search. E.g.: EMPRESA EXEMPLO LTDA.

max_articlesinteger

Maximum number of news articles found that go through the analysis, from 1 to 100. Default 20. It is not the number of articles returned: the result brings only the negative ones that reach the minimum match.

nome_fantasiastring

Company trade name; used in the search and in the analysis.

data_aberturastring date

Company opening date, in yyyy-MM-dd format. E.g.: 2010-03-15.

sociosstring[]

Company partners considered in the search.

estadostring

State (UF) of the company headquarters; together with cidade, refines the search. E.g.: SP.

cidadestring

City of the company headquarters; together with estado, refines the search.

atividade_principalstring

Main economic activity (description or CNAE); used in the analysis.

empresas_grupostring[]

Other companies of the same economic group; used in the search and in the analysis.

termos_adicionaisstring[]

Additional terms considered in the search.

Response

Success

ApiResultType'Success' | 'SuccessWithRemarks' | 'InvalidInput' | 'DataUnavailable' | 'NotFound' | 'InvalidParameters' | 'UnsupportedCombination' | 'RemoteUnavailable' | 'Timeout' | 'RetryLimitReached' | 'RemoteError' | 'InProgress' | 'InsufficientCredits' | 'ConcurrentLimitReached' | 'TransactionUnavailable' | 'AccessDenied' | 'TransactionCancelled' | 'Created' | 'Updated' | 'Deleted' | 'InternalError' | 'ValidationFailed' | 'Conflict' | 'ResourceLocked' | 'PendingApproval' | 'Approved' | 'Rejected' | 'Cancelled' | 'Paused' | 'Resumed'

New unified result type for queries and administrative operations. Replaces TransactionResultType with better semantics.

BalanceInBrlnumber double

Current balance in BRL.

BalanceInCreditsinteger

Current balance in credits.

DataSourceCategorystring

Data source category

Datestring date-time

Transaction date.

ElapsedTimeInMillisecondsinteger

Execution time (in milliseconds).

ExecutedDataSourceNamestring

Display name of the query type that actually ran.

ExecutedDataSourceTypeIdinteger

Id of the query type that actually ran (the one recorded on the transaction), which may differ from the requested type when the route is generic per state or when a master delegates to a sub-query.

HasOriginalFilesboolean

Indicates that the transaction carries original files from the source (the issued certificate, for example) for download at OriginalFilesUrl. False does not mean the URL does not exist: it is always built.

HasPdfboolean

Indicates that there is a PDF proof document for the result.

Messagestring

Message.

OriginalFilesUrlstring

URL to download the transaction's original files (when available).

OutdatedResultboolean

Indicates that the result is dated.

PdfUrlstring

URL to download the transaction's PDF proof document (when available).

ResultSubtypestring

Specific result subtype to provide additional context (e.g.: 'duplicate_name', 'invalid_cpf').

ResultTypeCodeinteger

Numeric result code (compatible with TransactionResultTypeCode but extensible).

TotalCostnumber double

Internal use only.

TotalCostInCreditsinteger

Total transaction cost in credits.

TransactionResultType'Success' | 'SuccessWithRemarks' | 'InvalidInputData' | 'UnavailableData' | 'EntityNotFound' | 'InvalidParameters' | 'ParametersNotSupported' | 'RemoteSystemUnavailable' | 'Timeout' | 'AttemptsLimitReached' | 'RemoteSystemError' | 'AsyncExecutionInProgress' | 'AwaitingExecution' | 'BirthDateRequired' | 'InsufficientBalance' | 'SimultaneousTransactionsLimitReached' | 'TransactionUnavailable' | 'AccessDenied' | 'TransactionCancelled' | 'InternalError'
<table class="transaction"><thead><tr><th>TransactionResultType Code</th><th>TransactionResultType</th><th>Final</th><th>Billable</th><th>Error</th></tr></thead><tbody><tr><td>1</td><td>Success</td><td>True</td><td>True</td><td>False</td></tr><tr><td>2</td><td>Partial success or success with remarks</td><td>True</td><td>True</td><td>False</td></tr><tr><td>3</td><td>Invalid input or document</td><td>True</td><td>False</td><td>True</td></tr><tr><td>4</td><td>Data not available</td><td>True (for the day)</td><td>False</td><td>False</td></tr><tr><td>5</td><td>Entity or document nonexistent/not found</td><td>True</td><td>True</td><td>False</td></tr><tr><td>6</td><td>Invalid input parameters</td><td>True</td><td>False</td><td>True</td></tr><tr><td>7</td><td>Unsupported parameter combination</td><td>True</td><td>False</td><td>True</td></tr><tr><td>8</td><td>Data source or remote system unavailable</td><td>False</td><td>False</td><td>True</td></tr><tr><td>9</td><td>Time limit exceeded</td><td>False</td><td>False</td><td>True</td></tr><tr><td>10</td><td>Attempts limit reached</td><td>False</td><td>False</td><td>True</td></tr><tr><td>11</td><td>Error in the data source or remote system</td><td>False</td><td>False</td><td>True</td></tr><tr><td>12</td><td>Transaction in progress</td><td>False</td><td>False</td><td>False</td></tr><tr><td>101</td><td>Insufficient credit balance, please contact us</td><td>False</td><td>False</td><td>True</td></tr><tr><td>102</td><td>Simultaneous transactions limit reached, please contact us</td><td>False</td><td>False</td><td>True</td></tr><tr><td>103</td><td>Transaction not available, please contact us</td><td>False</td><td>False</td><td>True</td></tr><tr><td>104</td><td>Invalid credentials or access denied, please contact us</td><td>False</td><td>False</td><td>True</td></tr><tr><td>105</td><td>Transaction cancelled, please contact us</td><td>False</td><td>False</td><td>True</td></tr><tr><td>255*</td><td>Unexpected internal error, please contact us</td><td>True (for the day)</td><td>False</td><td>True</td></tr><tr><td>* Query under maintenance, try again later or contact Exato to report the problem</td></tr></tbody></table>
TransactionResultTypeCodeinteger

Transaction result type code.

UniqueIdentifierstring

Unique transaction identifier. Store it for control and debugging.

Changes

No operation changes recorded.