API Documentation

REST API for AI agents to discover Malaysian websites, businesses, tools, and services. All endpoints return JSON. Zero LLM in the read path.

Base URL: https://www.takde.org

Authentication

API keys are optional (free, open access). Register for rate limit tracking:

// Register a free API key
POST /api/auth/register
Content-Type: application/json

{"agent_name": "My Search Agent"}

Pass as: Authorization: Bearer tk_xxx (preferred) or ?api_key=tk_xxx

Endpoints

POST /api/discover

Search the index with structured filters. All parameters optional.

{
  "type": "business",
  "sub_type": "dentist",
  "city": "Petaling Jaya",
  "tags_include": ["24h"],
  "location": {"lat": 3.107, "lng": 101.607, "radius_km": 5},
  "intent": "find_service",
  "sort": "relevance",
  "limit": 10
}

Parameter	Type	Description
`q`	string	Full-text search keyword
`type`	string	business, blog, news, ecommerce, government, education, restaurant, tool, organization, nonprofit, religious
`sub_type`	string	60+ categories: dentist, cafe, hotel, school, manufacturer... Full list
`tags_include`	string[]	Must have ALL: 24h, halal, whatsapp, delivery...
`location`	object	{lat, lng, radius_km, city, country}
`intent`	string	find_service, find_product, find_information, find_tool, compare
`sort`	string	relevance, distance, rating, updated, confidence
`limit`	int	1–50 (default 10)

GET /api/lookup?url={url}

Look up a specific URL. Returns its structured profile if in the index.

GET /api/lookup?url=https://aimst.edu.my

GET /api/content/{profileId}

Full markdown content of a profile. Optional: ?max_length=5000

GET /api/profile/{slug}/{format}

Export profile in multiple formats:

Format	Content-Type	Example
`json`	application/json	`/api/profile/aimst-edu-my/json`
`agent.json`	application/json	`/api/profile/aimst-edu-my/agent.json`
`llms.txt`	text/plain	`/api/profile/aimst-edu-my/llms.txt`
`context.txt`	text/plain	`/api/profile/aimst-edu-my/context.txt`
`md`	text/markdown	`/api/profile/aimst-edu-my/md`

POST /api/feedback

Report quality issues: {"profile_id": "...", "type": "inaccuracy", "details": "..."}

Types: inaccuracy, closed, wrong_category, duplicate, missing_info, outdated, confirmed_accurate

POST /api/report-selection

Track which result was used: {"session_id": "ses_xxx", "selected_id": "..."}

POST /api/scan

Scan any URL for its ACID Score: {"url": "https://example.com"}

Rate Limits

Endpoint	Per Minute	Per Day
`discover`	100	10,000
`lookup`	200	20,000
`content`	50	5,000
`scan`	10	—

Exceeding returns 429 with Retry-After header.

MCP Server

Takde provides an MCP Server for direct agent integration. 5 tools: discover, lookup, get_content, feedback, report_selection.

Source: scripts/mcp-server/ in the GitHub repo

Agent Discovery Files

/llms.txt — LLM-readable site description with full API schema
/.well-known/agent.json — Agent Web Protocol capability declaration
/context.txt — ProtoContext format
/robots.txt — Allows all AI bots
/sitemap.xml — Dynamic sitemap with all profiles