# HTTP Request Runner (bulk API calls, GET, POST, JSON) (`psypherz/http-request-runner`) Actor

Send up to 10,000 HTTP requests per run: GET, POST, PUT, PATCH, DELETE or HEAD with your own headers and body. Get status, headers, timing and the body, with JSON parsed for you.

- **URL**: https://apify.com/psypherz/http-request-runner.md
- **Developed by:** [Muhammad Yasin Bin Abdul Rahman](https://apify.com/psypherz) (community)
- **Categories:** Developer tools, Integrations
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.70 / 1,000 request answereds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## HTTP Request Runner (bulk API calls, GET, POST, JSON)

Send up to 10,000 HTTP requests in one run and get every answer back as a clean row: status code, timing, final URL after redirects, response headers and the body. JSON responses are parsed into objects, so you can use them straight away in Make, Zapier, n8n, Sheets or an AI agent.

**Price: US$0.002 per answered request (first 1 MB of each response included), US$0.001 per extra started MB, plus a US$0.001 run fee.** 1,000 requests with small responses cost US$2.001. Requests that fail before any answer (timeout, DNS, refused) are not charged.

### What people use it for

- **Bulk API calls without code:** call a REST API for a list of IDs and get all the JSON back in one dataset.
- **Webhooks and integrations:** POST data to an endpoint from a scheduled Apify task.
- **Uptime and status checks:** check status codes and response times for a list of URLs or endpoints.
- **Redirect checks:** see where each link ends up after redirects.
- **AI agent tool:** a safe, metered way for an agent to call public HTTP APIs.

### Input

- `requests`: list of objects: `url`, `method` (GET, POST, PUT, PATCH, DELETE, HEAD; default GET), `headers`, `body` (text, or JSON sent as application/json), `label` (optional tag copied to the output).
- `urls`: optional plain links to GET.
- `maxResponseMb` (default 2, up to 10), `timeoutSeconds` (default 30), `followRedirects` (default true), `parseJson` (default true).

### Example output

Real output from the sample input (30 Oct 2026).

| # | label | method | status | ms | content type | bytes |
|---|---|---|---|---|---|---|
| 1 | simple GET | GET | 200 | 266 | application/json | 317 |
| 2 | JSON POST | POST | 200 | 829 | application/json | 490 |
| 3 | public API | GET | 200 | 328 | application/json | 6621 |

One full item (response headers shortened):

```json
{
  "label": "JSON POST",
  "url": "https://httpbin.org/post",
  "method": "POST",
  "finalUrl": "https://httpbin.org/post",
  "statusCode": 200,
  "ok": true,
  "elapsedMs": 829,
  "contentType": "application/json",
  "responseHeaders": {
    "access-control-allow-credentials": "true",
    "access-control-allow-origin": "*",
    "access-control-expose-headers": "Retry-After, RateLimit, RateLimit-Policy",
    "content-length": "490"
  },
  "bodyBytes": 490,
  "truncated": false,
  "json": {
    "args": {},
    "headers": {
      "Accept": "*/*",
      "Accept-Encoding": "gzip, deflate, br, zstd",
      "Content-Length": "18",
      "Content-Type": "application/json",
      "Host": "httpbin.org",
      "User-Agent": "ApifyHttpRequestRunner/1.0 (+https://apify.com/PsypherZ/http-request-runner)"
    },
    "method": "POST",
    "origin": "132.147.74.143",
    "url": "https://httpbin.org/post",
    "data": "{\"hello\": \"world\"}",
    "files": {},
    "form": {},
    "json": {
      "hello": "world"
    }
  },
  "body": null,
  "requestIndex": 2,
  "sentAt": "2026-10-30T17:16:34+00:00"
}
```

### Rules this Actor follows

- **Public hosts only.** Private, local and cloud metadata addresses are refused, on every redirect hop too.
- **Honest identity.** Every request uses the User-Agent `ApifyHttpRequestRunner/1.0` with a link to this page. It cannot be changed, and the Actor never disguises itself as a browser or tries to get past bot protection or CAPTCHAs.
- **robots.txt respected.** Paths a site disallows for automated clients are skipped and not charged.
- **Polite.** At most 2 requests at a time to the same host, 10 in total.
- **Your headers stay private.** Request headers (API keys, tokens) are sent only to the URL you give. They are never logged or written to the output.
- Use it only for endpoints you are allowed to call, under their terms.

### Limits

- 10,000 requests per run; request bodies up to 1 MB; responses cut at 10 MB.
- No JavaScript rendering. For pages that need a browser, use a browser-based Actor.

### FAQ

**Is a 404 or 500 charged?** Yes. The server answered, and you get its status and body. Only requests with no answer at all are free.

**Can I send an API key?** Yes, in `headers` (for example `Authorization`). It is sent to that URL only and never stored in the output or log.

**Can an AI agent call it?** Yes. Compact JSON with stable field names and pay-per-event pricing.

### More tools from the same developer

Same style: clean JSON output, pay only for results, no charge on failed items.

| Tool | What it does |
|---|---|
| [Bulk Keyword Search Volume](https://apify.com/PsypherZ/keyword-search-volume) | Google Ads search volume, CPC, competition and 12-month trend for up to 10,000 keywords |
| [Google Keyword Ideas](https://apify.com/PsypherZ/google-keyword-ideas) | Hundreds of keyword ideas per seed with volume, CPC, difficulty and search intent |
| [Amazon Keyword Search Volume](https://apify.com/PsypherZ/amazon-keyword-volume) | Monthly Amazon searches for up to 10,000 keywords in 16 markets, plus related keywords |
| [Competitor Keywords](https://apify.com/PsypherZ/competitor-keywords) | Every Google keyword a domain ranks for, with traffic, plus its closest competitors |
| [Google Trends API](https://apify.com/PsypherZ/google-trends-api) | Interest over time, by region, and rising queries and topics for up to 500 keywords |
| [Google SERP Results](https://apify.com/PsypherZ/google-serp-results) | Organic results, featured snippets and People Also Ask for any keyword, country and device |
| [AI Brand Visibility Tracker](https://apify.com/PsypherZ/ai-brand-visibility) | Which brands ChatGPT, Claude, Gemini and Perplexity recommend, and where yours ranks |
| [Google AI Overview Tracker](https://apify.com/PsypherZ/google-ai-overview-tracker) | Which keywords show an AI Overview, what it says, and whether it cites your site |
| [Audio and Video Transcriber](https://apify.com/PsypherZ/audio-video-transcriber) | Timestamped transcripts from audio and video files in 90+ languages |
| [Subtitle Generator](https://apify.com/PsypherZ/subtitle-generator) | Ready-to-use SRT and WebVTT subtitles from audio and video files |
| [Podcast Transcriber](https://apify.com/PsypherZ/podcast-transcriber) | Timestamped transcripts of podcast episodes from any RSS feed or Apple Podcasts link |
| [Image OCR](https://apify.com/PsypherZ/image-ocr) | Text from images in 20 languages, with confidence scores |
| [AI Image Upscaler](https://apify.com/PsypherZ/image-upscaler) | Upscale photos and artwork 2x, 3x or 4x with Real-ESRGAN AI |
| [PDF to Text and Markdown](https://apify.com/PsypherZ/pdf-to-text-markdown) | Clean text and Markdown from PDFs, with OCR for scanned pages |
| [Bulk PageSpeed Insights Audit](https://apify.com/PsypherZ/bulk-pagespeed-audit) | Core Web Vitals and Lighthouse scores for many pages, mobile and desktop |
| [Email List Validator](https://apify.com/PsypherZ/email-list-validator) | Clean email lists: syntax, domain, mail server, throwaway and role checks, plus typo fixes |
| [Bulk File Downloader](https://apify.com/PsypherZ/bulk-file-downloader) | Save up to 5,000 direct file links to storage, each with a download link and checksum |
| [Video Frame Extractor](https://apify.com/PsypherZ/video-frame-extractor) | Still images from video files every N seconds, at set times, or evenly spaced |

# Actor input Schema

## `requests` (type: `array`):

One object per request: {"url": "...", "method": "POST", "headers": {...}, "body": {...} or "text", "label": "optional tag"}. Method defaults to GET. A JSON body is sent with Content-Type application/json.

## `urls` (type: `array`):

Optional. Plain links to GET, one per line. Added after the requests above.

## `maxResponseMb` (type: `number`):

Bodies are cut at this size and marked truncated. Up to 10.

## `timeoutSeconds` (type: `integer`):

From 1 to 120.

## `followRedirects` (type: `boolean`):

Follow 3xx redirects to the final address (up to 5). Each hop is checked for private addresses.

## `parseJson` (type: `boolean`):

Put JSON responses in the "json" field as an object instead of text.

## Actor input object example

```json
{
  "requests": [
    {
      "url": "https://httpbin.org/get",
      "label": "simple GET"
    },
    {
      "url": "https://httpbin.org/post",
      "method": "POST",
      "body": {
        "hello": "world"
      },
      "label": "JSON POST"
    },
    {
      "url": "https://api.github.com/repos/apify/crawlee",
      "headers": {
        "Accept": "application/vnd.github+json"
      },
      "label": "public API"
    }
  ],
  "maxResponseMb": 2,
  "timeoutSeconds": 30,
  "followRedirects": true,
  "parseJson": true
}
```

# Actor output Schema

## `results` (type: `string`):

One row per request: status code, timing, headers and body (JSON parsed when possible).

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "requests": [
        {
            "url": "https://httpbin.org/get",
            "label": "simple GET"
        },
        {
            "url": "https://httpbin.org/post",
            "method": "POST",
            "body": {
                "hello": "world"
            },
            "label": "JSON POST"
        },
        {
            "url": "https://api.github.com/repos/apify/crawlee",
            "headers": {
                "Accept": "application/vnd.github+json"
            },
            "label": "public API"
        }
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("psypherz/http-request-runner").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "requests": [
        {
            "url": "https://httpbin.org/get",
            "label": "simple GET",
        },
        {
            "url": "https://httpbin.org/post",
            "method": "POST",
            "body": { "hello": "world" },
            "label": "JSON POST",
        },
        {
            "url": "https://api.github.com/repos/apify/crawlee",
            "headers": { "Accept": "application/vnd.github+json" },
            "label": "public API",
        },
    ] }

# Run the Actor and wait for it to finish
run = client.actor("psypherz/http-request-runner").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "requests": [
    {
      "url": "https://httpbin.org/get",
      "label": "simple GET"
    },
    {
      "url": "https://httpbin.org/post",
      "method": "POST",
      "body": {
        "hello": "world"
      },
      "label": "JSON POST"
    },
    {
      "url": "https://api.github.com/repos/apify/crawlee",
      "headers": {
        "Accept": "application/vnd.github+json"
      },
      "label": "public API"
    }
  ]
}' |
apify call psypherz/http-request-runner --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,psypherz/http-request-runner"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/sgh1sF9eQkg26IA5d/builds/hs2MbXu1LflsDBSg2/openapi.json