/api/v2/vedic/muhurat/searchНайдите диапазон дат для общедоступных ведических благоприятных окон, используя правила Мухурата purpose-specific, коэффициенты Panchang и вычитание avoid-period.
Аутентификация: отправьте x-api-key.
https://api.freeastroapi.com/api/v2/vedic/muhurat/searchIdempotency-KeyАутентифицированные платные astrology POST-запросы принимают необязательный заголовок Idempotency-Key: <уникальный ключ операции, созданный клиентом>. Повторно используйте тот же ключ только при повторе точно того же method, path, query string и JSON body после timeout или сетевой ошибки.
Завершенный повтор возвращает первый ответ с Idempotency-Replayed: true, не запускает расчет заново и не расходует дополнительную квоту. Ключи хранятся примерно 24 часа.
Повторное использование ключа с измененным запросом возвращает 409 idempotency_key_reused. Дубликат, пока первый запрос еще выполняется, возвращает 409 request_in_progress с Retry-After.
Ранжированный список общедоступных благоприятных окон для запрошенной цели, включая время начала/окончания, продолжительность, оценку, качество, исходные периоды, предупреждения, критерии цели и метаданные расчета.
Конечная точка общедоступного поиска нормализует псевдонимы в одно из поддерживаемых значений назначения, указанных ниже. Режимы Purpose-specific сначала рассчитывают локальные интервалы Panchang, затем пересекают благоприятные периоды титхи и накшатры с любым днем недели, lunar-month, продолжительностью или правилами Лагны для этой деятельности. Rahu Kaal, Bhadra, and Panchak are not hidden; перекрытия возвращаются в критериях и предупреждениях, чтобы клиенты могли объяснить, почему окно может нуждаться в осторожности.
general_workРанжирует в целом благоприятные ежедневные периоды, такие как Абхиджит Мухурат, благоприятные периоды Чаугхадия/Гаури и поддерживающие периоды Хора, затем вычитает совпадения Rahu Каал, Бхадра и Панчак.
Принимаются псевдонимы: общий, родовой
vehicle_purchaseТребует благоприятных пересечений титхи, накшатр и дней недели, исключает Адхик Маас, отклоняет короткие фрагменты ниже калиброванного порога продолжительности и требует перекрытия с выбранными благоприятными знаками Лагны для приобретения средства передвижения.
Принимаются псевдонимы: транспортное средство, машина, car_purchase
property_purchaseИспользует property-specific благоприятные пересечения титхи и накшатр для стабильности и приобретения, исключает Адхик Мааса и сохраняет видимыми перекрытия Rahu Каал, Бхадра и Панчак в качестве предупреждений.
Принимаются псевдонимы: недвижимость, land_purchase
griha_praveshТребует благоприятных комбинаций титхи, накшатры, дней недели и лунных месяцев для входа в дом, исключает Адхик Маас и отмечает перекрытие avoid-period, чтобы все публичное окно оставалось проверяемым.
Принимаются псевдонимы: griha_pravesha, новоселье, home_entry
namkaranИспользует правила титхи, накшатры и дней недели naming-ceremony, исключает Адхика Мааса и возвращает соответствующие общедоступные окна с критериями Panchang и предупреждениями avoid-period.
Принимаются псевдонимы: именование, naming_ceremony
mundanОбъединяет благоприятные титхи Mundan-specific, накшатры, будние дни и лунные месяцы, исключает Адхик Мааса и выставляет на рассмотрение астролога совпадения avoid-period.
Принимаются псевдонимы: mundan_ceremony, first_haircut
curl -X POST "https://api.freeastroapi.com/api/v2/vedic/muhurat/search" \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
"purpose": "vehicle_purchase",
"start_date": "2026-04-01",
"end_date": "2026-04-30",
"city": "New Delhi",
"lat": 28.62137,
"lng": 77.2148,
"ayanamsha": "lahiri",
"language": "en",
"limit": 3
}'Предоставьте либо city или оба lat and lng. Координаты рекомендуются для стабильных результатов производства.
| Field | Type | Required | Description |
|---|---|---|---|
| purpose | string | No | Цель поиска. Поддерживаемые значения: general_work, vehicle_purchase, property_purchase, griha_pravesh, namkaran и mundan. |
| start_date | string | Yes | Включая локальную дату начала как YYYY-MM-DD. |
| end_date | string | Yes | Включая локальную дату окончания в формате YYYY-MM-DD. Максимум 31 день. |
| city | string | No | Название локации. Необязательно, если имеется lat/lng. |
| lat | float | No | Широта. Рекомендуется для стабильных производственных результатов. |
| lng | float | No | Долгота. Рекомендуется для стабильных производственных результатов. |
| tz_str | string | No | Необязательное переопределение часового пояса, например Asia/Kolkata, Europe/London, AUTO или LMT. По умолчанию используется AUTO, если опущено. |
| ayanamsha | string | No | Ведическая айанамша. По умолчанию — lahiri. |
| language | string | No | Язык ответа. В настоящее время поддерживается только en. |
| limit | integer | No | Максимальное количество best_windows в ответе. Допустимый range: 1-50. По умолчанию 10. |
| Field | Type | Required | Description |
|---|---|---|---|
| purpose | string | n/a | Нормализованная цель поиска purpose. |
| range | object | n/a | Дата начала, дата окончания и количество дней поиска. |
| best_windows | array | n/a | Ранжированные публичные благоприятные windows для запрошенного purpose. |
| best_windows[].score | integer | n/a | Оценка публичного рейтинга окна. |
| best_windows[].quality | string | n/a | Метка quality для окна, например auspicious. |
| best_windows[].criteria | object | n/a | Целевые правила, коэффициенты Panchang, перекрытие периодов предотвращения и исходные периоды, используемые для окна. |
| best_moment | object | n/a | Присутствует только тогда, когда строгий персонализированный слой выбирает точный момент; null для общего публичного поиска. |
| metadata | object | n/a | Версия конечной точки, набор правил, айанамша, часовой пояс, основа расчета и примечания к поиску. |
В этом запросе выполняется поиск общедоступных окон Мухурата о покупке транспортных средств в Нью-Дели в апреле 2026 года.
{
"purpose": "vehicle_purchase",
"start_date": "2026-04-01",
"end_date": "2026-04-30",
"city": "New Delhi",
"lat": 28.62137,
"lng": 77.2148,
"ayanamsha": "lahiri",
"language": "en",
"limit": 3
}Этот ответ был сгенерирован из текущей реализации конечной точки V2 для примера полезной нагрузки.
{
"acceptable_moments": [],
"avoid_moments": [],
"best_moment": null,
"best_windows": [
{
"best_moment": null,
"criteria": {
"avoid_periods": [
{
"end": "2026-04-01T19:23:43.161303+05:30",
"name": "Bhadra",
"start": "2026-04-01T07:09:16.417423+05:30",
"status": "warning_overlap"
}
],
"duration": {
"minimum_minutes": 240,
"status": "meets_minimum",
"value_minutes": 832.78
},
"lagna": {
"allowed_signs": [
{
"name": "Gemini",
"sign_id": 3
},
{
"name": "Cancer",
"sign_id": 4
},
{
"name": "Leo",
"sign_id": 5
},
{
"name": "Virgo",
"sign_id": 6
},
{
"name": "Scorpio",
"sign_id": 8
},
{
"name": "Sagittarius",
"sign_id": 9
},
{
"name": "Pisces",
"sign_id": 12
}
],
"matched_signs": [
{
"name": "Leo",
"sample_time": "2026-04-01T16:18:08.351510+05:30",
"sign_id": 5
},
{
"name": "Virgo",
"sample_time": "2026-04-01T18:00:00+05:30",
"sign_id": 6
},
{
"name": "Scorpio",
"sample_time": "2026-04-01T22:00:00+05:30",
"sign_id": 8
},
{
"name": "Sagittarius",
"sample_time": "2026-04-02T01:00:00+05:30",
"sign_id": 9
},
{
"name": "Pisces",
"sample_time": "2026-04-02T06:00:00+05:30",
"sign_id": 12
}
],
"status": "overlaps_favorable_lagna"
},
"lunar_month": {
"status": "not_restricted",
"value": "Chaitra"
},
"nakshatra": {
"status": "favorable",
"value": "Hasta"
},
"publication_window": {
"max_start_hour": 25,
"status": "within_calibrated_start_range"
},
"purpose": {
"label": "Vehicle Purchase Muhurat",
"status": "selected",
"value": "vehicle_purchase"
},
"tithi": {
"status": "favorable",
"value": "Poornima"
},
"weekday": {
"status": "favorable",
"value": "Wednesday"
}
},
"date": "2026-04-01",
"duration_minutes": 832.78,
"end": "2026-04-02T06:10:55.359326+05:30",
"end_time": "30:10:55",
"personal_score": null,
"public_score": null,
"quality": "auspicious",
"reasons": [
"Vehicle Purchase Muhurat",
"Poornima Tithi",
"Hasta Nakshatra",
"Chaitra lunar month",
"Auspicious Lagna"
],
"score": 94,
"source_periods": [
"Vehicle Purchase Muhurat",
"Poornima Tithi",
"Hasta Nakshatra",
"Auspicious Lagna"
],
"start": "2026-04-01T16:18:08.351510+05:30",
"start_time": "16:18:08",
"warnings": [
"Overlaps Bhadra."
]
},
{
"best_moment": null,
"criteria": {
"avoid_periods": [
{
"end": "2026-04-02T15:32:21.417644+05:30",
"name": "Rahu Kaal",
"start": "2026-04-02T13:58:39.574591+05:30",
"status": "warning_overlap"
}
],
"duration": {
"minimum_minutes": 240,
"status": "meets_minimum",
"value_minutes": 1439.17
},
"lagna": {
"allowed_signs": [
{
"name": "Gemini",
"sign_id": 3
},
{
"name": "Cancer",
"sign_id": 4
},
{
"name": "Leo",
"sign_id": 5
},
{
"name": "Virgo",
"sign_id": 6
},
{
"name": "Scorpio",
"sign_id": 8
},
{
"name": "Sagittarius",
"sign_id": 9
},
{
"name": "Pisces",
"sign_id": 12
}
],
"matched_signs": [
{
"name": "Pisces",
"sample_time": "2026-04-02T06:10:36.359326+05:30",
"sign_id": 12
},
{
"name": "Gemini",
"sample_time": "2026-04-02T11:00:00+05:30",
"sign_id": 3
},
{
"name": "Cancer",
"sample_time": "2026-04-02T13:00:00+05:30",
"sign_id": 4
},
{
"name": "Leo",
"sample_time": "2026-04-02T15:00:00+05:30",
"sign_id": 5
},
{
"name": "Virgo",
"sample_time": "2026-04-02T18:00:00+05:30",
"sign_id": 6
},
{
"name": "Scorpio",
"sample_time": "2026-04-02T22:00:00+05:30",
"sign_id": 8
},
{
"name": "Sagittarius",
"sample_time": "2026-04-03T01:00:00+05:30",
"sign_id": 9
}
],
"status": "overlaps_favorable_lagna"
},
"lunar_month": {
"status": "not_restricted",
"value": "Chaitra"
},
"nakshatra": {
"status": "favorable",
"value": "Hasta / Chitra"
},
"publication_window": {
"max_start_hour": 25,
"status": "within_calibrated_start_range"
},
"purpose": {
"label": "Vehicle Purchase Muhurat",
"status": "selected",
"value": "vehicle_purchase"
},
"tithi": {
"status": "favorable",
"value": "Poornima / Pratipada"
},
"weekday": {
"status": "favorable",
"value": "Thursday"
}
},
"date": "2026-04-02",
"duration_minutes": 1439.17,
"end": "2026-04-03T06:09:46.767503+05:30",
"end_time": "30:09:46",
"personal_score": null,
"public_score": null,
"quality": "auspicious",
"reasons": [
"Vehicle Purchase Muhurat",
"Poornima / Pratipada Tithi",
"Hasta / Chitra Nakshatra",
"Chaitra lunar month",
"Auspicious Lagna"
],
"score": 94,
"source_periods": [
"Vehicle Purchase Muhurat",
"Poornima / Pratipada Tithi",
"Hasta / Chitra Nakshatra",
"Auspicious Lagna"
],
"start": "2026-04-02T06:10:36.359326+05:30",
"start_time": "06:10:36",
"warnings": [
"Overlaps Rahu Kaal."
]
},
{
"best_moment": null,
"criteria": {
"avoid_periods": [],
"duration": {
"minimum_minutes": 240,
"status": "meets_minimum",
"value_minutes": 766.08
},
"lagna": {
"allowed_signs": [
{
"name": "Gemini",
"sign_id": 3
},
{
"name": "Cancer",
"sign_id": 4
},
{
"name": "Leo",
"sign_id": 5
},
{
"name": "Virgo",
"sign_id": 6
},
{
"name": "Scorpio",
"sign_id": 8
},
{
"name": "Sagittarius",
"sign_id": 9
},
{
"name": "Pisces",
"sign_id": 12
}
],
"matched_signs": [
{
"name": "Cancer",
"sample_time": "2026-04-06T14:11:31.352926+05:30",
"sign_id": 4
},
{
"name": "Leo",
"sample_time": "2026-04-06T15:00:00+05:30",
"sign_id": 5
},
{
"name": "Virgo",
"sample_time": "2026-04-06T17:00:00+05:30",
"sign_id": 6
},
{
"name": "Scorpio",
"sample_time": "2026-04-06T22:00:00+05:30",
"sign_id": 8
},
{
"name": "Sagittarius",
"sample_time": "2026-04-07T00:00:00+05:30",
"sign_id": 9
}
],
"status": "overlaps_favorable_lagna"
},
"lunar_month": {
"status": "not_restricted",
"value": "Chaitra"
},
"nakshatra": {
"status": "favorable",
"value": "Anuradha"
},
"publication_window": {
"max_start_hour": 25,
"status": "within_calibrated_start_range"
},
"purpose": {
"label": "Vehicle Purchase Muhurat",
"status": "selected",
"value": "vehicle_purchase"
},
"tithi": {
"status": "favorable",
"value": "Panchami"
},
"weekday": {
"status": "favorable",
"value": "Monday"
}
},
"date": "2026-04-06",
"duration_minutes": 766.08,
"end": "2026-04-07T02:57:35.995205+05:30",
"end_time": "26:57:35",
"personal_score": null,
"public_score": null,
"quality": "auspicious",
"reasons": [
"Vehicle Purchase Muhurat",
"Panchami Tithi",
"Anuradha Nakshatra",
"Chaitra lunar month",
"Auspicious Lagna"
],
"score": 94,
"source_periods": [
"Vehicle Purchase Muhurat",
"Panchami Tithi",
"Anuradha Nakshatra",
"Auspicious Lagna"
],
"start": "2026-04-06T14:11:31.352926+05:30",
"start_time": "14:11:31",
"warnings": []
}
],
"metadata": {
"ayanamsha": "lahiri",
"calculation_basis": "purpose_specific_tithi_nakshatra_intersections_with_avoid_period_warnings",
"calculation_notes": [
"Purpose-specific searches use calibrated tithi and nakshatra intersections for the requested activity.",
"Vehicle Purchase also requires overlap with an auspicious Lagna sample.",
"Adhik Maas is excluded for these ceremony searches.",
"Rahu Kaal, Bhadra, and Panchak overlaps are returned as warnings to preserve AstroSage-style full windows.",
"Vehicle Purchase omits short fragments below the calibrated publication-duration threshold."
],
"endpoint_version": "v2",
"personalization_basis": null,
"public_candidate_count": null,
"ruleset_version": "freeastro_muhurat_search_v2",
"sampling_interval_minutes": null,
"scan_months_requested": null,
"scanned_months": null,
"scanned_ranges": null,
"search_mode": null,
"strict_rejection_policy": null,
"strict_selection_status": null,
"strictness": null,
"subject": null,
"timezone_used": "Asia/Kolkata"
},
"no_compromise_moment": null,
"purpose": "vehicle_purchase",
"range": {
"day_count": 30,
"end_date": "2026-04-30",
"start_date": "2026-04-01"
},
"rejected_windows": [],
"selection_explanation": null
}Эта конечная точка является общедоступной и зависит от местоположения и даты. Он ранжирует благоприятные окна purpose-specific по факторам Panchang и избегает менструаций, но не использует карту рождения человека. Используйте персонализированный поиск Мухурат, когда требуется выбор натальной Тара Бала, Чандра Бала и event-chart.
Для некоторых целей предусмотрены строгие общедоступные фильтры, а короткий диапазон дат может не содержать соответствующих условий титхи, накшатры, дня недели и avoid-period. Ответ 200 с пустым массивом best_windows означает, что API завершил поиск и не нашел подходящих общедоступных окон.
Общедоступная конечная точка ограничена 31 днем на каждый запрос. Для более длительных рабочих процессов планирования называйте его помесячно и сохраняйте одни и те же входные данные о местоположении, чтобы результаты оставались сопоставимыми.
Оценка — это практический сигнал ранжирования для потребителей API, а не отдельный астрологический вердикт. Объект критериев показывает вспомогательные факторы Panchang, исходные периоды, предупреждения и контекст avoid-period, которые объясняют, почему было включено каждое окно.