{ "openapi": "3.0.1", "info": { "title": "Evidence-Quoted Text Coder — Your Own Labels, Never Guesses", "description": "Give it your labels and your passages: each coded row carries the verbatim quote that earned it. Where it cannot tell, it hands back the named residual - the two labels it fell between, or an honest no-quote-held. Two readings must agree. No model weights, nothing leaves the container.", "version": "0.1", "x-build-id": "xdcEtSbTyEy9QYjyM" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/equ1n0x~evidence-quoted-text-coder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-equ1n0x-evidence-quoted-text-coder", "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/equ1n0x~evidence-quoted-text-coder/runs": { "post": { "operationId": "runs-sync-equ1n0x-evidence-quoted-text-coder", "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/equ1n0x~evidence-quoted-text-coder/run-sync": { "post": { "operationId": "run-sync-equ1n0x-evidence-quoted-text-coder", "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": [ "codebook" ], "properties": { "codebook": { "title": "Your labels (the codebook)", "type": "object", "description": "The labels to code against. Each dimension holds labels; each label lists the literal markers that are its governed evidence. Bring your own — this is your meaning-structure, not ours." }, "passages": { "title": "Passages to code", "type": "array", "description": "The text items to code. Each item is a string, or an object with a `text` field (plus optional `source_url`, `source_title`)." }, "datasetId": { "title": "Source dataset ID (optional)", "type": "string", "description": "Pull passages from another Actor's dataset instead of (or in addition to) the inline list." }, "textField": { "title": "Text field name", "type": "string", "description": "When reading from a dataset, the field that holds the passage text.", "default": "text" }, "maxItems": { "title": "Max passages", "type": "integer", "description": "An upper bound on how many passages this run reads, so a large dataset cannot cost more than you intended. It stops early rather than sampling: the passages it did read are coded in full, and nothing is guessed about the ones it never reached.", "default": 10000 }, "question": { "title": "The question you're asking of this text", "type": "string", "description": "Optional, and worth filling in. Every row is stamped with the question it was coded under, so an audit you hand to someone else can be checked for whether it answers the question actually asked. Coding the same passages under a different question is a different reading, not the same one seen twice." }, "exemplars": { "title": "Examples you've already confirmed (optional)", "type": "object", "description": "Passages you have already judged, keyed \"dimension::label\". They are read as more of the label's evidence, so a label sharpens as you feed it your own confirmed examples. Nothing is stored between runs — hand them in each time, and they stay yours." } } }, "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 } } } } } } } } } }