{ "openapi": "3.0.1", "info": { "title": "Portugal Court Decisions Scraper (DGSI Acórdãos)", "description": "Exports Portuguese court decisions (acórdãos) from the public DGSI databases: case number, court, rapporteur judge, descriptors, date, vote, decision and the official summary. Metadata and summaries only, never full texts. Unofficial tool.", "version": "0.2", "x-build-id": "kIh1zedqbLtB0hrn2" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/gefese~portugal-court-decisions-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-gefese-portugal-court-decisions-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/gefese~portugal-court-decisions-scraper/runs": { "post": { "operationId": "runs-sync-gefese-portugal-court-decisions-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/gefese~portugal-court-decisions-scraper/run-sync": { "post": { "operationId": "run-sync-gefese-portugal-court-decisions-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "databases": { "title": "Court databases", "type": "array", "description": "Which court databases of dgsi.pt to read. Each database is read separately, newest decisions first, and gets its own limit below.", "items": { "type": "string", "enum": [ "jstj", "jsta", "jcon", "jtrp", "jtrl", "jtrc", "jtrg", "jtre", "jtca", "jtcn" ], "enumTitles": [ "Supremo Tribunal de Justiça (jstj)", "Supremo Tribunal Administrativo (jsta)", "Tribunal dos Conflitos (jcon)", "Relação do Porto (jtrp)", "Relação de Lisboa (jtrl)", "Relação de Coimbra (jtrc)", "Relação de Guimarães (jtrg)", "Relação de Évora (jtre)", "Tribunal Central Administrativo Sul (jtca)", "Tribunal Central Administrativo Norte (jtcn)" ] }, "default": [ "jstj", "jtrp" ] }, "maxResultsPerDatabase": { "title": "Maximum decisions per database", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Stops reading a database after this many decisions. Each decision is one billed result and costs one extra request, so about 50 decisions take one to two minutes.", "default": 10 }, "queries": { "title": "Search terms (optional)", "type": "array", "description": "Optional keywords, Portuguese works best, for example \"usucapião\". Each term is sent to the court database's own full-text search, which returns at most about 500 hits per term in relevance order. Leave empty to read the databases newest first.", "default": [], "items": { "type": "string" } }, "dateFrom": { "title": "Decision date from (yyyy-mm-dd)", "type": "string", "description": "Optional. Only decisions dated on or after this day. Without search terms the listing is newest first, so reading stops as soon as it passes this date." }, "dateTo": { "title": "Decision date to (yyyy-mm-dd)", "type": "string", "description": "Optional. Only decisions dated on or before this day. Without search terms the actor jumps straight to that date in the listing (about 15 extra requests)." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }