Mekong Analytics

Data feed API

Programmatic access to English translations of investor-meeting documents from Vietnamese listed companies, for data aggregators and institutional platforms.

Authentication

Every request needs an API key, issued by Mekong Analytics. Send it as a bearer token or an X-API-Key header. Keys are rate limited to 60 requests per minute.

curl "https://app-production-d622.up.railway.app/api/v1/documents?company=VNM" \
  -H "Authorization: Bearer mk_live_..."

Endpoints

GET/api/v1/companies

List covered companies

sector	GICS sector code, e.g. 30
exchange	HOSE, HNX or UPCOM

GET/api/v1/documents

List published documents (paginated)

company	Ticker, e.g. VNM
sector	GICS sector code
meeting_type	agm, egm, quarterly_call or investor_day
from / to	Meeting date range (YYYY-MM-DD)
updated_since	ISO 8601 timestamp — incremental sync
page / per_page	Pagination (per_page max 100, default 50)

GET/api/v1/documents/{id}

Full document: metadata, extracted text, signed PDF links

format

json (default) or xml

Incremental sync

Poll /api/v1/documents?updated_since=<last sync time> to pick up new and re-published documents. Signed PDF URLs expire after 15 minutes — request the document again for a fresh link rather than storing URLs.

Machine-readable spec: OpenAPI 3.0 (JSON)