Developers
Developer Documentation
REST API reference. Base URL: https://apimediaalertpress.com/v1
Authentication
HMAC-SHA256. Signature = HMAC-SHA256(secret, method+"n"+path+"n"+timestamp)
Headers: X-MAP-Signature, X-MAP-Timestamp (Unix seconds, ±300s tolerance).
POST /verify
{ "url": "https://example.com/article" }
Response 200
{
"url": "https://example.com/article",
"context_record": {
"context_id": { "sentences": [ { "text": "Assigned context ID ctx_9f3a1b for this URL." } ] },
"why_now": { "sentences": [ { "text": "Published the same day as a related regulatory announcement." } ] },
"authority_scope": { "sentences": [ { "text": "Byline attributes the piece to a named staff reporter with an editorial contact link." } ] },
"sources": { "sentences": [ { "text": "Cites two named officials and one public filing." }, { "text": "No anonymous sources are used." } ] },
"details": { "sentences": [ { "text": "Includes specific dates, dollar figures, and named parties throughout." } ] },
"timing": { "sentences": [ { "text": "Published roughly 3 hours after the referenced event." } ] },
"framing": { "sentences": [ { "text": "Presented as a straight news report rather than commentary." } ] },
"reader_orientation": { "sentences": [ { "text": "Links to two prior articles for background on the same topic." } ] },
"historical_context": { "sentences": [ { "text": "References a comparable event from 2023." } ] },
"comparable_coverage": { "sentences": [ { "text": "Three other outlets covered the same event within 6 hours." } ] },
"referenced_material": { "references": [ { "title": "Original Press Release", "publisher": "Example Agency", "date": "2026-07-20", "url": "https://example.gov/release" } ] },
"context_memory_note": { "sentences": [ { "text": "This domain has 12 prior context records on the ledger." } ] },
"context_complete": { "sentences": [ { "text": "All 7 dimensions were populated from available source material." } ] }
},
"ledger_id": "ldr_abc123",
"timestamp": 1751000000
}
GET /signal/{domain}
{ "domain": "bbc.com", "records": 42, "most_recent_at": "2026-07-20T14:32:00Z", "ledger_hash": "a3f9c2e1d8b74560...", "generated_at": "2026-07-22T09:15:00Z" }
GET /indices/miq/all
[ { "domain":"bbc.com", "miq":94, "tier":"tier1", "updated":"2026-06-01" }, ... ]
Error codes
Full spec: apimediaalertpress.com/openapi.json