Перейти к содержанию

act_text_search — Поиск судебных дел по текстам актов

POST https://api.newdb.net/v2

Метод ищет судебные дела в ГАС Правосудие по текстам судебных актов. Поиск выполняется по полю act_text и возвращает дела, для которых найдено совпадение в тексте одного или нескольких актов.

В ответе возвращается список найденных дел с карточкой дела, списком участников и списком актов. Для дальнейшей детализации конкретного дела используйте pravo_cases_details.


Раздел: ГАС Правосудие

Связанные страницы

Когда использовать

Используйте метод, когда нужно найти судебные дела по фрагменту текста судебного акта.

Типовые кейсы

  • Поиск дел по формулировке из судебного акта
  • Поиск дел по устойчивой фразе из текста решения
  • Поиск дел по тексту, который отсутствует в краткой карточке дела

Заголовки

Content-Type: application/json X-API-KEY:


Входная схема (request)

{
  "params": {
    "act_text": "string",
    "country": "ru",
    "method": "act_text_search"
  },
  "requestId": "optional-string"
}

Как работает поиск

По коду метод использует отдельный SQL-путь ACT_TEXT_SQL и проверяет наличие совпадения в ods.case_acts.act_text.

  • Поиск выполняется по всем текстам актов
  • Совпадение ищется через LIKE '%...%'
  • На выходе возвращаются дела, отсортированные по case_id по убыванию
  • В ответ попадают карточка дела, parties и acts
  • Метод поддерживает пагинацию через page и page_size / limit

Описание параметра

Параметр Обязательность Назначение Какие значения принимает
act_text Да Фрагмент текста судебного акта для поиска судебных дел Любой текст или устойчивая фраза из акта

Служебные значения

country

  • Для метода используется значение ru

method

  • Актуальное значение: act_text_search

Обязательность параметров

Формально для вызова нужно передать:

  • act_text
  • country
  • method

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

POST /v2 HTTP/1.1
Host: api.newdb.net
Content-Type: application/json
X-API-KEY: YOUR_TOKEN

{
  "params": {
    "act_text": "лишение прав",
    "country": "ru",
    "method": "act_text_search"
  },
  "requestId": "a5162f88-3916-5179-b59d-43c123faa911"
}

Пример ответа

{
  "results": {
    "act_text_search": {
      "result": {
        "status": 200,
        "data": [
          {
            "case_id": 123456,
            "case_number": "12-345/2025",
            "case_url": "https://example.sudrf.ru/...",
            "case_info": "Дело о лишении права управления транспортным средством",
            "court_url": "https://example.sudrf.ru",
            "parties": [],
            "acts": [
              {
                "act_id": 987654,
                "act_title": "Постановление",
                "act_text": "...лишение прав..."
              }
            ]
          }
        ],
        "meta": {
          "act_text": "лишение прав",
          "page": 1,
          "page_size": 20,
          "count": 1,
          "case_ids": [123456]
        }
      }
    }
  }
}