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`	Да	Фрагмент текста судебного акта для поиска судебных дел	Любой текст или устойчивая фраза из акта
`page`	Нет	Номер страницы результатов	Целое число от `1`. Алиасы: `page_number`, `pageNumber`. По умолчанию `1`
`page_size`	Нет	Размер страницы	Целое число от `1` до `20`. Алиасы: `pageSize`, `limit`. По умолчанию `20`

Пагинация¶

Метод act_text_search реализован в ods_case_search.py и использует постраничную выдачу через page и page_size.

page начинается с 1.
Максимальный page_size — 20. Если передать больше 20, метод ограничит значение до 20.
Вместо page_size можно передать limit; метод использует его как размер страницы.
Внутреннее смещение считается как (page - 1) * page_size.
На каждую следующую страницу отправляйте новый запрос с новым requestId.

Пример последовательности:

1-я страница: page=1, page_size=20
2-я страница: page=2, page_size=20
3-я страница: page=3, page_size=20

Пример запроса второй страницы:

{
  "params": {
    "act_text": "лишение прав",
    "country": "ru",
    "method": "act_text_search",
    "page": 2,
    "page_size": 20
  },
  "requestId": "d5dd4bc6-b09c-4d64-aea7-66d6533b9b8a"
}

В ответе блок meta содержит поля пагинации:

page — номер запрошенной страницы.
page_size — фактический размер страницы.
offset — рассчитанное смещение.
total_count — общее количество найденных дел по фильтру.
returned_count — сколько дел вернул текущий ответ.
has_more — есть ли следующая страница.
pages_count — всего страниц при текущем page_size.

Останавливайте обход, когда meta.has_more = false или текущий ответ вернул пустой data.

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

`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",
    "page": 1,
    "page_size": 20
  },
  "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,
          "offset": 0,
          "total_count": 1,
          "returned_count": 1,
          "has_more": false,
          "pages_count": 1
        }
      }
    }
  }
}