# Sithmini.com

> Sri Lanka's matrimony and astrology platform. Search and browse public matrimony profiles, horoscope reports, and porondam matching across Sri Lanka.

## Agent discovery

- Canonical site: https://sithmini.com
- Sitemap: https://sithmini.com/sitemap.xml
- Search UI: https://sithmini.com/matrimony/browse (criteria filters: gender, minAge, maxAge, religion, ethnicity, district, civilStatus, education; free text via q)
- OpenSearch: https://sithmini.com/opensearch.xml
- OpenAPI: https://sithmini.com/openapi.json
- Plugin-style manifest: https://sithmini.com/.well-known/ai-plugin.json
- Public pages are server-rendered HTML and can be crawled without authentication.
- Private account, org, payment, draft, ingest, and write API routes are blocked in robots.txt.
- Meta/Facebook fetchers such as meta-externalagent, meta-externalfetcher, and facebookexternalhit are allowed to reach public pages and discovery endpoints through the wildcard robots.txt policy.

## Search API

Endpoint: GET /api/search?q=<query>&limit=<1-50>

Returns JSON with public matrimony profiles matching the free-text query. No authentication required.

Example:

```
https://sithmini.com/api/search?q=sinhala%20buddhist%20doctor%20colombo&limit=10
```

### Response format

```json
{
  "query": "string",
  "total": "number",
  "results": [
    {
      "id": "string",
      "title": "string",
      "vertical": "matrimony",
      "verticalLabel": "string",
      "price": "null (kept for compatibility)",
      "priceSuffix": "null (kept for compatibility)",
      "currency": "null (kept for compatibility)",
      "district": "string",
      "city": "string",
      "category": "string | null (profession)",
      "thumbnail": "string | null (cover photo, only when the member shows photos)",
      "url": "string (full URL to the profile)",
      "postedAt": "string (ISO 8601)"
    }
  ]
}
```

## Categories

- **Matrimony** (/matrimony/browse): Public matrimony profiles
- **Horoscope** (/horoscope): Vedic birth-chart and match reports
- **Porondam Matching** (/tools/porondam): Free porondam compatibility check

## Location

Profiles list a Sri Lankan home district + city; members living overseas also list their country of residence.

## Notes

- A thumbnail is included only when the member has chosen to show photos
- No authentication is required for search
- Rate limiting may apply
- Send users to the result `url` on sithmini.com for the full profile, interest and contact options, and safety information
- Contact details, private photos and horoscopes are never included in search results; they are shared only between members after mutual interest is accepted