{ "openapi": "3.0.1", "info": { "title": "OpenStates Legislation Crawler - 50-State Bill Tracker", "description": "Track state legislation across all 50 US states via the Open States API. Filter by state, session, subject, keyword, or date. Outputs bill metadata, sponsor details, vote records, and legislative actions -- ideal for AI policy monitoring, compliance tracking, and government intelligence.", "version": "1.0", "x-build-id": "c09cTWteIE9Q4eY5R" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jungle_synthesizer~openstates-legislation-crawler/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jungle_synthesizer-openstates-legislation-crawler", "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/jungle_synthesizer~openstates-legislation-crawler/runs": { "post": { "operationId": "runs-sync-jungle_synthesizer-openstates-legislation-crawler", "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/jungle_synthesizer~openstates-legislation-crawler/run-sync": { "post": { "operationId": "run-sync-jungle_synthesizer-openstates-legislation-crawler", "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": { "sp_intended_usage": { "title": "What is the intended usage of this data?", "minLength": 1, "type": "string", "description": "Please describe how you plan to use the data extracted by this crawler." }, "sp_improvement_suggestions": { "title": "How can we improve this crawler for you?", "minLength": 1, "type": "string", "description": "Provide any feedback or suggestions for improvements." }, "sp_contact": { "title": "Contact Email", "minLength": 1, "type": "string", "description": "Provide your email address so we can get in touch with you." }, "apiKey": { "title": "Open States API Key", "type": "string", "description": "Your Open States API key. Free registration at https://openstates.org/accounts/signup/" }, "jurisdiction": { "title": "State / Jurisdiction", "type": "string", "description": "Filter by US state name or abbreviation (e.g. 'California', 'ca', 'Texas', 'tx'). Leave empty to search all jurisdictions -- requires a keyword or subject filter when empty." }, "session": { "title": "Legislative Session", "type": "string", "description": "Filter by session identifier (e.g. '2025-2026', '2025'). Leave empty for all sessions." }, "subject": { "title": "Subject Filter", "type": "string", "description": "Filter bills by subject tag (e.g. 'artificial intelligence', 'healthcare', 'education'). Separate multiple subjects with a comma." }, "query": { "title": "Full-Text Search", "type": "string", "description": "Search bill text and titles for keywords (e.g. 'AI', 'machine learning', 'abortion'). Required when jurisdiction is not specified." }, "classification": { "title": "Bill Classification", "enum": [ "", "bill", "resolution", "concurrent resolution", "joint resolution", "memorial", "constitutional amendment" ], "type": "string", "description": "Filter by classification type (e.g. 'bill', 'resolution', 'memorial')." }, "updatedSince": { "title": "Updated Since (Delta Mode)", "type": "string", "description": "Only return bills updated on or after this date (YYYY-MM-DD). Useful for daily polling workflows." }, "sortOrder": { "title": "Sort Order", "enum": [ "updated_desc", "updated_asc", "first_action_asc", "first_action_desc", "latest_action_asc", "latest_action_desc" ], "type": "string", "description": "How to sort returned bills.", "default": "updated_desc" }, "includeVotes": { "title": "Include Vote Records", "type": "boolean", "description": "Include individual legislator vote records for each bill. Increases data volume and API calls.", "default": false }, "includeActions": { "title": "Include Legislative Actions", "type": "boolean", "description": "Include the full list of legislative actions (readings, committee referrals, votes, signatures).", "default": true }, "includeVersions": { "title": "Include Bill Versions", "type": "boolean", "description": "Include links to bill text versions (introduced, amended, enrolled, etc.).", "default": true }, "maxItems": { "title": "Max Items", "type": "integer", "description": "Maximum number of bills to return. Set to 0 for unlimited.", "default": 15 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Select proxies. The Open States API does not require proxies." } } }, "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 } } }, "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 } } } } } } } } } }