Мухурат Поиск

POST/api/v2/vedic/muhurat/search

Найдите диапазон дат для общедоступных ведических благоприятных окон, используя правила Мухурата purpose-specific, коэффициенты Panchang и вычитание avoid-period.

Аутентификация: отправьте x-api-key.

Полный URL-адрес

https://api.freeastroapi.com/api/v2/vedic/muhurat/search
Безопасные повторы с Idempotency-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
purpose

Ранжирует в целом благоприятные ежедневные периоды, такие как Абхиджит Мухурат, благоприятные периоды Чаугхадия/Гаури и поддерживающие периоды Хора, затем вычитает совпадения Rahu Каал, Бхадра и Панчак.

Принимаются псевдонимы: общий, родовой

Покупка автомобиля

vehicle_purchase
purpose

Требует благоприятных пересечений титхи, накшатр и дней недели, исключает Адхик Маас, отклоняет короткие фрагменты ниже калиброванного порога продолжительности и требует перекрытия с выбранными благоприятными знаками Лагны для приобретения средства передвижения.

Принимаются псевдонимы: транспортное средство, машина, car_purchase

Покупка недвижимости

property_purchase
purpose

Использует property-specific благоприятные пересечения титхи и накшатр для стабильности и приобретения, исключает Адхик Мааса и сохраняет видимыми перекрытия Rahu Каал, Бхадра и Панчак в качестве предупреждений.

Принимаются псевдонимы: недвижимость, land_purchase

Гриха Правеш

griha_pravesh
purpose

Требует благоприятных комбинаций титхи, накшатры, дней недели и лунных месяцев для входа в дом, исключает Адхик Маас и отмечает перекрытие avoid-period, чтобы все публичное окно оставалось проверяемым.

Принимаются псевдонимы: griha_pravesha, новоселье, home_entry

Namkaran

namkaran
purpose

Использует правила титхи, накшатры и дней недели naming-ceremony, исключает Адхика Мааса и возвращает соответствующие общедоступные окна с критериями Panchang и предупреждениями avoid-period.

Принимаются псевдонимы: именование, naming_ceremony

Mundan

mundan
purpose

Объединяет благоприятные титхи Mundan-specific, накшатры, будние дни и лунные месяцы, исключает Адхик Мааса и выставляет на рассмотрение астролога совпадения avoid-period.

Принимаются псевдонимы: mundan_ceremony, first_haircut

Персонализированные чеки birth-chart намеренно выделены отдельно. Используйте персональный поиск Мухурат, когда вам нужна натальная Тара Бала, Чандра Бала, оценка события Лагны, строгий выбор best-moment, причины rejected-window или контекст самскары child-specific.

Пример запроса

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
purpose
Type
string
Required
No
Description
Цель поиска. Поддерживаемые значения: general_work, vehicle_purchase, property_purchase, griha_pravesh, namkaran и mundan.
Field
start_date
Type
string
Required
Yes
Description
Включая локальную дату начала как YYYY-MM-DD.
Field
end_date
Type
string
Required
Yes
Description
Включая локальную дату окончания в формате YYYY-MM-DD. Максимум 31 день.
Field
city
Type
string
Required
No
Description
Название локации. Необязательно, если имеется lat/lng.
Field
lat
Type
float
Required
No
Description
Широта. Рекомендуется для стабильных производственных результатов.
Field
lng
Type
float
Required
No
Description
Долгота. Рекомендуется для стабильных производственных результатов.
Field
tz_str
Type
string
Required
No
Description
Необязательное переопределение часового пояса, например Asia/Kolkata, Europe/London, AUTO или LMT. По умолчанию используется AUTO, если опущено.
Field
ayanamsha
Type
string
Required
No
Description
Ведическая айанамша. По умолчанию — lahiri.
Field
language
Type
string
Required
No
Description
Язык ответа. В настоящее время поддерживается только en.
Field
limit
Type
integer
Required
No
Description
Максимальное количество best_windows в ответе. Допустимый range: 1-50. По умолчанию 10.

Форма ответа

Field
purpose
Type
string
Required
n/a
Description
Нормализованная цель поиска purpose.
Field
range
Type
object
Required
n/a
Description
Дата начала, дата окончания и количество дней поиска.
Field
best_windows
Type
array
Required
n/a
Description
Ранжированные публичные благоприятные windows для запрошенного purpose.
Field
best_windows[].score
Type
integer
Required
n/a
Description
Оценка публичного рейтинга окна.
Field
best_windows[].quality
Type
string
Required
n/a
Description
Метка quality для окна, например auspicious.
Field
best_windows[].criteria
Type
object
Required
n/a
Description
Целевые правила, коэффициенты Panchang, перекрытие периодов предотвращения и исходные периоды, используемые для окна.
Field
best_moment
Type
object
Required
n/a
Description
Присутствует только тогда, когда строгий персонализированный слой выбирает точный момент; null для общего публичного поиска.
Field
metadata
Type
object
Required
n/a
Description
Версия конечной точки, набор правил, айанамша, часовой пояс, основа расчета и примечания к поиску.

Пример реального запроса

В этом запросе выполняется поиск общедоступных окон Мухурата о покупке транспортных средств в Нью-Дели в апреле 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 для примера полезной нагрузки.

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
}

FAQ

Это публичный обыск Мухурата или персонализированные выборы?

Эта конечная точка является общедоступной и зависит от местоположения и даты. Он ранжирует благоприятные окна purpose-specific по факторам Panchang и избегает менструаций, но не использует карту рождения человека. Используйте персонализированный поиск Мухурат, когда требуется выбор натальной Тара Бала, Чандра Бала и event-chart.

Почему цель не может возвращать окна?

Для некоторых целей предусмотрены строгие общедоступные фильтры, а короткий диапазон дат может не содержать соответствующих условий титхи, накшатры, дня недели и avoid-period. Ответ 200 с пустым массивом best_windows означает, что API завершил поиск и не нашел подходящих общедоступных окон.

Насколько большим может быть диапазон поиска?

Общедоступная конечная точка ограничена 31 днем ​​на каждый запрос. Для более длительных рабочих процессов планирования называйте его помесячно и сохраняйте одни и те же входные данные о местоположении, чтобы результаты оставались сопоставимыми.

Как астрологам следует оценивать оценку и качество?

Оценка — это практический сигнал ранжирования для потребителей API, а не отдельный астрологический вердикт. Объект критериев показывает вспомогательные факторы Panchang, исходные периоды, предупреждения и контекст avoid-period, которые объясняют, почему было включено каждое окно.

Связанные документы