{"openapi":"3.1.0","info":{"title":"News Verification & Information Intelligence API","version":"1.0.0","description":"Trace original sources, cluster syndication, extract and match claims, build event timelines, and flag contradictions from supplied articles or public RSS—without treating repeats as independent confirmation. Paid with x402 exact USDC on Base. No account is required.","contact":{"email":"support@brainiac.software"},"x-guidance":"BRAINIAC.software is a pay-per-call API for software agents. No account or API key is required.\nPayment uses the x402 protocol with exact USDC on Base (chain id 8453). Each POST operation has a fixed USD price.\nHow to call an operation:\n1. POST a JSON body matching the operation's requestBody schema to the operation path. Include an Idempotency-Key header (64 hex characters, 32 random bytes).\n2. If you have not paid, the server responds 402 with payment requirements in the body. Pay the exact amount to the payTo address on Base.\n3. Retry the identical request with the same Idempotency-Key and add a payment-signature header containing the x402 payment payload. On success (200) the operation result is returned.\n4. Reuse the same Idempotency-Key only for retries of the same operation and request body; it will not be charged twice.\nAll outputs are compliance prechecks, drafts, or data lookups for human review. They are not official determinations, legal advice, identity confirmation, or certified filings. Verify time-sensitive or official data with the cited source before acting."},"servers":[{"url":"https://www.brainiac.software"}],"paths":{"/api/v1/news-intelligence/original-source-trace":{"post":{"operationId":"trace_original_news_sources","summary":"Trace original news sources","description":"Cluster similar articles and identify the earliest published item. Later reprints are not treated as independent confirmation.","tags":["news-intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json","application/xml","text/xml"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"articles":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"title":{"type":"string","maxLength":400},"url":{"type":"string","maxLength":500},"outlet":{"type":"string","maxLength":200},"publisher":{"type":"string","maxLength":200},"author":{"type":"string","maxLength":200},"publishedAt":{"type":"string","maxLength":40},"updatedAt":{"type":"string","maxLength":40},"country":{"type":"string","maxLength":80},"language":{"type":"string","maxLength":40},"body":{"type":"string","maxLength":50000},"summary":{"type":"string","maxLength":5000},"source":{"type":"string","maxLength":200},"syndicatedFrom":{"type":"string","maxLength":200}},"additionalProperties":false}},"claims":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"text":{"type":"string","maxLength":1000},"articleId":{"type":"string","maxLength":80},"polarity":{"type":"string","maxLength":40},"country":{"type":"string","maxLength":80},"event":{"type":"string","maxLength":200},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"events":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"country":{"type":"string","maxLength":80},"title":{"type":"string","maxLength":300},"summary":{"type":"string","maxLength":1000},"articleId":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"rss":{"type":"object","properties":{"url":{"type":"string","maxLength":500,"format":"uri"},"limit":{"type":"integer","minimum":1,"maximum":40}},"additionalProperties":false},"asOf":{"type":"string","maxLength":40},"country":{"type":"string","maxLength":80}},"additionalProperties":false},"example":{"articles":[{"id":"A-1","title":"Ministry announces flood relief package","outlet":"Official Wire","url":"https://example.invalid/a1","publishedAt":"2026-10-01T08:00:00.000Z","body":"The ministry announced a flood relief package today.","country":"US"},{"id":"A-2","title":"Ministry announces flood relief package","outlet":"City Paper","url":"https://example.invalid/a2","publishedAt":"2026-10-01T12:00:00.000Z","body":"The ministry announced a flood relief package today.","country":"US","syndicatedFrom":"Official Wire"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"clusterCount":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"clusterId":{"type":"string"},"originalArticleId":{"type":"string"},"originalOutlet":{"type":"string"},"originalUrl":{"type":"string"},"originalPublishedAt":{"type":"string"},"reprintCount":{"type":"number"},"articleIds":{"type":"array","items":{"type":"string"}},"outlets":{"type":"array","items":{"type":"string"}},"repeatedPublicationTreatedAsConfirmation":{"type":"boolean"},"independentConfirmationClaimed":{"type":"boolean"}},"additionalProperties":true}},"repeatedPublicationTreatedAsConfirmation":{"type":"boolean"},"independentConfirmationClaimed":{"type":"boolean"},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"publicSources":{"type":"array","items":{}},"findings":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"code":{"type":"string"},"subject":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T21:00:00.000Z","status":"traced","clusterCount":1,"items":[{"clusterId":"CL-1","originalArticleId":"A-1","originalOutlet":"Official Wire","originalUrl":"https://example.invalid/a1","originalPublishedAt":"2026-10-01T08:00:00.000Z","reprintCount":1,"articleIds":["A-1","A-2"],"outlets":["Official Wire","City Paper"],"repeatedPublicationTreatedAsConfirmation":false,"independentConfirmationClaimed":false}],"repeatedPublicationTreatedAsConfirmation":false,"independentConfirmationClaimed":false,"paidProviderUsed":false,"apiKeyRequired":false,"publicSources":[],"findings":[{"kind":"observation","code":"syndication_or_repeat","subject":"A-1","detail":"Similar articles were clustered. Repeated publication is not independent confirmation."}],"limitations":["Articles, claims, and events are copied only from labeled fields supplied by the caller, or from a key-free public RSS/Atom response when an rss.url is requested.","No paid news API is used and no API key is required.","Repeated publication or syndication of the same claim is never treated as independent confirmation.","Claim extraction uses local heuristics on supplied text. Missing quotes and attributions are not invented.","Source independence counts distinct outlets only; similar or syndicated copies stay labeled as non-independent repeats."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]}}},"/api/v1/news-intelligence/syndication-cluster":{"post":{"operationId":"cluster_syndicated_news_articles","summary":"Cluster syndicated news articles","description":"Group near-duplicate titles and bodies into syndication clusters without counting repeats as confirmation.","tags":["news-intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json","application/xml","text/xml"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"articles":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"title":{"type":"string","maxLength":400},"url":{"type":"string","maxLength":500},"outlet":{"type":"string","maxLength":200},"publisher":{"type":"string","maxLength":200},"author":{"type":"string","maxLength":200},"publishedAt":{"type":"string","maxLength":40},"updatedAt":{"type":"string","maxLength":40},"country":{"type":"string","maxLength":80},"language":{"type":"string","maxLength":40},"body":{"type":"string","maxLength":50000},"summary":{"type":"string","maxLength":5000},"source":{"type":"string","maxLength":200},"syndicatedFrom":{"type":"string","maxLength":200}},"additionalProperties":false}},"claims":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"text":{"type":"string","maxLength":1000},"articleId":{"type":"string","maxLength":80},"polarity":{"type":"string","maxLength":40},"country":{"type":"string","maxLength":80},"event":{"type":"string","maxLength":200},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"events":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"country":{"type":"string","maxLength":80},"title":{"type":"string","maxLength":300},"summary":{"type":"string","maxLength":1000},"articleId":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"rss":{"type":"object","properties":{"url":{"type":"string","maxLength":500,"format":"uri"},"limit":{"type":"integer","minimum":1,"maximum":40}},"additionalProperties":false},"asOf":{"type":"string","maxLength":40},"country":{"type":"string","maxLength":80}},"additionalProperties":false},"example":{"articles":[{"id":"A-1","title":"Bridge closure begins Monday","outlet":"Outlet A","publishedAt":"2026-09-10T09:00:00.000Z","body":"Officials said the bridge closure begins Monday for repairs."},{"id":"A-2","title":"Bridge closure begins Monday","outlet":"Outlet B","publishedAt":"2026-09-10T11:00:00.000Z","body":"Officials said the bridge closure begins Monday for repairs."},{"id":"A-3","title":"Unrelated market update","outlet":"Outlet C","publishedAt":"2026-09-10T10:00:00.000Z","body":"Markets were mixed in afternoon trading."}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"clusterCount":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"articleIds":{"type":"array","items":{"type":"string"}},"outlets":{"type":"array","items":{"type":"string"}},"earliestId":{"type":"string"},"earliestPublishedAt":{"type":"string"},"similarity":{"type":"number"},"independentConfirmationClaimed":{"type":"boolean"},"repeatedPublicationTreatedAsConfirmation":{"type":"boolean"}},"additionalProperties":true}},"repeatedPublicationTreatedAsConfirmation":{"type":"boolean"},"independentConfirmationClaimed":{"type":"boolean"},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"publicSources":{"type":"array","items":{}},"findings":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"code":{"type":"string"},"subject":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T21:00:00.000Z","status":"clustered","clusterCount":1,"items":[{"id":"CL-1","articleIds":["A-1","A-2"],"outlets":["Outlet A","Outlet B"],"earliestId":"A-1","earliestPublishedAt":"2026-09-10T09:00:00.000Z","similarity":0.72,"independentConfirmationClaimed":false,"repeatedPublicationTreatedAsConfirmation":false}],"repeatedPublicationTreatedAsConfirmation":false,"independentConfirmationClaimed":false,"paidProviderUsed":false,"apiKeyRequired":false,"publicSources":[],"findings":[{"kind":"observation","code":"syndication_or_repeat","subject":"A-1","detail":"Similar articles were clustered. Repeated publication is not independent confirmation."}],"limitations":["Articles, claims, and events are copied only from labeled fields supplied by the caller, or from a key-free public RSS/Atom response when an rss.url is requested.","No paid news API is used and no API key is required.","Repeated publication or syndication of the same claim is never treated as independent confirmation.","Claim extraction uses local heuristics on supplied text. Missing quotes and attributions are not invented.","Source independence counts distinct outlets only; similar or syndicated copies stay labeled as non-independent repeats."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{}}]}}},"/api/v1/news-intelligence/claim-extract":{"post":{"operationId":"extract_news_claims","summary":"Extract news claims","description":"Extract claim-like sentences and quotes from supplied article text using local heuristics.","tags":["news-intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json","application/xml","text/xml"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"articles":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"title":{"type":"string","maxLength":400},"url":{"type":"string","maxLength":500},"outlet":{"type":"string","maxLength":200},"publisher":{"type":"string","maxLength":200},"author":{"type":"string","maxLength":200},"publishedAt":{"type":"string","maxLength":40},"updatedAt":{"type":"string","maxLength":40},"country":{"type":"string","maxLength":80},"language":{"type":"string","maxLength":40},"body":{"type":"string","maxLength":50000},"summary":{"type":"string","maxLength":5000},"source":{"type":"string","maxLength":200},"syndicatedFrom":{"type":"string","maxLength":200}},"additionalProperties":false}},"claims":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"text":{"type":"string","maxLength":1000},"articleId":{"type":"string","maxLength":80},"polarity":{"type":"string","maxLength":40},"country":{"type":"string","maxLength":80},"event":{"type":"string","maxLength":200},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"events":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"country":{"type":"string","maxLength":80},"title":{"type":"string","maxLength":300},"summary":{"type":"string","maxLength":1000},"articleId":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"rss":{"type":"object","properties":{"url":{"type":"string","maxLength":500,"format":"uri"},"limit":{"type":"integer","minimum":1,"maximum":40}},"additionalProperties":false},"asOf":{"type":"string","maxLength":40},"country":{"type":"string","maxLength":80}},"additionalProperties":false},"example":{"articles":[{"id":"A-1","title":"Mayor denies resignation rumor","outlet":"Local News","body":"The mayor said the resignation rumor is false. \"I am not resigning,\" the mayor said according to the statement."}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"claimCount":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"},"normalized":{"type":"string"},"articleId":{"type":"string"},"polarity":{"type":"string"},"country":{"type":"string"},"event":{"type":"string"},"source":{"type":"string"},"repeatedPublicationTreatedAsConfirmation":{"type":"boolean"},"independentConfirmationClaimed":{"type":"boolean"}},"additionalProperties":true}},"repeatedPublicationTreatedAsConfirmation":{"type":"boolean"},"independentConfirmationClaimed":{"type":"boolean"},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"publicSources":{"type":"array","items":{}},"findings":{"type":"array","items":{}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T21:00:00.000Z","status":"extracted","claimCount":2,"items":[{"id":"A-1-S-1","text":"Mayor denies resignation rumor The mayor said the resignation rumor is false.","normalized":"mayor denies resignation rumor the mayor said the resignation rumor is false","articleId":"A-1","polarity":"negating","country":"","event":"","source":"Local News","repeatedPublicationTreatedAsConfirmation":false,"independentConfirmationClaimed":false},{"id":"A-1-S-2","text":"\"I am not resigning,\" the mayor said according to the statement.","normalized":"i am not resigning the mayor said according to the statement","articleId":"A-1","polarity":"negating","country":"","event":"","source":"Local News","repeatedPublicationTreatedAsConfirmation":false,"independentConfirmationClaimed":false}],"repeatedPublicationTreatedAsConfirmation":false,"independentConfirmationClaimed":false,"paidProviderUsed":false,"apiKeyRequired":false,"publicSources":[],"findings":[],"limitations":["Articles, claims, and events are copied only from labeled fields supplied by the caller, or from a key-free public RSS/Atom response when an rss.url is requested.","No paid news API is used and no API key is required.","Repeated publication or syndication of the same claim is never treated as independent confirmation.","Claim extraction uses local heuristics on supplied text. Missing quotes and attributions are not invented.","Source independence counts distinct outlets only; similar or syndicated copies stay labeled as non-independent repeats."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{}}]}}},"/api/v1/news-intelligence/claim-source-match":{"post":{"operationId":"match_claims_to_sources","summary":"Match claims to sources","description":"Match supplied or extracted claims to articles by text overlap. Multiple outlets repeating a claim are not independent confirmation.","tags":["news-intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json","application/xml","text/xml"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"articles":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"title":{"type":"string","maxLength":400},"url":{"type":"string","maxLength":500},"outlet":{"type":"string","maxLength":200},"publisher":{"type":"string","maxLength":200},"author":{"type":"string","maxLength":200},"publishedAt":{"type":"string","maxLength":40},"updatedAt":{"type":"string","maxLength":40},"country":{"type":"string","maxLength":80},"language":{"type":"string","maxLength":40},"body":{"type":"string","maxLength":50000},"summary":{"type":"string","maxLength":5000},"source":{"type":"string","maxLength":200},"syndicatedFrom":{"type":"string","maxLength":200}},"additionalProperties":false}},"claims":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"text":{"type":"string","maxLength":1000},"articleId":{"type":"string","maxLength":80},"polarity":{"type":"string","maxLength":40},"country":{"type":"string","maxLength":80},"event":{"type":"string","maxLength":200},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"events":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"country":{"type":"string","maxLength":80},"title":{"type":"string","maxLength":300},"summary":{"type":"string","maxLength":1000},"articleId":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"rss":{"type":"object","properties":{"url":{"type":"string","maxLength":500,"format":"uri"},"limit":{"type":"integer","minimum":1,"maximum":40}},"additionalProperties":false},"asOf":{"type":"string","maxLength":40},"country":{"type":"string","maxLength":80}},"additionalProperties":false},"example":{"claims":[{"id":"C-1","text":"The ministry announced a flood relief package today.","articleId":"A-1"}],"articles":[{"id":"A-1","title":"Flood relief announced","outlet":"Official Wire","body":"The ministry announced a flood relief package today."},{"id":"A-2","title":"Flood relief announced","outlet":"City Paper","body":"The ministry announced a flood relief package today."}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"claimCount":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"claimId":{"type":"string"},"text":{"type":"string"},"matchCount":{"type":"number"},"distinctOutletCount":{"type":"number"},"matches":{"type":"array","items":{"type":"object","properties":{"articleId":{"type":"string"},"outlet":{"type":"string"},"score":{"type":"number"},"kind":{"type":"string"}},"additionalProperties":true}},"repeatedPublicationTreatedAsConfirmation":{"type":"boolean"},"independentConfirmationClaimed":{"type":"boolean"},"syndicatedRepeatLikely":{"type":"boolean"}},"additionalProperties":true}},"repeatedPublicationTreatedAsConfirmation":{"type":"boolean"},"independentConfirmationClaimed":{"type":"boolean"},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"publicSources":{"type":"array","items":{}},"findings":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"code":{"type":"string"},"subject":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T21:00:00.000Z","status":"matched","claimCount":1,"items":[{"claimId":"C-1","text":"The ministry announced a flood relief package today.","matchCount":2,"distinctOutletCount":2,"matches":[{"articleId":"A-1","outlet":"Official Wire","score":1,"kind":"exactish"},{"articleId":"A-2","outlet":"City Paper","score":1,"kind":"exactish"}],"repeatedPublicationTreatedAsConfirmation":false,"independentConfirmationClaimed":false,"syndicatedRepeatLikely":true}],"repeatedPublicationTreatedAsConfirmation":false,"independentConfirmationClaimed":false,"paidProviderUsed":false,"apiKeyRequired":false,"publicSources":[],"findings":[{"kind":"observation","code":"claim_repeat","subject":"C-1","detail":"The same or similar claim appears in multiple articles. Repeats are not independent confirmation."}],"limitations":["Articles, claims, and events are copied only from labeled fields supplied by the caller, or from a key-free public RSS/Atom response when an rss.url is requested.","No paid news API is used and no API key is required.","Repeated publication or syndication of the same claim is never treated as independent confirmation.","Claim extraction uses local heuristics on supplied text. Missing quotes and attributions are not invented.","Source independence counts distinct outlets only; similar or syndicated copies stay labeled as non-independent repeats."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]}}},"/api/v1/news-intelligence/event-timeline-build":{"post":{"operationId":"build_news_event_timeline","summary":"Build news event timeline","description":"Order supplied events or dated articles into a timeline without inventing missing dates.","tags":["news-intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json","application/xml","text/xml"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"articles":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"title":{"type":"string","maxLength":400},"url":{"type":"string","maxLength":500},"outlet":{"type":"string","maxLength":200},"publisher":{"type":"string","maxLength":200},"author":{"type":"string","maxLength":200},"publishedAt":{"type":"string","maxLength":40},"updatedAt":{"type":"string","maxLength":40},"country":{"type":"string","maxLength":80},"language":{"type":"string","maxLength":40},"body":{"type":"string","maxLength":50000},"summary":{"type":"string","maxLength":5000},"source":{"type":"string","maxLength":200},"syndicatedFrom":{"type":"string","maxLength":200}},"additionalProperties":false}},"claims":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"text":{"type":"string","maxLength":1000},"articleId":{"type":"string","maxLength":80},"polarity":{"type":"string","maxLength":40},"country":{"type":"string","maxLength":80},"event":{"type":"string","maxLength":200},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"events":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"country":{"type":"string","maxLength":80},"title":{"type":"string","maxLength":300},"summary":{"type":"string","maxLength":1000},"articleId":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"rss":{"type":"object","properties":{"url":{"type":"string","maxLength":500,"format":"uri"},"limit":{"type":"integer","minimum":1,"maximum":40}},"additionalProperties":false},"asOf":{"type":"string","maxLength":40},"country":{"type":"string","maxLength":80}},"additionalProperties":false},"example":{"events":[{"id":"E-1","date":"2026-10-01","country":"US","title":"Relief package announced","articleId":"A-1","source":"Official Wire"},{"id":"E-2","date":"2026-10-03","country":"US","title":"Aid distribution begins","articleId":"A-3","source":"City Paper"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"eventCount":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"date":{"type":"string"},"country":{"type":"string"},"title":{"type":"string"},"summary":{"type":"string"},"articleId":{"type":"string"},"source":{"type":"string"},"repeatedPublicationTreatedAsConfirmation":{"type":"boolean"},"independentConfirmationClaimed":{"type":"boolean"}},"additionalProperties":true}},"repeatedPublicationTreatedAsConfirmation":{"type":"boolean"},"independentConfirmationClaimed":{"type":"boolean"},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"publicSources":{"type":"array","items":{}},"findings":{"type":"array","items":{}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T21:00:00.000Z","status":"built","eventCount":2,"items":[{"id":"E-1","date":"2026-10-01","country":"US","title":"Relief package announced","summary":"","articleId":"A-1","source":"Official Wire","repeatedPublicationTreatedAsConfirmation":false,"independentConfirmationClaimed":false},{"id":"E-2","date":"2026-10-03","country":"US","title":"Aid distribution begins","summary":"","articleId":"A-3","source":"City Paper","repeatedPublicationTreatedAsConfirmation":false,"independentConfirmationClaimed":false}],"repeatedPublicationTreatedAsConfirmation":false,"independentConfirmationClaimed":false,"paidProviderUsed":false,"apiKeyRequired":false,"publicSources":[],"findings":[],"limitations":["Articles, claims, and events are copied only from labeled fields supplied by the caller, or from a key-free public RSS/Atom response when an rss.url is requested.","No paid news API is used and no API key is required.","Repeated publication or syndication of the same claim is never treated as independent confirmation.","Claim extraction uses local heuristics on supplied text. Missing quotes and attributions are not invented.","Source independence counts distinct outlets only; similar or syndicated copies stay labeled as non-independent repeats."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{}}]}}},"/api/v1/news-intelligence/correction-history-detect":{"post":{"operationId":"detect_news_correction_history","summary":"Detect news correction history","description":"Flag correction, update, and retraction wording or updatedAt changes in supplied articles.","tags":["news-intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json","application/xml","text/xml"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"articles":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"title":{"type":"string","maxLength":400},"url":{"type":"string","maxLength":500},"outlet":{"type":"string","maxLength":200},"publisher":{"type":"string","maxLength":200},"author":{"type":"string","maxLength":200},"publishedAt":{"type":"string","maxLength":40},"updatedAt":{"type":"string","maxLength":40},"country":{"type":"string","maxLength":80},"language":{"type":"string","maxLength":40},"body":{"type":"string","maxLength":50000},"summary":{"type":"string","maxLength":5000},"source":{"type":"string","maxLength":200},"syndicatedFrom":{"type":"string","maxLength":200}},"additionalProperties":false}},"claims":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"text":{"type":"string","maxLength":1000},"articleId":{"type":"string","maxLength":80},"polarity":{"type":"string","maxLength":40},"country":{"type":"string","maxLength":80},"event":{"type":"string","maxLength":200},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"events":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"country":{"type":"string","maxLength":80},"title":{"type":"string","maxLength":300},"summary":{"type":"string","maxLength":1000},"articleId":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"rss":{"type":"object","properties":{"url":{"type":"string","maxLength":500,"format":"uri"},"limit":{"type":"integer","minimum":1,"maximum":40}},"additionalProperties":false},"asOf":{"type":"string","maxLength":40},"country":{"type":"string","maxLength":80}},"additionalProperties":false},"example":{"articles":[{"id":"A-1","title":"Correction: attendance figure updated","outlet":"City Paper","publishedAt":"2026-09-01T10:00:00.000Z","updatedAt":"2026-09-01T18:00:00.000Z","body":"Editor's note: This story was corrected to update the attendance figure."},{"id":"A-2","title":"Unrelated briefing","outlet":"Outlet B","publishedAt":"2026-09-02T10:00:00.000Z","body":"Officials held a routine briefing."}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"articleCount":{"type":"number"},"correctionSignalCount":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"articleId":{"type":"string"},"outlet":{"type":"string"},"publishedAt":{"type":"string"},"updatedAt":{"type":"string"},"detected":{"type":"boolean"},"signalCount":{"type":"number"},"signals":{"type":"array","items":{"type":"string"}},"repeatedPublicationTreatedAsConfirmation":{"type":"boolean"},"independentConfirmationClaimed":{"type":"boolean"}},"additionalProperties":true}},"repeatedPublicationTreatedAsConfirmation":{"type":"boolean"},"independentConfirmationClaimed":{"type":"boolean"},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"publicSources":{"type":"array","items":{}},"findings":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"code":{"type":"string"},"subject":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T21:00:00.000Z","status":"checked","articleCount":2,"correctionSignalCount":1,"items":[{"articleId":"A-1","outlet":"City Paper","publishedAt":"2026-09-01T10:00:00.000Z","updatedAt":"2026-09-01T18:00:00.000Z","detected":true,"signalCount":6,"signals":["correction","updated","editor's note","corrected","update"],"repeatedPublicationTreatedAsConfirmation":false,"independentConfirmationClaimed":false},{"articleId":"A-2","outlet":"Outlet B","publishedAt":"2026-09-02T10:00:00.000Z","updatedAt":"","detected":false,"signalCount":0,"signals":[],"repeatedPublicationTreatedAsConfirmation":false,"independentConfirmationClaimed":false}],"repeatedPublicationTreatedAsConfirmation":false,"independentConfirmationClaimed":false,"paidProviderUsed":false,"apiKeyRequired":false,"publicSources":[],"findings":[{"kind":"observation","code":"correction_signal","subject":"A-1","detail":"Correction/update wording or an updatedAt distinct from publishedAt was found."}],"limitations":["Articles, claims, and events are copied only from labeled fields supplied by the caller, or from a key-free public RSS/Atom response when an rss.url is requested.","No paid news API is used and no API key is required.","Repeated publication or syndication of the same claim is never treated as independent confirmation.","Claim extraction uses local heuristics on supplied text. Missing quotes and attributions are not invented.","Source independence counts distinct outlets only; similar or syndicated copies stay labeled as non-independent repeats."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{}}]}}},"/api/v1/news-intelligence/source-independence-analyze":{"post":{"operationId":"analyze_news_source_independence","summary":"Analyze news source independence","description":"Count distinct outlets and mark syndicated/similar copies as non-independent. Repeats are never claimed as confirmation.","tags":["news-intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json","application/xml","text/xml"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"articles":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"title":{"type":"string","maxLength":400},"url":{"type":"string","maxLength":500},"outlet":{"type":"string","maxLength":200},"publisher":{"type":"string","maxLength":200},"author":{"type":"string","maxLength":200},"publishedAt":{"type":"string","maxLength":40},"updatedAt":{"type":"string","maxLength":40},"country":{"type":"string","maxLength":80},"language":{"type":"string","maxLength":40},"body":{"type":"string","maxLength":50000},"summary":{"type":"string","maxLength":5000},"source":{"type":"string","maxLength":200},"syndicatedFrom":{"type":"string","maxLength":200}},"additionalProperties":false}},"claims":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"text":{"type":"string","maxLength":1000},"articleId":{"type":"string","maxLength":80},"polarity":{"type":"string","maxLength":40},"country":{"type":"string","maxLength":80},"event":{"type":"string","maxLength":200},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"events":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"country":{"type":"string","maxLength":80},"title":{"type":"string","maxLength":300},"summary":{"type":"string","maxLength":1000},"articleId":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"rss":{"type":"object","properties":{"url":{"type":"string","maxLength":500,"format":"uri"},"limit":{"type":"integer","minimum":1,"maximum":40}},"additionalProperties":false},"asOf":{"type":"string","maxLength":40},"country":{"type":"string","maxLength":80}},"additionalProperties":false},"example":{"articles":[{"id":"A-1","title":"Policy draft leaked","outlet":"Outlet A","url":"https://a.example.invalid/1","body":"A policy draft leaked overnight according to officials."},{"id":"A-2","title":"Policy draft leaked","outlet":"Outlet B","url":"https://b.example.invalid/2","body":"A policy draft leaked overnight according to officials.","syndicatedFrom":"Outlet A"},{"id":"A-3","title":"Markets open higher","outlet":"Outlet C","url":"https://c.example.invalid/3","body":"Markets opened higher on earnings news."}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"outletCount":{"type":"number"},"hostCount":{"type":"number"},"syndicatedClusterCount":{"type":"number"},"distinctOutletCount":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"articleId":{"type":"string"},"outlet":{"type":"string"},"host":{"type":"string"},"inSyndicationCluster":{"type":"boolean"},"independentConfirmationClaimed":{"type":"boolean"},"repeatedPublicationTreatedAsConfirmation":{"type":"boolean"}},"additionalProperties":true}},"repeatedPublicationTreatedAsConfirmation":{"type":"boolean"},"independentConfirmationClaimed":{"type":"boolean"},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"publicSources":{"type":"array","items":{}},"findings":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"code":{"type":"string"},"subject":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T21:00:00.000Z","status":"analyzed","outletCount":3,"hostCount":3,"syndicatedClusterCount":1,"distinctOutletCount":3,"items":[{"articleId":"A-1","outlet":"Outlet A","host":"a.example.invalid","inSyndicationCluster":true,"independentConfirmationClaimed":false,"repeatedPublicationTreatedAsConfirmation":false},{"articleId":"A-2","outlet":"Outlet B","host":"b.example.invalid","inSyndicationCluster":true,"independentConfirmationClaimed":false,"repeatedPublicationTreatedAsConfirmation":false},{"articleId":"A-3","outlet":"Outlet C","host":"c.example.invalid","inSyndicationCluster":false,"independentConfirmationClaimed":false,"repeatedPublicationTreatedAsConfirmation":false}],"repeatedPublicationTreatedAsConfirmation":false,"independentConfirmationClaimed":false,"paidProviderUsed":false,"apiKeyRequired":false,"publicSources":[],"findings":[{"kind":"observation","code":"non_independent_repeat","subject":"A-1","detail":"Article participates in a similar/syndicated cluster and is not counted as independent confirmation."},{"kind":"observation","code":"non_independent_repeat","subject":"A-2","detail":"Article participates in a similar/syndicated cluster and is not counted as independent confirmation."}],"limitations":["Articles, claims, and events are copied only from labeled fields supplied by the caller, or from a key-free public RSS/Atom response when an rss.url is requested.","No paid news API is used and no API key is required.","Repeated publication or syndication of the same claim is never treated as independent confirmation.","Claim extraction uses local heuristics on supplied text. Missing quotes and attributions are not invented.","Source independence counts distinct outlets only; similar or syndicated copies stay labeled as non-independent repeats."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{}}]}}},"/api/v1/news-intelligence/contradiction-detect":{"post":{"operationId":"detect_news_claim_contradictions","summary":"Detect news claim contradictions","description":"Find affirming vs negating overlapping claims, and label near-duplicate repeats without treating them as confirmation.","tags":["news-intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json","application/xml","text/xml"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"articles":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"title":{"type":"string","maxLength":400},"url":{"type":"string","maxLength":500},"outlet":{"type":"string","maxLength":200},"publisher":{"type":"string","maxLength":200},"author":{"type":"string","maxLength":200},"publishedAt":{"type":"string","maxLength":40},"updatedAt":{"type":"string","maxLength":40},"country":{"type":"string","maxLength":80},"language":{"type":"string","maxLength":40},"body":{"type":"string","maxLength":50000},"summary":{"type":"string","maxLength":5000},"source":{"type":"string","maxLength":200},"syndicatedFrom":{"type":"string","maxLength":200}},"additionalProperties":false}},"claims":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"text":{"type":"string","maxLength":1000},"articleId":{"type":"string","maxLength":80},"polarity":{"type":"string","maxLength":40},"country":{"type":"string","maxLength":80},"event":{"type":"string","maxLength":200},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"events":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"country":{"type":"string","maxLength":80},"title":{"type":"string","maxLength":300},"summary":{"type":"string","maxLength":1000},"articleId":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"rss":{"type":"object","properties":{"url":{"type":"string","maxLength":500,"format":"uri"},"limit":{"type":"integer","minimum":1,"maximum":40}},"additionalProperties":false},"asOf":{"type":"string","maxLength":40},"country":{"type":"string","maxLength":80}},"additionalProperties":false},"example":{"claims":[{"id":"C-1","text":"Officials confirmed the bridge will open next week.","polarity":"affirming","articleId":"A-1"},{"id":"C-2","text":"Officials denied the bridge will open next week.","polarity":"negating","articleId":"A-2"},{"id":"C-3","text":"Officials confirmed the bridge will open next week.","polarity":"affirming","articleId":"A-3"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"pairCount":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"leftClaimId":{"type":"string"},"rightClaimId":{"type":"string"},"overlap":{"type":"number"},"leftPolarity":{"type":"string"},"rightPolarity":{"type":"string"},"leftArticleId":{"type":"string"},"rightArticleId":{"type":"string"},"independentConfirmationClaimed":{"type":"boolean"},"repeatedPublicationTreatedAsConfirmation":{"type":"boolean"}},"additionalProperties":true}},"repeatedPublicationTreatedAsConfirmation":{"type":"boolean"},"independentConfirmationClaimed":{"type":"boolean"},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"publicSources":{"type":"array","items":{}},"findings":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"code":{"type":"string"},"subject":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T21:00:00.000Z","status":"checked","pairCount":3,"items":[{"kind":"contradiction","leftClaimId":"C-1","rightClaimId":"C-2","overlap":0.857,"leftPolarity":"affirming","rightPolarity":"negating","leftArticleId":"A-1","rightArticleId":"A-2","independentConfirmationClaimed":false,"repeatedPublicationTreatedAsConfirmation":false},{"kind":"repeat","leftClaimId":"C-1","rightClaimId":"C-3","overlap":1,"leftPolarity":"affirming","rightPolarity":"affirming","leftArticleId":"A-1","rightArticleId":"A-3","independentConfirmationClaimed":false,"repeatedPublicationTreatedAsConfirmation":false},{"kind":"contradiction","leftClaimId":"C-2","rightClaimId":"C-3","overlap":0.857,"leftPolarity":"negating","rightPolarity":"affirming","leftArticleId":"A-2","rightArticleId":"A-3","independentConfirmationClaimed":false,"repeatedPublicationTreatedAsConfirmation":false}],"repeatedPublicationTreatedAsConfirmation":false,"independentConfirmationClaimed":false,"paidProviderUsed":false,"apiKeyRequired":false,"publicSources":[],"findings":[{"kind":"conflict","code":"claim_contradiction","subject":"C-1|C-2","detail":"Affirming and negating claims with overlapping content were found."},{"kind":"observation","code":"same_claim_repeat","subject":"C-1|C-3","detail":"Near-duplicate claims were found. Repeat publication is not independent confirmation."},{"kind":"conflict","code":"claim_contradiction","subject":"C-2|C-3","detail":"Affirming and negating claims with overlapping content were found."}],"limitations":["Articles, claims, and events are copied only from labeled fields supplied by the caller, or from a key-free public RSS/Atom response when an rss.url is requested.","No paid news API is used and no API key is required.","Repeated publication or syndication of the same claim is never treated as independent confirmation.","Claim extraction uses local heuristics on supplied text. Missing quotes and attributions are not invented.","Source independence counts distinct outlets only; similar or syndicated copies stay labeled as non-independent repeats."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]}}},"/api/v1/news-intelligence/country-event-monitor":{"post":{"operationId":"monitor_country_news_events","summary":"Monitor country news events","description":"Filter supplied articles and events by country into a dated monitor list.","tags":["news-intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json","application/xml","text/xml"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"articles":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"title":{"type":"string","maxLength":400},"url":{"type":"string","maxLength":500},"outlet":{"type":"string","maxLength":200},"publisher":{"type":"string","maxLength":200},"author":{"type":"string","maxLength":200},"publishedAt":{"type":"string","maxLength":40},"updatedAt":{"type":"string","maxLength":40},"country":{"type":"string","maxLength":80},"language":{"type":"string","maxLength":40},"body":{"type":"string","maxLength":50000},"summary":{"type":"string","maxLength":5000},"source":{"type":"string","maxLength":200},"syndicatedFrom":{"type":"string","maxLength":200}},"additionalProperties":false}},"claims":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"text":{"type":"string","maxLength":1000},"articleId":{"type":"string","maxLength":80},"polarity":{"type":"string","maxLength":40},"country":{"type":"string","maxLength":80},"event":{"type":"string","maxLength":200},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"events":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"country":{"type":"string","maxLength":80},"title":{"type":"string","maxLength":300},"summary":{"type":"string","maxLength":1000},"articleId":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"rss":{"type":"object","properties":{"url":{"type":"string","maxLength":500,"format":"uri"},"limit":{"type":"integer","minimum":1,"maximum":40}},"additionalProperties":false},"asOf":{"type":"string","maxLength":40},"country":{"type":"string","maxLength":80}},"additionalProperties":false},"example":{"country":"US","articles":[{"id":"A-1","title":"US flood relief announced","country":"US","outlet":"Official Wire","publishedAt":"2026-10-01T08:00:00.000Z","body":"Relief announced."},{"id":"A-2","title":"EU market note","country":"EU","outlet":"EU Desk","publishedAt":"2026-10-01T09:00:00.000Z","body":"Markets noted."}],"events":[{"id":"E-1","date":"2026-10-03","country":"US","title":"Aid distribution begins","source":"City Paper"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"country":{"type":"string"},"articleCount":{"type":"number"},"eventCount":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"kind":{"type":"string"},"id":{"type":"string"},"title":{"type":"string"},"country":{"type":"string"},"outlet":{"type":"string"}},"additionalProperties":true}},"repeatedPublicationTreatedAsConfirmation":{"type":"boolean"},"independentConfirmationClaimed":{"type":"boolean"},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"publicSources":{"type":"array","items":{}},"findings":{"type":"array","items":{}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T21:00:00.000Z","status":"monitored","country":"US","articleCount":1,"eventCount":1,"items":[{"date":"2026-10-01T08:00:00.000Z","kind":"article","id":"A-1","title":"US flood relief announced","country":"US","outlet":"Official Wire"},{"date":"2026-10-03","kind":"event","id":"E-1","title":"Aid distribution begins","country":"US","outlet":"City Paper"}],"repeatedPublicationTreatedAsConfirmation":false,"independentConfirmationClaimed":false,"paidProviderUsed":false,"apiKeyRequired":false,"publicSources":[],"findings":[],"limitations":["Articles, claims, and events are copied only from labeled fields supplied by the caller, or from a key-free public RSS/Atom response when an rss.url is requested.","No paid news API is used and no API key is required.","Repeated publication or syndication of the same claim is never treated as independent confirmation.","Claim extraction uses local heuristics on supplied text. Missing quotes and attributions are not invented.","Source independence counts distinct outlets only; similar or syndicated copies stay labeled as non-independent repeats."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{}}]}}},"/api/v1/news-intelligence/verification-evidence-report":{"post":{"operationId":"build_news_verification_evidence_report","summary":"Build news verification evidence report","description":"Aggregate source tracing, syndication, claims, contradictions, corrections, and independence findings. Repeats are never independent confirmation.","tags":["news-intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json","application/xml","text/xml"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"articles":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"title":{"type":"string","maxLength":400},"url":{"type":"string","maxLength":500},"outlet":{"type":"string","maxLength":200},"publisher":{"type":"string","maxLength":200},"author":{"type":"string","maxLength":200},"publishedAt":{"type":"string","maxLength":40},"updatedAt":{"type":"string","maxLength":40},"country":{"type":"string","maxLength":80},"language":{"type":"string","maxLength":40},"body":{"type":"string","maxLength":50000},"summary":{"type":"string","maxLength":5000},"source":{"type":"string","maxLength":200},"syndicatedFrom":{"type":"string","maxLength":200}},"additionalProperties":false}},"claims":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"text":{"type":"string","maxLength":1000},"articleId":{"type":"string","maxLength":80},"polarity":{"type":"string","maxLength":40},"country":{"type":"string","maxLength":80},"event":{"type":"string","maxLength":200},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"events":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"country":{"type":"string","maxLength":80},"title":{"type":"string","maxLength":300},"summary":{"type":"string","maxLength":1000},"articleId":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"rss":{"type":"object","properties":{"url":{"type":"string","maxLength":500,"format":"uri"},"limit":{"type":"integer","minimum":1,"maximum":40}},"additionalProperties":false},"asOf":{"type":"string","maxLength":40},"country":{"type":"string","maxLength":80}},"additionalProperties":false},"example":{"articles":[{"id":"A-1","title":"Ministry announces flood relief package","outlet":"Official Wire","publishedAt":"2026-10-01T08:00:00.000Z","body":"The ministry announced a flood relief package today.","country":"US"},{"id":"A-2","title":"Ministry announces flood relief package","outlet":"City Paper","publishedAt":"2026-10-01T12:00:00.000Z","body":"The ministry announced a flood relief package today.","country":"US","syndicatedFrom":"Official Wire"},{"id":"A-3","title":"Correction: aid figure updated","outlet":"City Paper","publishedAt":"2026-10-02T09:00:00.000Z","updatedAt":"2026-10-02T15:00:00.000Z","body":"Correction: the aid figure was updated in this report.","country":"US"}],"claims":[{"id":"C-1","text":"The ministry announced a flood relief package today.","polarity":"affirming","articleId":"A-1"},{"id":"C-2","text":"Officials denied that a flood relief package was announced.","polarity":"negating","articleId":"A-4"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"articleCount":{"type":"number"},"sections":{"type":"object","properties":{"originalSources":{"type":"object","properties":{"clusterCount":{"type":"number"}},"additionalProperties":true},"syndication":{"type":"object","properties":{"clusterCount":{"type":"number"}},"additionalProperties":true},"claims":{"type":"object","properties":{"claimCount":{"type":"number"}},"additionalProperties":true},"claimMatches":{"type":"object","properties":{"claimCount":{"type":"number"}},"additionalProperties":true},"timeline":{"type":"object","properties":{"eventCount":{"type":"number"}},"additionalProperties":true},"corrections":{"type":"object","properties":{"correctionSignalCount":{"type":"number"}},"additionalProperties":true},"independence":{"type":"object","properties":{"distinctOutletCount":{"type":"number"},"syndicatedClusterCount":{"type":"number"}},"additionalProperties":true},"contradictions":{"type":"object","properties":{"pairCount":{"type":"number"}},"additionalProperties":true},"country":{"type":"object","properties":{"country":{"type":"string"},"articleCount":{"type":"number"}},"additionalProperties":true}},"additionalProperties":true},"note":{"type":"string"},"originalSources":{"type":"array","items":{"type":"object","properties":{"clusterId":{"type":"string"},"originalArticleId":{"type":"string"},"originalOutlet":{"type":"string"},"originalUrl":{"type":"string"},"originalPublishedAt":{"type":"string"},"reprintCount":{"type":"number"},"articleIds":{"type":"array","items":{"type":"string"}},"outlets":{"type":"array","items":{"type":"string"}},"repeatedPublicationTreatedAsConfirmation":{"type":"boolean"},"independentConfirmationClaimed":{"type":"boolean"}},"additionalProperties":true}},"syndication":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"articleIds":{"type":"array","items":{"type":"string"}},"outlets":{"type":"array","items":{"type":"string"}},"earliestId":{"type":"string"},"earliestPublishedAt":{"type":"string"},"similarity":{"type":"number"},"independentConfirmationClaimed":{"type":"boolean"},"repeatedPublicationTreatedAsConfirmation":{"type":"boolean"}},"additionalProperties":true}},"contradictions":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"leftClaimId":{"type":"string"},"rightClaimId":{"type":"string"},"overlap":{"type":"number"},"leftPolarity":{"type":"string"},"rightPolarity":{"type":"string"},"leftArticleId":{"type":"string"},"rightArticleId":{"type":"string"},"independentConfirmationClaimed":{"type":"boolean"},"repeatedPublicationTreatedAsConfirmation":{"type":"boolean"}},"additionalProperties":true}},"repeatedPublicationTreatedAsConfirmation":{"type":"boolean"},"independentConfirmationClaimed":{"type":"boolean"},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"publicSources":{"type":"array","items":{}},"findings":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"code":{"type":"string"},"subject":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T21:00:00.000Z","status":"reported","articleCount":3,"sections":{"originalSources":{"clusterCount":2},"syndication":{"clusterCount":1},"claims":{"claimCount":2},"claimMatches":{"claimCount":2},"timeline":{"eventCount":3},"corrections":{"correctionSignalCount":1},"independence":{"distinctOutletCount":2,"syndicatedClusterCount":1},"contradictions":{"pairCount":1},"country":{"country":"","articleCount":3}},"note":"Repeated or syndicated publication of the same claim is counted as a repeat only and is never treated as independent confirmation.","originalSources":[{"clusterId":"CL-1","originalArticleId":"A-1","originalOutlet":"Official Wire","originalUrl":"","originalPublishedAt":"2026-10-01T08:00:00.000Z","reprintCount":1,"articleIds":["A-1","A-2"],"outlets":["Official Wire","City Paper"],"repeatedPublicationTreatedAsConfirmation":false,"independentConfirmationClaimed":false},{"clusterId":"CL-2","originalArticleId":"A-3","originalOutlet":"City Paper","originalUrl":"","originalPublishedAt":"2026-10-02T09:00:00.000Z","reprintCount":0,"articleIds":["A-3"],"outlets":["City Paper"],"repeatedPublicationTreatedAsConfirmation":false,"independentConfirmationClaimed":false}],"syndication":[{"id":"CL-1","articleIds":["A-1","A-2"],"outlets":["Official Wire","City Paper"],"earliestId":"A-1","earliestPublishedAt":"2026-10-01T08:00:00.000Z","similarity":0.72,"independentConfirmationClaimed":false,"repeatedPublicationTreatedAsConfirmation":false}],"contradictions":[{"kind":"contradiction","leftClaimId":"C-1","rightClaimId":"C-2","overlap":0.667,"leftPolarity":"affirming","rightPolarity":"negating","leftArticleId":"A-1","rightArticleId":"A-4","independentConfirmationClaimed":false,"repeatedPublicationTreatedAsConfirmation":false}],"repeatedPublicationTreatedAsConfirmation":false,"independentConfirmationClaimed":false,"paidProviderUsed":false,"apiKeyRequired":false,"publicSources":[],"findings":[{"kind":"observation","code":"syndication_or_repeat","subject":"A-1","detail":"Similar articles were clustered. Repeated publication is not independent confirmation."},{"kind":"observation","code":"claim_repeat","subject":"C-1","detail":"The same or similar claim appears in multiple articles. Repeats are not independent confirmation."},{"kind":"observation","code":"claim_repeat","subject":"C-2","detail":"The same or similar claim appears in multiple articles. Repeats are not independent confirmation."},{"kind":"observation","code":"correction_signal","subject":"A-3","detail":"Correction/update wording or an updatedAt distinct from publishedAt was found."},{"kind":"observation","code":"non_independent_repeat","subject":"A-1","detail":"Article participates in a similar/syndicated cluster and is not counted as independent confirmation."},{"kind":"observation","code":"non_independent_repeat","subject":"A-2","detail":"Article participates in a similar/syndicated cluster and is not counted as independent confirmation."},{"kind":"conflict","code":"claim_contradiction","subject":"C-1|C-2","detail":"Affirming and negating claims with overlapping content were found."},{"kind":"observation","code":"country_unfiltered","subject":"","detail":"No country filter was supplied, so all articles/events are listed."}],"limitations":["Articles, claims, and events are copied only from labeled fields supplied by the caller, or from a key-free public RSS/Atom response when an rss.url is requested.","No paid news API is used and no API key is required.","Repeated publication or syndication of the same claim is never treated as independent confirmation.","Claim extraction uses local heuristics on supplied text. Missing quotes and attributions are not invented.","Source independence counts distinct outlets only; similar or syndicated copies stay labeled as non-independent repeats."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.08"},"protocols":[{"x402":{}}]}}}},"components":{"schemas":{"ApiError":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}}