{ "openapi": "3.0.1", "info": { "title": "Decidim Participation Extractor: Proposals, Processes, Meetings", "description": "Extract processes, assemblies, proposals, results or meetings from any Decidim participatory-democracy site as JSON rows with state, votes, dates and page URL. $0.0005 per record (free plan).", "version": "0.1", "x-build-id": "I7P89If4k6acRPue9" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datamule~decidim-participation-extractor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datamule-decidim-participation-extractor", "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/datamule~decidim-participation-extractor/runs": { "post": { "operationId": "runs-sync-datamule-decidim-participation-extractor", "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/datamule~decidim-participation-extractor/run-sync": { "post": { "operationId": "run-sync-datamule-decidim-participation-extractor", "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", "required": [ "decidimUrl" ], "properties": { "decidimUrl": { "title": "Decidim instance URL", "type": "string", "description": "Root URL of a Decidim participatory-democracy instance (or its full /api URL); its public GraphQL API at /api is read. Works on Decidim hosts only (not CONSUL or others). Some instances block cloud IPs (403) or time out on large discovery; such runs fail with a clear error rather than return partial data. Default: https://meta.decidim.org (the Decidim project's own instance, known to work).", "default": "https://meta.decidim.org" }, "mode": { "title": "Mode (what to extract)", "enum": [ "participatoryProcesses", "assemblies", "proposals", "results", "meetings" ], "type": "string", "description": "What to extract. 'participatoryProcesses' and 'assemblies' return one row per space. 'proposals', 'results' and 'meetings' are components inside participatory processes: the Actor finds every matching component and returns one row per proposal/result/meeting. Default 'participatoryProcesses'.", "default": "participatoryProcesses" }, "withComponents": { "title": "Include components (space modes only)", "type": "boolean", "description": "Only for 'participatoryProcesses' / 'assemblies': expand each space's components list (id, type, name) into the row as a JSON string + a count. Ignored for component modes.", "default": false }, "locale": { "title": "Content locale", "type": "string", "description": "Preferred language for translated text (title, subtitle, body), e.g. 'en', 'ca', 'fi'. If missing on an instance, the first available translation is used and the language is reported in 'titleLocale'. Default 'en'.", "default": "en" }, "maxRecords": { "title": "Max records", "minimum": 1, "type": "integer", "description": "Stop after this many rows; each row is billed as one record ($0.0005 each at the base price, so 100 rows ≈ $0.05). Default 2000. Use 5–20 for a first run on a new instance.", "default": 2000 }, "pageSize": { "title": "Page size (component modes)", "minimum": 1, "maximum": 100, "type": "integer", "description": "Objects requested per Relay page when paginating a component collection (the GraphQL 'first' argument). Space lists are un-paginated and ignore this. Decidim caps this near 100.", "default": 50 }, "userAgent": { "title": "User-Agent (optional)", "type": "string", "description": "Override the default descriptive User-Agent header. Many Decidim instances are public-sector / civic deployments — please keep a descriptive agent." }, "timeoutSecs": { "title": "Request timeout (seconds)", "minimum": 5, "type": "integer", "description": "Per-request timeout in seconds for each GraphQL POST.", "default": 60 } } }, "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 } } } } } } } } } }