{
  "openapi": "3.1.0",
  "info": {
    "title": "Hookvolley API (Bulk HTTP Request & Webhook Sender)",
    "version": "1.0.0",
    "summary": "💰 $0.80 per 1,000 requests answered; no-response requests free, no start fee.",
    "description": "💰 $0.80 per 1,000 requests answered; no-response requests free, no start fee. Bulk GET, POST, PUT, PATCH or DELETE to any API or webhook, from a URL list or one request per dataset row with {{field}} templates. Retries, rate limits, JSON parsing. Cheaper than memo23's HTTP request ($5/1K).\n\nRuns the Hookvolley Actor (`cybermax/bulk-http-requests`) on Apify with the caller's own Apify API token and returns its dataset. Pricing (pay per event, billed by Apify):\n- Request answered: $0.0008\n\nPublisher: CyberMax. Catalog: https://cybermax-tools-cybermax.static.hf.space/market/catalog.json",
    "contact": {
      "name": "CyberMax",
      "url": "https://apify.com/cybermax/bulk-http-requests"
    },
    "x-logo": {
      "url": "https://cybermax-tools-cybermax.static.hf.space/favicon.ico"
    }
  },
  "x-cybermax-referral": {
    "program": "CyberMax affiliate and referral program",
    "status": "open",
    "ratePct": 30,
    "appliesTo": "Digital products sold through CyberMax's own Stripe checkout (store downloads, app Pro plans, API plans, bundles, data briefs).",
    "basis": "net amount CyberMax receives for the order (after payment fees, refunds and chargebacks)",
    "recurring": "the first 12 months of a subscription; one-time orders once",
    "attributionWindowDays": 60,
    "passRef": {
      "queryParam": "ref",
      "stripeParam": "client_reference_id",
      "stripeValue": "aff_<your-id>",
      "example": "https://buy.stripe.com/<link>?client_reference_id=aff_<your-id>"
    },
    "payouts": "Paid manually by CyberMax once a month for eligible sales whose 14-day refund window has closed (owner approval 10 Oct 2026).",
    "terms": "https://cybermaxtools.com/affiliates/",
    "details": "https://cybermaxtools.com/.well-known/referral.json",
    "note": "Runs of this tool are billed by Apify on Apify's checkout, so they are not covered by the CyberMax referral program; it covers CyberMax Stripe checkout sales (store, API plans, bundles)."
  },
  "externalDocs": {
    "description": "Apify Store page",
    "url": "https://apify.com/cybermax/bulk-http-requests"
  },
  "servers": [
    {
      "url": "https://api.apify.com",
      "description": "Apify API"
    }
  ],
  "security": [
    {
      "apifyToken": []
    }
  ],
  "tags": [
    {
      "name": "Hookvolley",
      "description": "💰 $0.80 per 1,000 requests answered; no-response requests free, no start fee."
    }
  ],
  "paths": {
    "/v2/acts/cybermax~bulk-http-requests/run-sync-get-dataset-items": {
      "post": {
        "operationId": "runHookvolleySync",
        "tags": [
          "Hookvolley"
        ],
        "summary": "Hookvolley: run and return results",
        "description": "💰 $0.80 per 1,000 requests answered; no-response requests free, no start fee. Waits for the run to finish (up to 300 s) and returns the output records.",
        "parameters": [
          {
            "name": "timeout",
            "in": "query",
            "required": false,
            "description": "Run timeout in seconds (max 300 for synchronous runs).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 300
            }
          },
          {
            "name": "clean",
            "in": "query",
            "required": false,
            "description": "Omit empty records and hidden fields.",
            "schema": {
              "type": "boolean",
              "default": true
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Input"
              },
              "example": {
                "urls": [
                  "https://jsonplaceholder.typicode.com/posts/1",
                  "https://jsonplaceholder.typicode.com/users/1"
                ],
                "headers": {}
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Run finished; body is the list of output records.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OutputRecord"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid input.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApifyError"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid Apify token.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApifyError"
                }
              }
            }
          },
          "402": {
            "description": "Apify account has no credit left for this run.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApifyError"
                }
              }
            }
          },
          "408": {
            "description": "The run did not finish within the synchronous timeout; start it asynchronously instead.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApifyError"
                }
              }
            }
          },
          "429": {
            "description": "Rate limited by Apify.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApifyError"
                }
              }
            }
          }
        }
      }
    },
    "/v2/acts/cybermax~bulk-http-requests/runs": {
      "post": {
        "operationId": "startHookvolleyRun",
        "tags": [
          "Hookvolley"
        ],
        "summary": "Hookvolley: start an asynchronous run",
        "description": "Starts a run and returns immediately. Poll GET https://api.apify.com/v2/actor-runs/{runId} and read items from GET https://api.apify.com/v2/datasets/{defaultDatasetId}/items.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Input"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Run started.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RunStarted"
                }
              }
            }
          },
          "400": {
            "description": "Invalid input.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApifyError"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid Apify token.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApifyError"
                }
              }
            }
          },
          "402": {
            "description": "Apify account has no credit left for this run.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApifyError"
                }
              }
            }
          },
          "429": {
            "description": "Rate limited by Apify.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApifyError"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "apifyToken": {
        "type": "http",
        "scheme": "bearer",
        "description": "Your Apify API token (https://console.apify.com/settings/integrations). Runs are billed to your Apify account."
      }
    },
    "schemas": {
      "Input": {
        "type": "object",
        "properties": {
          "urls": {
            "type": "array",
            "title": "URLs",
            "description": "One request per URL, using the method, headers and body below.",
            "examples": [
              [
                "https://jsonplaceholder.typicode.com/posts/1",
                "https://jsonplaceholder.typicode.com/users/1"
              ]
            ],
            "items": {
              "type": "string"
            }
          },
          "method": {
            "type": "string",
            "title": "Method",
            "description": "HTTP method for the URLs and dataset requests (individual requests can set their own).",
            "default": "GET",
            "enum": [
              "GET",
              "POST",
              "PUT",
              "PATCH",
              "DELETE",
              "HEAD",
              "OPTIONS"
            ]
          },
          "headers": {
            "type": "object",
            "title": "Headers",
            "description": "Sent with every request, e.g. {\"Authorization\": \"Bearer ...\", \"Accept\": \"application/json\"}. {{field}} placeholders work with a dataset.",
            "examples": [
              {}
            ]
          },
          "body": {
            "type": "string",
            "title": "Body",
            "description": "Request body for POST, PUT and PATCH (JSON or text). Set a Content-Type header for non-JSON bodies."
          },
          "requests": {
            "type": "array",
            "title": "Individual requests (advanced)",
            "description": "Full control per request: [{\"url\": \"...\", \"method\": \"POST\", \"headers\": {...}, \"body\": {...}, \"label\": \"order-1\"}]. Object bodies are sent as JSON.",
            "items": {}
          },
          "datasetId": {
            "type": "string",
            "title": "One request per row of this dataset",
            "description": "Optional. Each row (or batch of rows) becomes a request built from the templates below."
          },
          "datasetIds": {
            "type": "array",
            "title": "Datasets (API alias)",
            "description": "API alias of \"datasetId\" (the field name Rowmold and Rowmeld use): one request per row of each dataset. Hidden in the form.",
            "items": {}
          },
          "urlTemplate": {
            "type": "string",
            "title": "URL template",
            "description": "e.g. https://api.example.com/companies/{{domain|url}} or your webhook URL. {{field}}, {{nested.field}}, {{field|url}}, {{json}}."
          },
          "bodyTemplate": {
            "type": "string",
            "title": "Body template",
            "description": "Optional, e.g. {\"name\": {{name|json}}, \"site\": {{url|json}}}. Empty with POST/PUT/PATCH = the row (or batch) as JSON."
          },
          "batchSize": {
            "type": "integer",
            "title": "Rows per request",
            "description": "Above 1, rows are sent in batches: the body is a JSON array of rows (templates see {{items}} and {{count}}).",
            "default": 1,
            "minimum": 1,
            "maximum": 1000
          },
          "maxConcurrency": {
            "type": "integer",
            "title": "Parallel requests",
            "description": "How many requests run at the same time.",
            "default": 5,
            "minimum": 1,
            "maximum": 20
          },
          "maxRequestsPerSecondPerHost": {
            "type": "integer",
            "title": "Max requests per second per host",
            "description": "Keeps you within the API's rate limit.",
            "default": 5,
            "minimum": 1,
            "maximum": 50
          },
          "timeoutSecs": {
            "type": "integer",
            "title": "Timeout per request (seconds)",
            "description": "A request that takes longer is retried, then reported as failed.",
            "default": 30,
            "minimum": 1,
            "maximum": 300
          },
          "maxRetries": {
            "type": "integer",
            "title": "Retries",
            "description": "Retries network errors, timeouts, 408, 425, 429 and 5xx with exponential backoff, honouring Retry-After.",
            "default": 3,
            "minimum": 0,
            "maximum": 8
          },
          "followRedirects": {
            "type": "boolean",
            "title": "Follow redirects",
            "description": "Follow 3xx redirects (up to 5; each hop is checked for safety).",
            "default": true
          },
          "responseFormat": {
            "type": "string",
            "title": "Response body",
            "description": "How the response body is saved in each row.",
            "default": "auto",
            "enum": [
              "auto",
              "json",
              "text",
              "none"
            ],
            "x-enumTitles": [
              "Auto (JSON when JSON, else text)",
              "JSON",
              "Text",
              "Don't save the body"
            ]
          },
          "maxResponseKb": {
            "type": "integer",
            "title": "Max body size saved (KB)",
            "description": "Longer bodies are cut and marked truncated.",
            "default": 512,
            "minimum": 1,
            "maximum": 9000
          },
          "extractFields": {
            "type": "array",
            "title": "Extract fields from JSON responses",
            "description": "Optional dotted paths, e.g. data.price or items.0.id, returned in an extracted object.",
            "items": {
              "type": "string"
            }
          },
          "includeResponseHeaders": {
            "type": "boolean",
            "title": "Save response headers",
            "description": "Adds the response headers to each row.",
            "default": false
          },
          "includeInputRow": {
            "type": "boolean",
            "title": "Save the dataset row with each result",
            "description": "Adds the dataset row a request was built from.",
            "default": false
          },
          "monitor": {
            "type": "boolean",
            "title": "Monitor mode: changed responses only",
            "description": "Returns a request only when its status or body changed since the last monitor run. Unchanged responses are not charged.",
            "default": false
          },
          "monitorKey": {
            "type": [
              "string",
              "null"
            ],
            "title": "Watchlist name",
            "description": "Optional name for this watchlist's saved state."
          }
        },
        "title": "Hookvolley input",
        "additionalProperties": false
      },
      "OutputRecord": {
        "type": "object",
        "properties": {
          "label": {
            "description": "Label"
          },
          "method": {
            "description": "Method"
          },
          "url": {
            "description": "URL"
          },
          "status": {
            "description": "Status"
          },
          "ok": {
            "description": "OK"
          },
          "durationMs": {
            "description": "ms"
          },
          "attempts": {
            "description": "Attempts"
          },
          "extracted": {
            "description": "Extracted"
          },
          "change": {
            "description": "Change"
          },
          "error": {
            "description": "Error"
          }
        },
        "x-inferredFrom": "the Actor dataset view field list (types not declared)"
      },
      "RunStarted": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "status": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              }
            }
          }
        }
      },
      "ApifyError": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "type": {
                "type": "string"
              },
              "message": {
                "type": "string"
              }
            }
          }
        }
      }
    }
  }
}