{ "openapi": "3.0.1", "info": { "title": "Bulk HTTP Request — API Calls, JSON & Headers", "description": "Send a list of HTTP requests (GET, POST, PUT, PATCH, DELETE) in one run: one row per request with status, response headers, parsed JSON or text body and timing. $1.00 per 1,000 requests answered + $0.001/run.", "version": "0.1", "x-build-id": "j3gqzjf4SbMBqU3mj" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tagadanar~bulk-http-request/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tagadanar-bulk-http-request", "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/tagadanar~bulk-http-request/runs": { "post": { "operationId": "runs-sync-tagadanar-bulk-http-request", "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/tagadanar~bulk-http-request/run-sync": { "post": { "operationId": "run-sync-tagadanar-bulk-http-request", "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": { "requests": { "title": "Requests", "type": "array", "description": "One object per request: {\"url\": \"https://api.example.com/items/1\", \"method\": \"POST\", \"headers\": {\"Authorization\": \"Bearer ...\"}, \"body\": {\"name\": \"x\"}, \"label\": \"my id\"}. Only \"url\" is required; method, headers and body fall back to the shared settings below. An object body is sent as JSON. \"label\" is copied to the output row so you can match results to your own records. Up to 10,000 requests per run, from this list and the URL list together." }, "urls": { "title": "URLs (shared settings)", "type": "array", "description": "A plain list of URLs that all use the shared Method, Headers and Body below. Handy for calling one API endpoint with many ids.", "items": { "type": "string" } }, "method": { "title": "Method", "enum": [ "GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS" ], "type": "string", "description": "HTTP method for the URL list and for any request that has no method of its own.", "default": "GET" }, "headers": { "title": "Headers (shared)", "type": "object", "description": "Headers sent with every request, e.g. {\"Accept\": \"application/json\", \"Authorization\": \"Bearer YOUR_TOKEN\"}. A request's own headers win. Header values are never written to the log or the output rows." }, "body": { "title": "Body (shared)", "type": "string", "description": "Request body for POST, PUT, PATCH and DELETE. Text is sent as is; text that is valid JSON gets Content-Type: application/json unless you set one. For a different body per request use the Requests list." }, "followRedirects": { "title": "Follow redirects", "type": "boolean", "description": "Follow up to 10 redirects (each hop is checked again). Off: you get the 3xx answer itself, with its Location header.", "default": true }, "timeoutSecs": { "title": "Timeout per request (seconds)", "minimum": 1, "maximum": 300, "type": "integer", "description": "Give up on an attempt after this long (connect plus full body).", "default": 30 }, "maxRetries": { "title": "Retries", "minimum": 0, "maximum": 5, "type": "integer", "description": "Extra attempts after a network error, HTTP 429 or a 5xx answer, with back-off (a Retry-After header is honoured, up to 10 s). 4xx answers other than 429 are never retried. Note a retried POST can be processed twice by the server: set 0 for non-idempotent calls.", "default": 1 }, "concurrency": { "title": "Concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "Requests in flight at once (max 20). Lower it for APIs with strict rate limits.", "default": 5 }, "parseJson": { "title": "Parse JSON responses", "type": "boolean", "description": "Put JSON answers in the \"json\" column as real data instead of text. Off: the raw text is always in \"text\".", "default": true }, "maxBodyKb": { "title": "Max stored body (KB)", "minimum": 1, "maximum": 1024, "type": "integer", "description": "Response bodies are cut at this size and flagged truncated: true (a cut JSON body is kept as text). Binary content types (images, PDFs, archives) are counted but not stored.", "default": 1024 } } }, "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 } } } } } } } } } }