Skip to main content

Developers

MAP API

Build source-linked context into your systems.

A RESTful API for automated context records and public ledger lookups. Base URL: https://apimediaalertpress.com/v1


Endpoints

POST
/verify

URL Verification

Submit a URL. Returns a context record documenting the observable information around it. Requires an API key; served at https://apimediaalertpress.com/v1.

GET
/feed/signals

Signal Feed

Public, no key. The 100 most recent ledger entries; no pagination. Served at https://mediaalertpress.com/wp-json/map/v1/feed/signals.

GET
/record/{record_id}

Record Lookup

Public, no key; feed-ingested records only; rate limited. Returns the MAP record object for one record ID: its seven context frames, observation times and chain position. Example: https://mediaalertpress.com/wp-json/map/v1/record/0fae7262-852e-4263-b478-cdbe84db720c

GET
/record?url=

Record by URL

Public, no key; feed-ingested records only; rate limited. Returns the latest MAP record for a URL, or 404 if MAP has none. Example: https://mediaalertpress.com/wp-json/map/v1/record?url=https://example.com/news/article

GET
/ledger/stats

Ledger Statistics

Public, no key; feed-ingested records only; rate limited. Returns the total number of ledger entries. Example: https://mediaalertpress.com/wp-json/map/v1/ledger/stats

GET
/feed/map-records/

Recent Records Feed (RSS)

Public, no key; feed-ingested records only; rate limited. The newest records MAP has made from the news feeds it monitors. Served at https://mediaalertpress.com/feed/map-records/

GET
/feed/map-changes/

What Changed Feed (RSS)

Public, no key; feed-ingested records only; rate limited. Observed differences between repeat observations of the same URL; they do not establish which version is correct. Served at https://mediaalertpress.com/feed/map-changes/

Authentication

Send your API key in the x-api-key header. API keys are issued automatically once self-serve plans open (they are not open yet): after a successful paid-plan checkout on the pricing page, a key is emailed to you. Enterprise keys are issued on request. The GET endpoints below are public and need no key.

OpenAPI spec: https://apimediaalertpress.com/openapi.json

See plans and API keys