Pricing

from $0.14 / 1,000 http requests

HTTP API - Flexible Client for Prototyping and Automation

Easily test, integrate, and automate APIs—configure method, headers, query params, body, timeout, and retries, no code or setup required. Ideal for rapid prototyping, endpoint monitoring, workflows, and sales & marketing automation.

Pricing

from $0.14 / 1,000 http requests

Rating

0.0

(0)

Developer

Superlative

Actor stats

Bookmarked

133

Total users

Monthly active users

3 days ago

Last modified

The Human-to-Code Translator

anointment/the-human-to-code-translator

Speak your website into existence. Turns plain English descriptions into clean, working HTML, CSS, and JavaScript. Perfect for rapid prototyping and no-code builders.

Anointment

Nanobanana Flash

alizarin_refrigerator-owner/nanobanana-flash

Generate AI images quickly and affordably using Google's Gemini 2.5 Flash model. Perfect for rapid prototyping, quick drafts, and high-volume image generation.

The Howlers

Test Timeout

michal.kalita/test-timeout

Simple Actor to test timeout. Actor waits for a specified number of seconds, then pushes data to the dataset at the end.

Michal Kalita

Fake Random User Generator

moving_beacon-owner1/fake-random-user-generator

Generates realistic fake user profiles using the RandomUser.me API. Perfect for populating test databases, prototyping UIs, load testing, and demo data. No API key required.

Jamshaid Arif

HTTP Request

parsebird/http-request-actor

Send HTTP requests (GET, POST, PUT, PATCH, DELETE) to any API endpoint with customizable headers, parameters, and body data. Forward responses via callback URL. Perfect for Clay users and no-code API integrations.

ParseBird

Website Blueprint Prompter

heyibad/website-blueprint-prompter

Turn any website into AI-ready prompts. This Actor crawls JS-rendered pages, extracts design tokens and assets, detects the tech stack, and generates structured blueprints for AI code generation and fast prototyping.

Muhammad Ibad Ansari

Facebook Events Scraper (No Login Required)

iron-crawler/facebook-search-events

Bulk scrape Facebook event details into JSON/CSV instantly. Zero-config automation designed for rapid event data pipelines and marketing intelligence.

Iron Crawler

test

piercing_runner/input-orchestrator

Test

Big Soup

HTTP Headers Security Audit

techionik9993/http-headers-security-audit

Audit public websites for important HTTP security headers and export practical risk scores, missing headers, and improvement notes for security, SEO, and QA workflows.

Techionik

LangChain.js template

ellustar/my-actor-17

The LangChain.js Template Actor is a ready-to-use foundation for building AI agents with LangChain.js. It supports LLM integration, chains, tools, and memory for fast prototyping and scalable deployment of chatbots, automation workflows, and AI apps.

Ellustar

# This file tells Git which files shouldn't be added to source control .DS_Store .idea dist node_modules apify_storage storage/* !storage/key_value_stores storage/key_value_stores/* !storage/key_value_stores/default storage/key_value_stores/default/* !storage/key_value_stores/default/INPUT.json

{ "name": "http-api", "version": "1.2.0", "type": "module", "description": "Apify actor to call any HTTP API", "engines": { "node": ">=20.0.0" }, "dependencies": { "apify": "^3.4.0", "axios": "^1.8.4" }, "scripts": { "start": "node ./src/main.js", "test": "echo \"Error: oops, the actor has no tests yet, sad!\" && exit 1" }, "author": "Superlative", "license": "ISC" }

