{"uid":"cap_fZw20f2eR8X__XVUvivtd","slug":"brainiac-public-records-incident-cluster-api-2622a8a3","name":"BRAINIAC Public Records Incident Cluster API","description":"Pay-per-call APIs for AI agents: OFAC sanctions screening, compliance checks, token security, and Base chain data via x402. No account. Fixed USDC price. MCP-ready.","url":"https://www.brainiac.software/api/v1/public-records/incident-cluster?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"csv":{"type":"string","maxLength":200000},"asOf":{"type":"string","maxLength":40},"feed":{"type":"object","properties":{"url":{"type":"string","format":"uri","maxLength":500},"limit":{"type":"integer","maximum":40,"minimum":1}},"additionalProperties":false},"file":{"type":"object","required":["mediaType","fileBase64"],"properties":{"filename":{"type":"string","maxLength":180,"minLength":1},"mediaType":{"enum":["text/plain","text/csv","application/json","application/xml","text/xml"],"type":"string"},"fileBase64":{"type":"string","maxLength":12000000,"minLength":1}},"additionalProperties":false},"json":{"type":"string","maxLength":200000},"text":{"type":"string","maxLength":200000},"country":{"type":"string","maxLength":80},"notices":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"area":{"type":"string","maxLength":160},"body":{"type":"string","maxLength":20000},"date":{"type":"string","maxLength":40},"title":{"type":"string","maxLength":400},"agency":{"type":"string","maxLength":200},"source":{"type":"string","maxLength":200},"status":{"enum":["allegation","investigation","charge","judgment","penalty","notice","statistic","unknown"],"type":"string"},"country":{"type":"string","maxLength":80},"sourceUrl":{"type":"string","maxLength":500}},"additionalProperties":false},"maxItems":400},"incidents":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"area":{"type":"string","maxLength":160},"date":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"status":{"enum":["allegation","investigation","charge","judgment","penalty","notice","statistic","unknown"],"type":"string"},"country":{"type":"string","maxLength":80},"offense":{"type":"string","maxLength":160},"summary":{"type":"string","maxLength":2000},"sourceUrl":{"type":"string","maxLength":500}},"additionalProperties":false},"maxItems":1000},"crimeStats":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"area":{"type":"string","maxLength":160},"rate":{"type":"number","maximum":1000000,"minimum":0},"count":{"type":"number","maximum":1000000000,"minimum":0},"period":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"country":{"type":"string","maxLength":80},"offense":{"type":"string","maxLength":160},"sourceUrl":{"type":"string","maxLength":500}},"additionalProperties":false},"maxItems":500},"businessName":{"type":"string","maxLength":200},"courtRecords":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"court":{"type":"string","maxLength":200},"title":{"type":"string","maxLength":400},"source":{"type":"string","maxLength":200},"status":{"enum":["allegation","investigation","charge","judgment","penalty","notice","statistic","unknown"],"type":"string"},"country":{"type":"string","maxLength":80},"parties":{"type":"array","items":{"type":"string","maxLength":200},"maxItems":40},"summary":{"type":"string","maxLength":5000},"sourceUrl":{"type":"string","maxLength":500},"caseNumber":{"type":"string","maxLength":120},"disposition":{"type":"string","maxLength":200},"businessName":{"type":"string","maxLength":200},"jurisdiction":{"type":"string","maxLength":160}},"additionalProperties":false},"maxItems":500},"enforcementActions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"action":{"type":"string","maxLength":200},"source":{"type":"string","maxLength":200},"status":{"enum":["allegation","investigation","charge","judgment","penalty","notice","statistic","unknown"],"type":"string"},"country":{"type":"string","maxLength":80},"subject":{"type":"string","maxLength":200},"summary":{"type":"string","maxLength":5000},"currency":{"type":"string","maxLength":12},"authority":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":500},"businessName":{"type":"string","maxLength":200},"penaltyAmount":{"type":"number","maximum":1000000000000,"minimum":0}},"additionalProperties":false},"maxItems":500}}},"responseSchema":{"type":"json","example":{"items":[{"area":"Downtown","dates":["2026-09-01","2026-09-08"],"items":[{"id":"INC-1","date":"2026-09-01","source":"Caller-supplied blotter","status":"allegation","summary":"Reported theft under investigation","isCharge":false,"isNotice":false,"isPenalty":false,"sourceUrl":"","isJudgment":false,"isAllegation":true,"guiltInferred":false,"isInvestigation":false,"chargeTreatedAsConviction":false,"allegationTreatedAsJudgment":false,"investigationTreatedAsGuilt":false},{"id":"INC-2","date":"2026-09-08","source":"Caller-supplied blotter","status":"allegation","summary":"Another reported theft","isCharge":false,"isNotice":false,"isPenalty":false,"sourceUrl":"","isJudgment":false,"isAllegation":true,"guiltInferred":false,"isInvestigation":false,"chargeTreatedAsConviction":false,"allegationTreatedAsJudgment":false,"investigationTreatedAsGuilt":false}],"country":"US","offense":"theft","statuses":["allegation"],"clusterKey":"theft|downtown","guiltInferred":false,"incidentCount":2,"chargeTreatedAsConviction":false,"allegationTreatedAsJudgment":false,"investigationTreatedAsGuilt":false}],"status":"clustered","findings":[{"code":"incident_non_judgment","kind":"observation","detail":"allegation incident is not a finding of guilt.","subject":"INC-1"},{"code":"incident_non_judgment","kind":"observation","detail":"allegation incident is not a finding of guilt.","subject":"INC-2"}],"checkedAt":"2026-11-04T21:00:00.000Z","limitations":["Court, enforcement, crime-statistic, incident, and notice records are copied only from labeled fields supplied by the caller, or from a key-free public feed when feed.url is requested.","No paid public-records provider is used and no API key is required.","Allegations, investigations, charges, penalties, and final judgments are labeled separately. Guilt is never inferred.","An allegation, investigation, or charge is never treated as a conviction or final judgment.","Missing counts, penalty amounts, and dispositions are not invented."],"clusterCount":1,"guiltInferred":false,"publicSources":[],"apiKeyRequired":false,"paidProviderUsed":false,"chargeTreatedAsConviction":false,"allegationTreatedAsJudgment":false,"investigationTreatedAsGuilt":false}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.04","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.04/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_wbCXR-HLt183gMGlAwewg","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.04","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Clusters public-records incidents, charges, notices, and crime statistics by offense type and area, labeling each record's legal status without inferring guilt","exampleAgentPrompt":"I have a list of 50 public enforcement records for a vendor we're vetting — can you cluster them by offense type and area, label each one as an allegation, charge, or judgment (never treating an allegation as a conviction), and give me a summary as of today?","exampleUseCases":[{"title":"Vendor compliance due diligence","prompt":"I've got a CSV of 200 public enforcement actions against a supplier we're considering — can you cluster them by offense and jurisdiction, flag which are actual judgments vs mere allegations, and return the grouped results with findings so I can review the compliance risk?"},{"title":"Regulatory notice pattern analysis","prompt":"Here are 80 regulatory notices from the SEC and CFTC covering the last two years — please group them by offense type and area, label each by legal status (allegation, charge, penalty, judgment), and tell me if any guilt was inferred so I know the data is clean."},{"title":"Background check incident structuring","prompt":"I need to process this JSON feed of public incident records for a background screening report — cluster the incidents by offense and location for the US, make sure allegations are never treated as convictions, and show me the findings and any limitations."}],"resultDescription":"Returns an array of incident clusters, each containing a cluster key (offense|area), list of incidents with legal status labels (isAllegation, isCharge, isJudgment, isPenalty, etc.), date ranges, inferred-guilt flags (always false), and a findings array with coded observations. Also includes a checkedAt timestamp and a limitations array explaining data provenance and what was not inferred.","failureModes":["Input exceeds size limits (csv/json/text maxLength 200000, file base64 maxLength 12000000) — returns validation error","Feed URL unreachable or returns non-200 — feed ingestion fails","Malformed date in asOf field — may return error or be ignored","Incidents array exceeds 1000 items or notices array exceeds 400 items — truncated or rejected","mediaType mismatch with actual file content — parsing error","Missing required file fields (mediaType or fileBase64) when file object is provided — validation error","Payment not received via x402 protocol — 402 response with payment instructions"],"whenToPreferThis":"Choose this endpoint when you need to group and legally-label public records (incidents, notices, crime stats) without any guilt inference — ideal for compliance workflows, vendor due diligence, and background screening where distinguishing allegations from convictions is legally critical. Prefer over generic NLP classifiers because it enforces strict legal-status labeling, never infers guilt, and explicitly flags all limitations. Use when you have structured incident data (CSV, JSON, text, or a public feed URL) and need compliance-safe clustering at a fixed low cost with no account required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-12T12:36:28.843Z","isFirstParty":false,"canonicalSlug":"brainiac-public-records-incident-cluster-api-2622a8a3"}