Overview#

Seek Alliance is a marriage compatibility analysis platform that leverages Vedic astrology to evaluate the astrological compatibility between potential marriage partners. The service generates detailed horoscopes for both the bride and groom based on their birth data, then produces a comprehensive marriage compatibility report in PDF format.

This tool is ideal for matrimonial platforms, astrology consultants, and individuals seeking detailed astrological insights into potential marriages. By analyzing planetary positions and natal chart configurations, the API provides scientifically-grounded astrological assessments that help couples understand their cosmic compatibility across multiple dimensions.

The platform supports multiple Indian languages (Tamil, English, Malayalam, Telugu, Kannada, and Hindi) and both South Indian and North Indian astrological chart systems, making it accessible to diverse user bases across India and the diaspora.

Usage#

Request#

To generate a marriage compatibility report, submit birth details for both the bride and groom. The system will generate three PDF reports: one for the bride's horoscope, one for the groom's horoscope, and one comprehensive marriage matching report.

json

{
  "bride": {
    "person_name": "Anjali Sharma",
    "father_name": "Rajesh Sharma",
    "mother_name": "Priya Sharma",
    "mobile": "9876543210",
    "dob": "15/Jan/1995",
    "hour": "10",
    "minute": "30",
    "am_pm": "AM",
    "country": "India",
    "birth_place": "Chennai"
  },
  "groom": {
    "person_name": "Arjun Patel",
    "father_name": "Vikram Patel",
    "mother_name": "Meera Patel",
    "mobile": "9123456789",
    "dob": "22/Mar/1993",
    "hour": "02",
    "minute": "15",
    "am_pm": "PM",
    "country": "India",
    "birth_place": "Bangalore"
  },
  "language_id": "2",
  "chart_type": "South Indian"
}

Response#

json

{
  "success": true,
  "message": "Marriage compatibility analysis completed successfully",
  "bride_pdf_url": "https://api.mkkpro.com/downloads/Anjali_Sharma_horoscope_1234567890.pdf",
  "groom_pdf_url": "https://api.mkkpro.com/downloads/Arjun_Patel_horoscope_1234567890.pdf",
  "match_pdf_url": "https://api.mkkpro.com/downloads/marriage_match_report_1234567890.pdf",
  "generated_at": "2024-01-15T14:30:00Z"
}

Endpoints#

POST /api/seek-alliance#

Generates horoscopes and marriage compatibility report for a bride-groom pair.

Parameters:

NameTypeRequiredDescriptionbridePersonData objectYesBride (female) personal and birth detailsgroomPersonData objectYesGroom (male) personal and birth detailslanguage_idstringNoLanguage for report generation: 1 =Tamil, 2 =English, 3 =Malayalam, 4 =Telugu, 5 =Kannada, 6 =Hindi (default: 1)chart_typestringNoAstrological chart system: South Indian or North Indian (default: South Indian)

PersonData Fields:

NameTypeRequiredDescriptionperson_namestringYesPerson's full namefather_namestringYesFather's namemother_namestringYesMother's namemobilestringYes10-digit mobile numberdobstringYesDate of birth in DD/Mon/YYYY format (e.g., 15/Jan/1995)hourstringYesBirth hour in 12-hour format (1-12)minutestringYesBirth minute (00-59)am_pmstringYesTime period: AM or PMcountrystringYesCountry code or namebirth_placestringYesBirth city name

Response Schema:

FieldTypeDescriptionsuccessbooleanWhether the operation completed successfullymessagestring | nullHuman-readable status or error messagebride_pdf_urlstring | nullURL to download the bride's horoscope PDFgroom_pdf_urlstring | nullURL to download the groom's horoscope PDFmatch_pdf_urlstring | nullURL to download the marriage compatibility report PDFgenerated_atstring | nullISO 8601 timestamp of report generation

Response Codes:

• 200 OK - Reports generated successfully
• 422 Unprocessable Entity - Validation error in request data

---

GET /api/search-city#

Search for a city to retrieve accurate coordinates and timezone information for birth location.

Parameters:

NameTypeRequiredDescriptionsearchstringYesCity name or partial city name to searchcountrystringNoCountry filter (default: India)

Response Schema:

Returns JSON array of matching cities with geographic and timezone data for accurate horoscope calculations.

Response Codes:

• 200 OK - Cities found
• 422 Unprocessable Entity - Validation error

---

GET /api/status#

Check the health and operational status of the API service.

Parameters: None

Response Schema:

Returns JSON object indicating service status and uptime information.

Response Codes:

• 200 OK - Service is operational

---

GET /#

Root endpoint providing API information and available operations.

Parameters: None

Response Schema:

Returns JSON with API metadata and endpoint summary.

Response Codes:

• 200 OK - Service is available

---

GET /downloads/{filename}#

Download generated PDF reports using the filename provided in the alliance response.

Parameters:

NameTypeRequiredDescriptionfilenamestringYesName of the file to download (from bride_pdf_url, groom_pdf_url, or match_pdf_url response)

Response: PDF file binary data

Response Codes:

• 200 OK - File downloaded successfully
• 422 Unprocessable Entity - Invalid filename

Pricing#

PlanCalls/DayCalls/MonthPriceFree550FreeDeveloper20500$39/moProfessional2005,000$99/moEnterprise100,0001,000,000$299/mo

About#

ToolWeb.in - 200+ security APIs, CISSP & CISM, platforms: Pay-per-run, API Gateway, MCP Server, OpenClaw, RapidAPI, YouTube.

• toolweb.in
• portal.toolweb.in
• hub.toolweb.in
• toolweb.in/openclaw/
• rapidapi.com/user/mkrishna477
• youtube.com/@toolweb-009

References#

• Kong Route: https://api.mkkpro.com/lifestyle/marriage-matching
• API Docs: https://api.mkkpro.com:8197/docs