1import axios from 'axios'; 2import { log } from 'apify'; 3 4/** 5 * Normalize key-value input from array [{key, value}] or object to plain object. 6 */ 7export function normalizeKeyValue(input) { 8 if (Array.isArray(input)) { 9 return input.reduce((acc, { key, value }) => { 10 acc[key] = value; 11 return acc; 12 }, {}); 13 } 14 if (input && typeof input === 'object') { 15 return input; 16 } 17 return {}; 18} 19 20/** 21 * Execute an HTTP request with retries and return a structured result. 22 * 23 * @param {object} params 24 * @param {string} params.method - HTTP method (GET, POST, etc.) 25 * @param {string} params.endpoint - Target URL 26 * @param {string} [params.body] - Raw request body 27 * @param {Array|object} [params.headers] - Headers as [{key,value}] or object 28 * @param {Array|object} [params.querystring] - Query params as [{key,value}] or object 29 * @param {boolean} [params.response_headers=false] - Include response headers 30 * @param {number} [params.timeoutSeconds=30] - Request timeout 31 * @param {number} [params.maxRetries=3] - Max retry attempts 32 * @param {boolean} [params.include_meta=false] - Include timing metadata 33 * @returns {Promise<object>} Result record 34 */ 35export async function executeRequest({ 36 method, 37 endpoint, 38 body, 39 headers, 40 querystring, 41 response_headers = false, 42 timeoutSeconds = 30, 43 maxRetries = 3, 44 include_meta = false, 45}) { 46 if (!method || !endpoint) { 47 throw new Error('Missing required fields: method and endpoint.'); 48 } 49 50 const headersObj = normalizeKeyValue(headers); 51 const querystringObj = normalizeKeyValue(querystring); 52 53 // Pre-validate JSON body 54 if ( 55 typeof body === 'string' && 56 headersObj['Content-Type']?.includes('application/json') 57 ) { 58 try { 59 JSON.parse(body); 60 } catch { 61 throw new Error('Invalid JSON in `body` field'); 62 } 63 } 64 65 const axiosConfig = { 66 method: method.toLowerCase(), 67 url: endpoint, 68 headers: headersObj, 69 params: querystringObj, 70 data: body, 71 timeout: timeoutSeconds * 1000, 72 validateStatus: () => true, 73 }; 74 75 let response; 76 let attemptsUsed = 0; 77 const startTime = Date.now(); 78 79 for (let attempt = 1; attempt <= maxRetries; attempt++) { 80 attemptsUsed = attempt; 81 try { 82 log.debug('HTTP attempt', { attempt }); 83 response = await axios(axiosConfig); 84 break; 85 } catch (err) { 86 log.warning('Request failed', { attempt, error: err.message }); 87 if (attempt === maxRetries) { 88 throw err; 89 } 90 const delay = 2 ** attempt * 1000; 91 log.info(`Waiting ${delay}ms before retrying…`); 92 await new Promise((res) => setTimeout(res, delay)); 93 } 94 } 95 96 const durationMs = Date.now() - startTime; 97 98 const output = { 99 status: response.status, 100 statusText: response.statusText, 101 response: response.data, 102 }; 103 if (response_headers) output.headers = response.headers; 104 if (include_meta) { 105 output.meta = { 106 requestTimestamp: new Date().toISOString(), 107 durationMs, 108 attempts: attemptsUsed, 109 }; 110 } 111 112 return output; 113}

1import http from 'node:http'; 2import { Actor, log } from 'apify'; 3import { executeRequest } from './http-utils.js'; 4 5const PPE_EVENT = 'http-request'; 6 7await Actor.init(); 8 9if (Actor.config.get('metaOrigin') === 'STANDBY') { 10 startStandbyServer(); 11} else { 12 await runBatchMode(); 13 await Actor.exit(); 14} 15 16// --------------------------------------------------------------------------- 17// Standby mode — HTTP server for instant single-request proxying 18// --------------------------------------------------------------------------- 19 20function startStandbyServer() { 21 const port = Actor.config.get('containerPort'); 22 23 const server = http.createServer(async (req, res) => { 24 // Readiness probe 25 if (req.headers['x-apify-container-server-readiness-probe']) { 26 res.writeHead(200, { 'Content-Type': 'application/json' }); 27 res.end(JSON.stringify({ status: 'ready' })); 28 return; 29 } 30 31 // GET → landing page 32 if (req.method === 'GET') { 33 res.writeHead(200, { 'Content-Type': 'text/html' }); 34 res.end(getLandingPageHtml()); 35 return; 36 } 37 38 // POST only for API calls 39 if (req.method !== 'POST') { 40 res.writeHead(405, { 'Content-Type': 'application/json' }); 41 res.end(JSON.stringify({ error: 'Method not allowed. Use POST.' })); 42 return; 43 } 44 45 try { 46 const body = await readRequestBody(req); 47 let params; 48 try { 49 params = JSON.parse(body); 50 } catch { 51 const err = new Error('Invalid JSON request body.'); 52 err.statusCode = 400; 53 throw err; 54 } 55 56 if (!params.endpoint) { 57 const err = new Error('Missing required field: endpoint.'); 58 err.statusCode = 400; 59 throw err; 60 } 61 62 // Default method to GET if not provided 63 if (!params.method) { 64 params.method = 'GET'; 65 } 66 67 const result = await executeRequest(params); 68 await Actor.pushData(result); 69 70 // Charge PPE 71 try { 72 await Actor.charge({ eventName: PPE_EVENT, count: 1 }); 73 } catch (chargeErr) { 74 console.warn(`PPE charge failed: ${chargeErr.message}`); 75 } 76 77 res.writeHead(200, { 'Content-Type': 'application/json' }); 78 res.end(JSON.stringify(result)); 79 } catch (err) { 80 const statusCode = err.statusCode || 502; 81 res.writeHead(statusCode, { 'Content-Type': 'application/json' }); 82 res.end(JSON.stringify({ error: err.message })); 83 } 84 }); 85 86 server.listen(port, () => { 87 log.info(`HTTP API Standby server listening on port ${port}`); 88 }); 89} 90 91function readRequestBody(req) { 92 return new Promise((resolve, reject) => { 93 const chunks = []; 94 req.on('data', (chunk) => chunks.push(chunk)); 95 req.on('end', () => resolve(Buffer.concat(chunks).toString())); 96 req.on('error', reject); 97 }); 98} 99 100// --------------------------------------------------------------------------- 101// Batch mode — existing pipeline for standard Actor runs 102// --------------------------------------------------------------------------- 103 104async function runBatchMode() { 105 const { 106 method = 'GET', 107 endpoint, 108 body, 109 headers, 110 querystring, 111 response_headers, 112 timeoutSeconds = 30, 113 maxRetries = 3, 114 include_meta = false, 115 } = await Actor.getInput() ?? {}; 116 117 if (!endpoint) { 118 await Actor.fail({ 119 statusMessage: 'Missing required field: endpoint. Example input: { "endpoint": "https://catfact.ninja/fact", "method": "GET" }', 120 }); 121 return; 122 } 123 124 log.info('Starting request', { method, endpoint }); 125 126 const result = await executeRequest({ 127 method, 128 endpoint, 129 body, 130 headers, 131 querystring, 132 response_headers, 133 timeoutSeconds, 134 maxRetries, 135 include_meta, 136 }); 137 138 await Actor.pushData(result); 139 140 // Charge PPE 141 try { 142 await Actor.charge({ eventName: PPE_EVENT, count: 1 }); 143 } catch (chargeErr) { 144 console.warn(`PPE charge failed: ${chargeErr.message}`); 145 } 146 147 if (result.status >= 400) { 148 log.warning(`Received HTTP ${result.status}`); 149 } else { 150 log.info('Request succeeded', { status: result.status }); 151 } 152} 153 154// --------------------------------------------------------------------------- 155// Landing page HTML for Standby mode 156// --------------------------------------------------------------------------- 157 158function getLandingPageHtml() { 159 return `<!DOCTYPE html> 160<html lang="en"> 161<head> 162<meta charset="utf-8"> 163<meta name="viewport" content="width=device-width, initial-scale=1"> 164<title>HTTP API — Superlative</title> 165<link rel="preconnect" href="https://fonts.googleapis.com"> 166<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin> 167<link href="https://fonts.googleapis.com/css2?family=DM+Sans:wght@400;500;700&family=Space+Mono:wght@400;700&display=swap" rel="stylesheet"> 168<style> 169:root{--color-bg:#0a0e14;--color-surface:#12171f;--color-border:#1e2632;--color-text:#e8eaed;--color-text-muted:#8b95a5;--color-accent:#4ade80;--color-accent-dim:rgba(74,222,128,0.15);--font-display:'Space Mono',monospace;--font-body:'DM Sans',sans-serif} 170*{margin:0;padding:0;box-sizing:border-box} 171body{font-family:var(--font-body);background:var(--color-bg);color:var(--color-text);line-height:1.6;min-height:100vh;overflow-x:hidden} 172a{color:var(--color-accent);text-decoration:none;transition:color .2s ease} 173a:hover{color:#6ee7a0} 174.grid-bg{position:fixed;top:0;left:0;width:100%;height:100%;background-image:linear-gradient(var(--color-border) 1px,transparent 1px),linear-gradient(90deg,var(--color-border) 1px,transparent 1px);background-size:60px 60px;opacity:.3;pointer-events:none;z-index:0} 175.accent-line{position:fixed;top:0;left:0;width:100%;height:2px;background:linear-gradient(90deg,transparent 0%,var(--color-accent) 50%,transparent 100%);animation:shimmer 3s ease-in-out infinite;z-index:10} 176@keyframes shimmer{0%,100%{transform:translateX(-100%)}50%{transform:translateX(100%)}} 177@keyframes fadeUp{from{opacity:0;transform:translateY(20px)}to{opacity:1;transform:translateY(0)}} 178.container{position:relative;z-index:1;max-width:900px;margin:0 auto;padding:0 24px} 179header{padding:32px 0} 180.logo{font-family:var(--font-display);font-size:14px;font-weight:700;letter-spacing:.1em;text-transform:uppercase;color:var(--color-text);display:flex;align-items:center;gap:10px;text-decoration:none} 181.logo:hover{color:var(--color-text)} 182.logo-mark{width:28px;height:28px;background:var(--color-accent);display:flex;align-items:center;justify-content:center} 183.logo-mark svg{width:16px;height:16px} 184.hero{padding:80px 0 60px;animation:fadeUp .8s ease-out} 185.hero-label{font-family:var(--font-display);font-size:12px;font-weight:400;letter-spacing:.15em;text-transform:uppercase;color:var(--color-accent);margin-bottom:24px;display:flex;align-items:center;gap:12px} 186.hero-label::before{content:'';width:24px;height:1px;background:var(--color-accent)} 187h1{font-family:var(--font-display);font-size:clamp(28px,5vw,44px);font-weight:700;line-height:1.15;margin-bottom:20px;letter-spacing:-.02em} 188h1 .highlight{color:var(--color-accent)} 189.hero-desc{font-size:18px;color:var(--color-text-muted);max-width:540px;margin-bottom:28px;line-height:1.7} 190.hero-link{font-family:var(--font-display);font-size:13px;letter-spacing:.05em;color:var(--color-accent);display:inline-flex;align-items:center;gap:6px} 191.section{padding:60px 0;border-top:1px solid var(--color-border);animation:fadeUp .8s ease-out .2s backwards} 192.section-label{font-family:var(--font-display);font-size:11px;font-weight:400;letter-spacing:.2em;text-transform:uppercase;color:var(--color-text-muted);margin-bottom:24px} 193h2{font-family:var(--font-display);font-size:20px;font-weight:700;margin-bottom:16px;letter-spacing:-.01em} 194p,li{font-size:15px;color:var(--color-text-muted);line-height:1.7} 195li{margin-bottom:6px} 196ul{margin:.5rem 0 1rem 1.25rem} 197strong{color:var(--color-text);font-weight:600} 198pre{background:var(--color-surface);color:var(--color-text);padding:16px 20px;overflow-x:auto;margin:12px 0 16px;font-family:var(--font-display);font-size:13px;line-height:1.6;border:1px solid var(--color-border)} 199code{font-family:var(--font-display);font-size:13px} 200p code,li code,td code{background:var(--color-accent-dim);color:var(--color-accent);padding:2px 6px} 201table{width:100%;border-collapse:collapse;margin:12px 0 16px;font-size:14px} 202th,td{border:1px solid var(--color-border);padding:10px 14px;text-align:left} 203th{background:var(--color-surface);color:var(--color-text-muted);font-family:var(--font-display);font-size:12px;font-weight:400;letter-spacing:.05em;text-transform:uppercase} 204td{color:var(--color-text-muted)} 205.badge{display:inline-block;background:var(--color-accent-dim);color:var(--color-accent);padding:3px 8px;font-family:var(--font-display);font-size:11px;font-weight:400;letter-spacing:.05em} 206.product-grid{display:grid;grid-template-columns:repeat(auto-fit,minmax(240px,1fr));gap:16px;margin-top:24px} 207.product-card{background:var(--color-surface);border:1px solid var(--color-border);padding:24px;transition:all .3s ease;text-decoration:none;color:inherit;display:block} 208.product-card:hover{border-color:var(--color-accent);transform:translateY(-2px)} 209.product-name{font-family:var(--font-display);font-size:14px;font-weight:700;margin-bottom:8px;color:var(--color-text);display:flex;align-items:center;gap:8px} 210.product-name .status{font-size:9px;font-weight:400;padding:3px 6px;background:var(--color-accent-dim);color:var(--color-accent);letter-spacing:.1em} 211.product-desc{font-size:14px;color:var(--color-text-muted);line-height:1.5} 212footer{padding:48px 0;border-top:1px solid var(--color-border)} 213.footer-content{display:flex;justify-content:space-between;align-items:center;flex-wrap:wrap;gap:24px} 214.footer-text{font-size:13px;color:var(--color-text-muted)} 215.footer-links{display:flex;gap:24px} 216.footer-links a{font-family:var(--font-display);font-size:12px;color:var(--color-text-muted);letter-spacing:.05em} 217.footer-links a:hover{color:var(--color-accent)} 218@media(max-width:600px){.hero{padding:60px 0 40px}.section{padding:40px 0}.footer-content{flex-direction:column;align-items:flex-start}pre{font-size:12px;padding:12px 14px}} 219</style> 220</head> 221<body> 222<div class="grid-bg"></div> 223<div class="accent-line"></div> 224 225<div class="container"> 226 <header> 227 <a href="https://apify.com/superlativetech?fpr=8e9l1" class="logo"> 228 <div class="logo-mark"> 229 <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5"> 230 <polyline points="4 17 10 11 4 5"></polyline> 231 <line x1="12" y1="19" x2="20" y2="19"></line> 232 </svg> 233 </div> 234 Superlative 235 </a> 236 </header> 237 238 <section class="hero"> 239 <div class="hero-label">Utilities</div> 240 <h1>HTTP <span class="highlight">API</span></h1> 241 <p class="hero-desc">General-purpose HTTP request proxy. Make requests to any endpoint through Apify's infrastructure with sub-second Standby response times.</p> 242 <a href="https://apify.com/superlativetech/http-api?fpr=8e9l1" class="hero-link">View on Apify Store →</a> 243 </section> 244 245 <section class="section"> 246 <div class="section-label">Features</div> 247 <h2>What this does</h2> 248 <ul> 249 <li><strong>All HTTP methods</strong> — GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS</li> 250 <li><strong>Custom headers</strong> — send any request headers as key-value pairs</li> 251 <li><strong>Request body</strong> — JSON, form data, or raw text</li> 252 <li><strong>Query strings</strong> — append query parameters to any endpoint</li> 253 <li><strong>Retries</strong> — automatic retries with configurable count</li> 254 <li><strong>Response headers</strong> — optionally capture specific response headers</li> 255 </ul> 256 </section> 257 258 <section class="section"> 259 <div class="section-label">Getting Started</div> 260 <h2>Quick start</h2> 261 <p>Send a POST request to the Standby URL with a JSON body. Replace <code>YOUR_TOKEN</code> with your Apify API token.</p> 262 263 <p style="margin-top:16px"><strong>Simple GET proxy:</strong></p> 264 <pre>curl -X POST "https://superlativetech--http-api.apify.actor?token=YOUR_TOKEN" \\ 265 -H "Content-Type: application/json" \\ 266 -d '{ 267 "endpoint": "https://catfact.ninja/fact" 268 }'</pre> 269 270 <p><strong>POST with headers and body:</strong></p> 271 <pre>curl -X POST "https://superlativetech--http-api.apify.actor?token=YOUR_TOKEN" \\ 272 -H "Content-Type: application/json" \\ 273 -d '{ 274 "endpoint": "https://httpbin.org/post", 275 "method": "POST", 276 "headers": [ 277 {"key": "X-Custom", "value": "hello"} 278 ], 279 "body": {"message": "test"} 280 }'</pre> 281 </section> 282 283 <section class="section"> 284 <div class="section-label">Reference</div> 285 <h2>Request body parameters</h2> 286 <table> 287 <tr><th>Field</th><th>Required</th><th>Default</th><th>Description</th></tr> 288 <tr><td><code>endpoint</code></td><td>Yes</td><td>—</td><td>Target URL to request</td></tr> 289 <tr><td><code>method</code></td><td>No</td><td>GET</td><td>HTTP method (GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS)</td></tr> 290 <tr><td><code>headers</code></td><td>No</td><td>—</td><td>Array of <code>{"key": "...", "value": "..."}</code> objects</td></tr> 291 <tr><td><code>body</code></td><td>No</td><td>—</td><td>Request body (object or string)</td></tr> 292 <tr><td><code>querystring</code></td><td>No</td><td>—</td><td>Array of <code>{"key": "...", "value": "..."}</code> query params</td></tr> 293 <tr><td><code>response_headers</code></td><td>No</td><td>—</td><td>Array of header names to capture from the response</td></tr> 294 <tr><td><code>timeoutSeconds</code></td><td>No</td><td>30</td><td>Request timeout in seconds</td></tr> 295 <tr><td><code>maxRetries</code></td><td>No</td><td>3</td><td>Number of retry attempts on failure</td></tr> 296 <tr><td><code>include_meta</code></td><td>No</td><td>false</td><td>Include timing and redirect metadata</td></tr> 297 </table> 298 </section> 299 300 <section class="section"> 301 <div class="section-label">Response</div> 302 <h2>Response format</h2> 303 <pre>{ 304 "status": 200, 305 "headers": {}, 306 "body": { "fact": "Cats sleep 70% of their lives.", "length": 31 } 307}</pre> 308 </section> 309 310 <section class="section"> 311 <div class="section-label">Cost</div> 312 <h2>Pricing</h2> 313 <p>Pay-per-event pricing on the Apify platform:</p> 314 <table> 315 <tr><th>Tier</th><th>Requests</th><th>Per 1,000</th></tr> 316 <tr><td>Base</td><td>Any</td><td>$0.20</td></tr> 317 <tr><td><span class="badge">Bronze</span></td><td>100+</td><td>$0.18</td></tr> 318 <tr><td><span class="badge">Silver</span></td><td>1,000+</td><td>$0.16</td></tr> 319 <tr><td><span class="badge">Gold</span></td><td>10,000+</td><td>$0.14</td></tr> 320 </table> 321 </section> 322 323 <section class="section"> 324 <div class="section-label">Auth</div> 325 <h2>Authentication</h2> 326 <p>Authenticate using either method:</p> 327 <ul> 328 <li>Query parameter: <code>?token=YOUR_APIFY_TOKEN</code></li> 329 <li>Header: <code>Authorization: Bearer YOUR_APIFY_TOKEN</code></li> 330 </ul> 331 <p style="margin-top:8px">Get your token from <a href="https://console.apify.com/settings/integrations">Apify Console → Settings → Integrations</a>.</p> 332 </section> 333 334 <section class="section"> 335 <div class="section-label">Superlative</div> 336 <h2>More from Superlative</h2> 337 <div class="product-grid"> 338 <a href="https://apify.com/superlativetech/superclean-company-names?fpr=8e9l1" class="product-card"> 339 <div class="product-name">Company Names <span class="status">Live</span></div> 340 <p class="product-desc">Normalize company names for CRM and cold email outreach.</p> 341 </a> 342 <a href="https://apify.com/superlativetech/superclean-job-titles?fpr=8e9l1" class="product-card"> 343 <div class="product-name">Job Titles <span class="status">Live</span></div> 344 <p class="product-desc">Standardize job titles for outreach sequences.</p> 345 </a> 346 <a href="https://apify.com/superlativetech/superclean-person-names?fpr=8e9l1" class="product-card"> 347 <div class="product-name">Person Names <span class="status">Live</span></div> 348 <p class="product-desc">Clean and format person names for personalization.</p> 349 </a> 350 <a href="https://apify.com/superlativetech/superclean-product-names?fpr=8e9l1" class="product-card"> 351 <div class="product-name">Product Names <span class="status">Live</span></div> 352 <p class="product-desc">Normalize product and brand names from exports.</p> 353 </a> 354 <a href="https://apify.com/superlativetech/superclean-places?fpr=8e9l1" class="product-card"> 355 <div class="product-name">Places <span class="status">Live</span></div> 356 <p class="product-desc">Parse and standardize location strings.</p> 357 </a> 358 <a href="https://apify.com/superlativetech/superclean-urls?fpr=8e9l1" class="product-card"> 359 <div class="product-name">URLs <span class="status">Live</span></div> 360 <p class="product-desc">Clean and normalize URLs from lead data.</p> 361 </a> 362 <a href="https://apify.com/superlativetech/superclean-phone-numbers?fpr=8e9l1" class="product-card"> 363 <div class="product-name">Phone Numbers <span class="status">Live</span></div> 364 <p class="product-desc">Format and validate phone numbers.</p> 365 </a> 366 <a href="https://apify.com/superlativetech/dns-lookup?fpr=8e9l1" class="product-card"> 367 <div class="product-name">Supernet DNS Lookup <span class="status">Live</span></div> 368 <p class="product-desc">Instant DNS record lookups and reverse DNS.</p> 369 </a> 370 <a href="https://apify.com/superlativetech/supernet-domain-health?fpr=8e9l1" class="product-card"> 371 <div class="product-name">Domain Health <span class="status">Live</span></div> 372 <p class="product-desc">Email reputation audit: SPF, DKIM, DMARC, blacklists, SSL.</p> 373 </a> 374 </div> 375 </section> 376 377 <footer> 378 <div class="footer-content"> 379 <p class="footer-text">© 2026 Superlative</p> 380 <div class="footer-links"> 381 <a href="https://apify.com/superlativetech?fpr=8e9l1">Apify Store</a> 382 </div> 383 </div> 384 </footer> 385</div> 386 387</body> 388</html>`; 389}

# Specify the base Docker image. You can read more about # the available images at https://docs.apify.com/sdk/js/docs/guides/docker-images # You can also use any other image from Docker Hub. FROM apify/actor-node:20 # Set work directory WORKDIR /usr/src/app # Copy just package.json and package-lock.json # to speed up the build using Docker layer cache. COPY package*.json ./ # Install NPM packages, skip optional and development dependencies to # keep the image small. RUN npm --quiet set progress=false \ && npm install --omit=dev --omit=optional \ && echo "Installed NPM packages:" \ && (npm list --omit=dev --all || true) \ && echo "Node.js version:" \ && node --version \ && echo "NPM version:" \ && npm --version \ && rm -r ~/.npm # Copy the remaining files and directories with the source code. # Since we do this after NPM install, quick build will be really fast # for most source file changes. COPY . . # Run the image. CMD ["npm", "start", "--silent"]

{ "actorSpecification": 1, "fields": { "status": { "type": "integer", "description": "HTTP status code of the response" }, "statusText": { "type": "string", "description": "Status text of the response" }, "response": { "type": "object", "description": "Response data" }, "headers": { "type": "object", "description": "Headers sent in the response" }, "meta": { "type": "object", "description": "Optional metadata: timing, retry count, etc." } }, "views": { "overview": { "title": "Overview", "transformation": { "fields": ["status", "statusText", "response", "headers", "meta"] }, "display": { "component": "table", "properties": { "status": { "label": "Status", "format": "number" }, "statusText": { "label": "Status Text", "format": "text" }, "response": { "label": "Response", "format": "json" }, "headers": { "label": "Headers", "format": "json" }, "meta": { "label": "Metadata", "format": "json" } } } } } }

{ "actorOutputSchemaVersion": 1, "title": "HTTP API Response", "description": "The HTTP response from the API request including status, body, and optional headers/metadata.", "type": "object", "properties": { "results": { "type": "string", "title": "API Response", "template": "{{links.apiDefaultDatasetUrl}}/items?view=overview" } } }

{ "openapi": "3.0.3", "info": { "title": "HTTP API — Standby API", "description": "Instant HTTP request proxying via POST. Send a JSON body with the target endpoint, method, headers, and body — get the proxied response back immediately.", "version": "1.2.0" }, "paths": { "/": { "post": { "summary": "Proxy an HTTP request", "description": "Send a JSON request body describing the HTTP call to make. The Actor executes it and returns the response. Default method is GET if not specified.", "operationId": "proxyRequest", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProxyRequest" }, "examples": { "simpleGet": { "summary": "Simple GET proxy", "value": { "endpoint": "https://catfact.ninja/fact" } }, "postWithHeaders": { "summary": "POST with headers and body", "value": { "method": "POST", "endpoint": "https://postman-echo.com/post", "headers": { "Content-Type": "application/json", "Authorization": "Bearer your-token" }, "body": "{\"message\":\"Hello from Apify!\"}", "include_meta": true } } } } } }, "responses": { "200": { "description": "Proxied HTTP response from the target endpoint.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProxyResponse" }, "examples": { "success": { "summary": "Successful GET", "value": { "status": 200, "statusText": "OK", "response": { "fact": "Cats make about 100 different sounds.", "length": 37 } } }, "withMeta": { "summary": "Response with metadata", "value": { "status": 200, "statusText": "OK", "response": { "data": "..." }, "meta": { "requestTimestamp": "2026-02-06T12:00:00.000Z", "durationMs": 142, "attempts": 1 } } } } } } }, "400": { "description": "Invalid request — missing endpoint, invalid JSON body, or bad parameters.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "examples": { "missingEndpoint": { "summary": "Missing endpoint", "value": { "error": "Missing required field: endpoint." } }, "invalidJson": { "summary": "Invalid JSON request body", "value": { "error": "Invalid JSON request body." } } } } } }, "405": { "description": "Method not allowed — only POST is supported.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "Method not allowed. Use POST." } } } }, "502": { "description": "Bad gateway — target endpoint unreachable after all retries.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "connect ECONNREFUSED 127.0.0.1:9999" } } } } } } } }, "components": { "schemas": { "ProxyRequest": { "type": "object", "required": ["endpoint"], "properties": { "endpoint": { "type": "string", "description": "Target API endpoint URL.", "example": "https://catfact.ninja/fact" }, "method": { "type": "string", "description": "HTTP method. Defaults to GET.", "enum": ["GET", "POST", "PUT", "PATCH", "DELETE"], "default": "GET" }, "headers": { "description": "HTTP headers as `{key: value}` object or `[{key, value}]` array.", "oneOf": [ { "type": "object", "additionalProperties": { "type": "string" } }, { "type": "array", "items": { "type": "object", "properties": { "key": { "type": "string" }, "value": { "type": "string" } }, "required": ["key", "value"] } } ] }, "querystring": { "description": "Query parameters as `{key: value}` object or `[{key, value}]` array.", "oneOf": [ { "type": "object", "additionalProperties": { "type": "string" } }, { "type": "array", "items": { "type": "object", "properties": { "key": { "type": "string" }, "value": { "type": "string" } }, "required": ["key", "value"] } } ] }, "body": { "type": "string", "description": "Raw request body (JSON string, form data, etc.)." }, "timeoutSeconds": { "type": "integer", "description": "Request timeout in seconds.", "default": 30 }, "maxRetries": { "type": "integer", "description": "Retry attempts on network failures.", "default": 3 }, "response_headers": { "type": "boolean", "description": "Include response headers in output.", "default": false }, "include_meta": { "type": "boolean", "description": "Include timing and retry metadata.", "default": false } } }, "ProxyResponse": { "type": "object", "required": ["status", "statusText", "response"], "properties": { "status": { "type": "integer", "description": "HTTP status code from the target endpoint." }, "statusText": { "type": "string", "description": "HTTP status text (e.g., \"OK\", \"Not Found\")." }, "response": { "description": "Parsed response body from the target endpoint." }, "headers": { "type": "object", "description": "Response headers (if response_headers: true)." }, "meta": { "type": "object", "description": "Timing and retry info (if include_meta: true).", "properties": { "requestTimestamp": { "type": "string", "format": "date-time" }, "durationMs": { "type": "integer" }, "attempts": { "type": "integer" } } } } }, "Error": { "type": "object", "required": ["error"], "properties": { "error": { "type": "string", "description": "Human-readable error message." } } } } } }

{ "actorSpecification": 1, "name": "http-api", "title": "HTTP API", "description": "Make HTTP requests from Apify. GET/POST/PUT/DELETE with headers, body, auth. Returns status, headers, body. Building block for automation workflows.", "version": "1.2", "buildTag": "latest", "usesStandbyMode": true, "webServerSchema": "./web_server_openapi.json", "input": "./input_schema.json", "output": "./output_schema.json", "dockerfile": "./Dockerfile", "storages": { "dataset": "./dataset_schema.json" }, "defaultRunOptions": { "build": "latest", "memoryMbytes": 128, "timeoutSecs": 360 }, "minMemoryMbytes": 128, "maxMemoryMbytes": 512 }

{ "title": "HTTP API Input Schema", "type": "object", "schemaVersion": 1, "properties": { "method": { "type": "string", "title": "Method", "enum": ["GET", "POST", "PUT", "PATCH", "DELETE"], "description": "HTTP method", "editor": "select", "default": "GET", "prefill": "GET" }, "endpoint": { "type": "string", "title": "Endpoint", "description": "API endpoint URL", "editor": "textfield", "prefill": "https://catfact.ninja/fact" }, "querystring": { "type": "array", "title": "Querystring", "description": "Querystring parameters", "editor": "keyValue" }, "body": { "type": "string", "title": "Body", "description": "Body of the API call", "editor": "textarea" }, "headers": { "type": "array", "title": "Headers", "description": "HTTP headers to send with the API call", "editor": "keyValue" }, "response_headers": { "type": "boolean", "title": "Include the headers in the response", "description": "If checked, include response headers sent in the output", "editor": "checkbox", "default": false }, "timeoutSeconds": { "type": "integer", "title": "Request timeout (seconds)", "description": "How long to wait before aborting the HTTP request", "default": 30 }, "maxRetries": { "type": "integer", "title": "Max retries", "description": "Number of times to retry on network failures", "default": 3 }, "include_meta": { "type": "boolean", "title": "Include metadata", "description": "If true, include timing & retry metadata in the output", "editor": "checkbox", "default": false } }, "required": ["endpoint"] }

{ "permissions": { "allow": [ "mcp__apify__fetch-apify-docs", "Bash(curl:*)", "mcp__apify__search-apify-docs", "Bash(apify actors pull:*)", "Bash(npm install)", "Bash(apify run:*)", "Bash(cat:*)", "Bash(jq:*)", "Bash(apify push:*)" ] } }

1#!/usr/bin/env node 2 3/** 4 * Standby Integration Tests — HTTP API 5 * 6 * Tests the live Standby API for output format, request forwarding, 7 * edge cases, and error handling. 8 * 9 * Usage: 10 * node tests/standby.test.js 11 */ 12 13import { readFileSync } from 'node:fs'; 14 15const STANDBY_URL = process.env.STANDBY_URL 16 || 'https://superlativetech--http-api.apify.actor'; 17const TOKEN = process.env.APIFY_TOKEN || (() => { 18 try { 19 return JSON.parse(readFileSync(`${process.env.HOME}/.apify/auth.json`, 'utf8')).token; 20 } catch { return null; } 21})(); 22 23let passed = 0; 24let failed = 0; 25const failures = []; 26 27function test(name, fn) { 28 return fn().then(() => { 29 passed++; 30 console.log(` \u2713 ${name}`); 31 }).catch((err) => { 32 failed++; 33 failures.push({ name, error: err.message }); 34 console.log(` \u2717 ${name}: ${err.message}`); 35 }); 36} 37 38function assert(condition, message) { 39 if (!condition) throw new Error(message); 40} 41 42async function post(body) { 43 const url = `${STANDBY_URL}${TOKEN ? `?token=${TOKEN}` : ''}`; 44 const res = await fetch(url, { 45 method: 'POST', 46 headers: { 'Content-Type': 'application/json' }, 47 body: JSON.stringify(body), 48 signal: AbortSignal.timeout(30000), 49 }); 50 const data = await res.json().catch(() => null); 51 return { status: res.status, data }; 52} 53 54async function queryRaw(method = 'GET') { 55 const url = `${STANDBY_URL}${TOKEN ? `?token=${TOKEN}` : ''}`; 56 const res = await fetch(url, { method, signal: AbortSignal.timeout(15000) }); 57 return { status: res.status, contentType: res.headers.get('content-type'), body: await res.text() }; 58} 59 60console.log('\n=== HTTP API — Standby Tests ===\n'); 61 62// --- Output format --- 63console.log('Output Format:'); 64 65await test('Returns status, statusText, response', async () => { 66 const { status, data } = await post({ endpoint: 'https://httpbin.org/get' }); 67 assert(status === 200, `HTTP ${status}`); 68 assert(typeof data.status === 'number', `status should be number: ${typeof data.status}`); 69 assert(typeof data.statusText === 'string', `statusText should be string`); 70 assert('response' in data, 'Missing response field'); 71}); 72 73await test('GET request to JSON endpoint returns parsed JSON', async () => { 74 const { data } = await post({ endpoint: 'https://httpbin.org/get', method: 'GET' }); 75 assert(data.status === 200, `Target status: ${data.status}`); 76 assert(typeof data.response === 'object', `Response should be parsed JSON`); 77}); 78 79// --- Request methods --- 80console.log('\nRequest Methods:'); 81 82await test('POST request forwards body', async () => { 83 const { data } = await post({ 84 endpoint: 'https://httpbin.org/post', 85 method: 'POST', 86 body: JSON.stringify({ test: true }), 87 headers: { 'Content-Type': 'application/json' }, 88 }); 89 assert(data.status === 200, `Target status: ${data.status}`); 90}); 91 92// --- Optional fields --- 93console.log('\nOptional Fields:'); 94 95await test('response_headers includes headers', async () => { 96 const { data } = await post({ 97 endpoint: 'https://httpbin.org/get', 98 response_headers: true, 99 }); 100 assert('headers' in data, 'Missing headers when response_headers=true'); 101 assert(typeof data.headers === 'object', 'Headers should be object'); 102}); 103 104await test('include_meta includes timing info', async () => { 105 const { data } = await post({ 106 endpoint: 'https://httpbin.org/get', 107 include_meta: true, 108 }); 109 assert('meta' in data, 'Missing meta when include_meta=true'); 110 assert(typeof data.meta.durationMs === 'number', 'Meta should have durationMs'); 111 assert(typeof data.meta.attempts === 'number', 'Meta should have attempts'); 112}); 113 114// --- Error handling --- 115console.log('\nError Handling:'); 116 117await test('Landing page returned on GET', async () => { 118 const { status, contentType, body } = await queryRaw('GET'); 119 assert(status === 200, `Expected 200, got ${status}`); 120 assert(contentType.includes('text/html'), `Expected HTML`); 121 assert(body.includes('HTTP') || body.includes('Superlative'), 'Landing page content missing'); 122}); 123 124await test('Missing endpoint returns 400', async () => { 125 const { status, data } = await post({ method: 'GET' }); 126 assert(status === 400, `Expected 400, got ${status}`); 127 assert(data.error.includes('endpoint'), `Error should mention endpoint: ${data.error}`); 128}); 129 130await test('Unreachable endpoint returns 502', async () => { 131 const { status } = await post({ 132 endpoint: 'http://localhost:1', 133 timeoutSeconds: 5, 134 maxRetries: 0, 135 }); 136 assert(status === 502, `Expected 502, got ${status}`); 137}); 138 139// --- Performance --- 140console.log('\nPerformance:'); 141 142await test('Response under 10 seconds', async () => { 143 const start = Date.now(); 144 await post({ endpoint: 'https://httpbin.org/get' }); 145 assert(Date.now() - start < 10000, `Took ${Date.now() - start}ms`); 146}); 147 148// --- Report --- 149console.log(`\n=== Standby Test Results ===`); 150console.log(`Passed: ${passed}, Failed: ${failed}`); 151if (failures.length > 0) { 152 console.log('\nFailures:'); 153 for (const f of failures) console.log(` ${f.name}: ${f.error}`); 154} 155console.log(`\nRESULT: ${failed === 0 ? 'PASS' : 'FAIL'}`); 156process.exit(failed === 0 ? 0 : 1);