courts.tjap.client.TJAPScraper

courts.tjap.client.TJAPScraper()

Scraper for the Tribunal de Justica do Amapa (TJAP).

The TJAP uses the Tucujuris platform with a JSON REST API. Currently supports jurisprudence search (CJSG).

Methods

Name	Description
cjsg	Search TJAP jurisprudence.
cjsg_download	Download raw CJSG JSON responses from TJAP.
cjsg_parse	Parse downloaded CJSG JSON responses.
cpopg	Stub: first instance case consultation not implemented for TJAP.
cposg	Stub: second instance case consultation not implemented for TJAP.

cjsg

courts.tjap.client.TJAPScraper.cjsg(
    pesquisa=None,
    paginas=None,
    orgao='0',
    numero_processo=None,
    numero_acordao=None,
    numero_ano=None,
    palavras_exatas=False,
    relator=None,
    secretaria=None,
    classe=None,
    votacao='0',
    origem=None,
    **kwargs,
)

Search TJAP jurisprudence.

Parameters

pesquisa : str Free-text search term. paginas : int, list, range, or None Pages to download (1-based). None downloads all. orgao : str "0" for all (default), "tj" for Tribunal, "recursal" for Turma Recursal. numero_processo : str, optional CNJ unique case number. Accepts the deprecated alias numero_cnj. numero_acordao : str, optional Decision number. numero_ano : str, optional Number/year (e.g. "001858/1999"). palavras_exatas : bool If True, search for exact words. relator : str, optional Reporting judge name. secretaria : str, optional Court division. classe : str, optional Procedural class. votacao : str "0" for all (default), "Unanime", "Maioria". origem : str, optional Origin (comarca).

Returns

pd.DataFrame

Raises

TJAPSecurityCheckError Quando o TJAP devolve “A verificação de segurança falhou” — desde ~2026 a busca exige um CAPTCHA Cloudflare Turnstile, validado server-side, que o raspador HTTP não consegue produzir (issue #279). TJAPApiError Para qualquer outro envelope de erro (status == "ERRO") do Tucujuris. Busca com zero resultados devolve DataFrame vazio.

cjsg_download

courts.tjap.client.TJAPScraper.cjsg_download(
    pesquisa=None,
    paginas=None,
    orgao='0',
    numero_processo=None,
    numero_acordao=None,
    numero_ano=None,
    palavras_exatas=False,
    relator=None,
    secretaria=None,
    classe=None,
    votacao='0',
    origem=None,
    **kwargs,
)

Download raw CJSG JSON responses from TJAP.

Parameters are the same as :meth:cjsg. numero_cnj is accepted as a deprecated alias for numero_processo.

Returns

list List of raw JSON responses (one per page).

Raises

TJAPSecurityCheckError Quando o TJAP devolve “A verificação de segurança falhou” (CAPTCHA Cloudflare Turnstile exigido desde ~2026; issue #279). TJAPApiError Para qualquer outro envelope de erro (status == "ERRO") do Tucujuris. Busca com zero resultados devolve lista sem registros.

cjsg_parse

courts.tjap.client.TJAPScraper.cjsg_parse(resultados_brutos)

Parse downloaded CJSG JSON responses.

Parameters

resultados_brutos : list List of raw JSON responses from the TJAP API.

Returns

pd.DataFrame

cpopg

courts.tjap.client.TJAPScraper.cpopg(id_cnj)

Stub: first instance case consultation not implemented for TJAP.

cposg

courts.tjap.client.TJAPScraper.cposg(id_cnj)

Stub: second instance case consultation not implemented for TJAP.