Brand Risk Protection (BRP)
Domains that imitate your brand. Suspicious domains are candidates for review; approved ones become fraudulent domains and are monitored.
- Base URL
https://api.deepinfo.com/v1
Settings
Brand Risk Protection settings.
| Method | Endpoint | Path |
|---|---|---|
| GET | Fraudulent Settings Detail/brp/fraudulent-settingsReturns the Brand Risk Protection settings: ignored_domains are never reported. | /brp/fraudulent-settings |
| PUT | Fraudulent Settings Update/brp/fraudulent-settingsReplaces the Brand Risk Protection settings. Send the full ignored_domains list. | /brp/fraudulent-settings |
Fraudulent Domains
Monitored fraudulent domains, their scans, history and risk score.
| Method | Endpoint | Path |
|---|---|---|
| POST | Fraudulent Domain Search/brp/fraudulent-domains/searchSearches your monitored fraudulent domains by name, type, risk score and indicators. | /brp/fraudulent-domains/search |
| POST | Fraudulent Domain Export/brp/fraudulent-domains/search:exportExports every record matching filters (no pagination). format=csv returns CSV text; format=json returns a JSON array. Large exports can time out: narrow them with filters. | /brp/fraudulent-domains/search:export |
| GET | Fraudulent Domain Detail/brp/fraudulent-domains/{fraudulent_id}Returns one fraudulent domain with its latest data and risk score. | /brp/fraudulent-domains/{fraudulent_id} |
| POST | Fraudulent Domain Delete/brp/fraudulent-domains/search:deleteStops monitoring every fraudulent domain matching filters. | /brp/fraudulent-domains/search:delete |
| POST | Fraudulent Domain Instant Scan/brp/fraudulent-domains/{fraudulent_id}/instant-scanStarts an on-demand scan of a fraudulent domain. | /brp/fraudulent-domains/{fraudulent_id}/instant-scan |
| GET | Fraudulent Domain DNS History/brp/fraudulent-domains/{fraudulent_id}/dns-historyReturns the DNS history recorded for a fraudulent domain. | /brp/fraudulent-domains/{fraudulent_id}/dns-history |
| GET | Fraudulent Domain Latest Scan/brp/fraudulent-domains/{fraudulent_id}/latest-scanReturns the latest scan of a fraudulent domain. | /brp/fraudulent-domains/{fraudulent_id}/latest-scan |
| GET | Fraudulent Domain Port Scan History/brp/fraudulent-domains/{fraudulent_id}/port-scan-historyReturns the port scan history recorded for a fraudulent domain. | /brp/fraudulent-domains/{fraudulent_id}/port-scan-history |
| GET | Fraudulent Domain SSL History/brp/fraudulent-domains/{fraudulent_id}/ssl-historyReturns the SSL certificate history recorded for a fraudulent domain. | /brp/fraudulent-domains/{fraudulent_id}/ssl-history |
| GET | Fraudulent Domain Webdata History/brp/fraudulent-domains/{fraudulent_id}/webdata-historyReturns the web data (page content, technologies, headers) history recorded for a fraudulent domain. | /brp/fraudulent-domains/{fraudulent_id}/webdata-history |
| GET | Fraudulent Domain WHOIS History/brp/fraudulent-domains/{fraudulent_id}/whois-historyReturns the WHOIS history recorded for a fraudulent domain. | /brp/fraudulent-domains/{fraudulent_id}/whois-history |
| POST | Fraudulent Domain Instant Snapshot/brp/fraudulent-domains/{fraudulent_id}/instant-snapshotRecalculates the fraudulent domain snapshot now. | /brp/fraudulent-domains/{fraudulent_id}/instant-snapshot |
| GET | Fraudulent Domain Latest Snapshot/brp/fraudulent-domains/{fraudulent_id}/latest-snapshotLatest summary of a fraudulent domain. | /brp/fraudulent-domains/{fraudulent_id}/latest-snapshot |
| GET | Fraudulent Domain Risk Score Timeline/brp/fraudulent-domains/{fraudulent_id}/risk-score-timelineTime series of a fraudulent domain's risk score. | /brp/fraudulent-domains/{fraudulent_id}/risk-score-timeline |
| GET | Fraudulent Domain Type Stats/brp/fraudulent-domains/stats/typeCounts fraudulent domains per type (domain, subdomain). | /brp/fraudulent-domains/stats/type |
Suspicious Domains
Candidates found by your fraudulent rules. Each is in_review, approved or ignored.
| Method | Endpoint | Path |
|---|---|---|
| POST | Suspicious Domain Search/brp/suspicious-domains/searchSearches suspicious domains (candidates found by your fraudulent rules) and their state. | /brp/suspicious-domains/search |
| POST | Suspicious Domain Export/brp/suspicious-domains/search:exportExports every record matching filters (no pagination). format=csv returns CSV text; format=json returns a JSON array. Large exports can time out: narrow them with filters. | /brp/suspicious-domains/search:export |
| GET | Suspicious Domain Detail/brp/suspicious-domains/{detected_fraudulent_id}Returns one suspicious domain with the rule that detected it. | /brp/suspicious-domains/{detected_fraudulent_id} |
| POST | Suspicious Domain Approve/brp/suspicious-domains/search:approveApproves the suspicious domains that match filters (approved). Approved domains become fraudulent domains and are monitored. | /brp/suspicious-domains/search:approve |
| POST | Suspicious Domain Ignore/brp/suspicious-domains/search:ignoreIgnores the suspicious domains that match filters (ignored). | /brp/suspicious-domains/search:ignore |
| POST | Suspicious Domain Revert/brp/suspicious-domains/search:revertReverts the suspicious domains that match filters to their previous, active state. Only states set by a user can be reverted. | /brp/suspicious-domains/search:revert |
| GET | Suspicious Domain State Stats/brp/suspicious-domains/stats/stateCounts suspicious domains per state. | /brp/suspicious-domains/stats/state |
Fraudulent Rules
Rules (keywords, match types) that detect domains imitating your brand.
| Method | Endpoint | Path |
|---|---|---|
| POST | Fraudulent Rule Search/brp/fraudulent-rules/searchSearches your fraudulent rules. | /brp/fraudulent-rules/search |
| GET | Fraudulent Rule List/brp/fraudulent-rulesLists your fraudulent rules. | /brp/fraudulent-rules |
| GET | Fraudulent Rule Detail/brp/fraudulent-rules/{rule_id}Returns one fraudulent rule. | /brp/fraudulent-rules/{rule_id} |
| POST | Fraudulent Rule Create/brp/fraudulent-rulesCreates a fraudulent rule: a keyword with match_type and helper keywords. include_past also scans already registered domains; auto_approval makes matches fraudulent domains directly. | /brp/fraudulent-rules |
| PUT | Fraudulent Rule Update/brp/fraudulent-rules/{rule_id}Updates a fraudulent rule (send all fields). | /brp/fraudulent-rules/{rule_id} |
| DELETE | Fraudulent Rule Delete/brp/fraudulent-rules/{rule_id}Deletes a fraudulent rule. | /brp/fraudulent-rules/{rule_id} |