{
  "openapi": "3.0.1",
  "info": {
    "title": "HTTP Request: Bulk API Calls, curl Import, JSON Fields",
    "description": "Send GET, POST, PUT, PATCH or DELETE requests to any public API in bulk. Paste URLs or curl commands, or fill a URL template from rows. Get status, headers, JSON or text, extracted fields, array rows and pages. Failed calls are free.",
    "version": "1.0",
    "x-build-id": "Uw68dWO4oyvxMygFr"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/joesimo~http-request/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-joesimo-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/joesimo~http-request/runs": {
      "post": {
        "operationId": "runs-sync-joesimo-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/joesimo~http-request/run-sync": {
      "post": {
        "operationId": "run-sync-joesimo-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 entry per request. Each entry can be a URL string, a curl command copied from your browser or API docs, or an object like {\"url\": \"https://api.example.com/items\", \"method\": \"POST\", \"headers\": {\"X-Key\": \"...\"}, \"queryParams\": {\"page\": 1}, \"jsonBody\": {\"name\": \"test\"}, \"label\": \"my label\"}. Use body for a raw text body."
          },
          "urls": {
            "title": "Plain URL list",
            "type": "array",
            "description": "Optional quick list of URLs. Each one is sent with the method, headers and body below.",
            "items": {
              "type": "string"
            }
          },
          "urlTemplate": {
            "title": "URL template",
            "type": "string",
            "description": "Build one request per row. Use {{field}} or {{nested.field}} placeholders, for example https://api.example.com/users/{{id}}?country={{country}}. Values are URL encoded. Placeholders also work in headers, query parameters and bodies."
          },
          "rows": {
            "title": "Rows",
            "type": "array",
            "description": "Objects that fill the URL template, one request per row, for example [{\"id\": 1}, {\"id\": 2}]. A row is echoed back in the output so you can match results to your sheet or CRM."
          },
          "bodyTemplate": {
            "title": "Body template",
            "type": "string",
            "description": "Optional body for template rows, with {{field}} placeholders. A body that starts with { or [ is sent as JSON and values are JSON escaped."
          },
          "method": {
            "title": "Default method",
            "enum": [
              "GET",
              "POST",
              "PUT",
              "PATCH",
              "DELETE",
              "HEAD",
              "OPTIONS"
            ],
            "type": "string",
            "description": "Used when a request does not set its own method. Requests with a body default to POST."
          },
          "headers": {
            "title": "Headers",
            "type": "object",
            "description": "Headers sent with every request, for example {\"Accept\": \"application/json\"}. A request's own headers win. Put API keys in Secret headers instead."
          },
          "secretHeaders": {
            "title": "Secret headers",
            "type": "string",
            "description": "Headers that hold API keys or tokens, one per line as Name: value (for example Authorization: Bearer YOUR_TOKEN). Stored encrypted by Apify, never written to the output, and dropped when a redirect leaves the original host."
          },
          "queryParams": {
            "title": "Query parameters",
            "type": "object",
            "description": "Query parameters added to every URL, for example {\"limit\": 100}."
          },
          "jsonBody": {
            "title": "JSON body",
            "type": "object",
            "description": "JSON body sent with every request that has no body of its own (POST, PUT, PATCH, DELETE)."
          },
          "body": {
            "title": "Raw body",
            "type": "string",
            "description": "Raw text body sent with every request that has no body of its own. Ignored when JSON body is set."
          },
          "responseFormat": {
            "title": "Response format",
            "enum": [
              "auto",
              "json",
              "text",
              "base64",
              "none"
            ],
            "type": "string",
            "description": "How to save the response body.",
            "default": "auto"
          },
          "extractFields": {
            "title": "Extract fields",
            "type": "object",
            "description": "Pick values out of JSON responses into a fields column, as name: path pairs, for example {\"title\": \"data.title\", \"firstTag\": \"data.tags[0]\"}. With Split array path, paths are read from each array element."
          },
          "splitArrayPath": {
            "title": "Split array path",
            "type": "string",
            "description": "Path to an array in the JSON response, for example data.items. Each element becomes its own dataset row (still one charged request). Leave empty to keep one row per response."
          },
          "includeHeaders": {
            "title": "Include response headers",
            "type": "boolean",
            "description": "Save response headers (Set-Cookie is never saved).",
            "default": true
          },
          "includeRowInOutput": {
            "title": "Echo input row",
            "type": "boolean",
            "description": "Copy each template row into the output row, so results can be joined back to your data.",
            "default": true
          },
          "maxBodyKb": {
            "title": "Max body size (KB)",
            "minimum": 1,
            "maximum": 8192,
            "type": "integer",
            "description": "Bodies larger than this are cut and marked truncated.",
            "default": 2048
          },
          "nextUrlPath": {
            "title": "Next page path",
            "type": "string",
            "description": "Path in the JSON response that holds the next page URL (or a cursor if you set Cursor parameter), for example links.next or meta.next_cursor. Each page is one request."
          },
          "cursorParam": {
            "title": "Cursor parameter",
            "type": "string",
            "description": "If the next page path holds a cursor instead of a URL, the query parameter to put it in, for example cursor or page_token."
          },
          "followLinkHeader": {
            "title": "Follow Link rel=next header",
            "type": "boolean",
            "description": "Follow pagination from the standard Link response header (GitHub style APIs).",
            "default": false
          },
          "maxPagesPerRequest": {
            "title": "Max pages per request",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "Page limit for each starting request when pagination is on. Default 10."
          },
          "concurrency": {
            "title": "Concurrency",
            "minimum": 1,
            "maximum": 50,
            "type": "integer",
            "description": "Requests in flight at the same time.",
            "default": 5
          },
          "delayPerHostMs": {
            "title": "Delay per host (ms)",
            "minimum": 0,
            "maximum": 60000,
            "type": "integer",
            "description": "Minimum gap between requests to the same host. Raise it to respect an API's rate limit. After a 429 the gap doubles automatically.",
            "default": 100
          },
          "timeoutSecs": {
            "title": "Timeout per request (seconds)",
            "minimum": 1,
            "maximum": 300,
            "type": "integer",
            "description": "Time limit for each attempt.",
            "default": 30
          },
          "maxRetries": {
            "title": "Retries",
            "minimum": 0,
            "maximum": 10,
            "type": "integer",
            "description": "Retries on timeouts, network errors, 429 and 5xx, honoring Retry-After. POST and PATCH are retried only on 429 unless the next option is on.",
            "default": 2
          },
          "retryNonIdempotent": {
            "title": "Retry POST and PATCH on errors",
            "type": "boolean",
            "description": "Also retry POST and PATCH after timeouts and 5xx. Only switch on if repeating the call is safe.",
            "default": false
          },
          "followRedirects": {
            "title": "Follow redirects",
            "type": "boolean",
            "description": "Follow 3xx redirects (up to 10). The chain is saved in redirects.",
            "default": true
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}