Parameter	Type	Description	Required	Default
api_url	string	The URL of the API to call	Yes	-
method	string	HTTP method (GET, POST, PUT, DELETE, PATCH)	Yes	GET
headers	object	HTTP headers for the request	No	{}
body	object	Request body for POST/PUT/PATCH requests	No	null
use_apify_proxy	boolean	Whether to use Apify proxy	No	true
proxy_groups	array	Proxy groups to use (RESIDENTIAL, DATACENTER)	No	["RESIDENTIAL"]
country_code	string	Country code for proxy	No	"US"
custom_proxy	string	Custom proxy URL if not using Apify proxy	No	null
max_retries	integer	Maximum number of retry attempts	No	3
timeout_seconds	integer	Request timeout in seconds	No	30

Example Input

{
    "api_url": "https://v2.jokeapi.dev/joke/Any",
    "method": "GET",
    "headers": {
        "Accept": "application/json"
    },
    "use_apify_proxy": true,
    "proxy_groups": ["RESIDENTIAL"],
    "country_code": "US",
    "max_retries": 3,
    "timeout_seconds": 30
}

Output Schema

The actor returns the following output structure:

Field	Type	Description
status	integer	HTTP status code of the response
result	object/string	Response body (parsed JSON or raw text)
error	string	Error message if request failed

Example Output

Successful response:

{
    "status": 200,
    "result": {
        "setup": "Why don't scientists trust atoms?",
        "delivery": "Because they make up everything!",
        "type": "twopart"
    },
    "error": null
}

Error response:

{
    "status": null,
    "result": null,
    "error": "Failed to connect to the API after 3 attempts"
}

On this page

API Proxy Actor
- Input Schema
  - Example Input
- Output Schema
  - Example Output

Share Actor:

Fast Tiktok Downloader API

wilcode/fast-tiktok-downloader-api

A powerful API for downloading TikTok videos, images and music with high success rate, flexible proxy support, and complete metadata extraction.

Wilcode

5.0

IG Profile Engagement Rate

autometera/ig-profile-engagement-rate

This tool scrapes Instagram profiles and gives you an engagement rate.

Awais Younis

Proxy Test

apify/proxy-test

This actor simply tests given array of URLs against selected proxy URLs or Apify proxy groups.

Apify

440

4.7

Fav / Like Tweet API｜ Twitter | 2025 | $10/m | No Rate Limits

fastcrawler/fav-like-tweet-api-twitter-2025-10-m-no-rate-limits

Auto-like tweets without Twitter API or a developer account. Unlimited usage for just $10/month.

fastcrawler

Apify Store Scraper API

louisdeconinck/apify-store-scraper-api

The Apify Store Scraper API allows you to extract detailed information about actors from the Apify Store, including actor details, pricing, metrics, categories, and user information.

Louis Deconinck

5.0

Airbnb Price Scraper

dataharvester/airbnb-price-scraper

Instantly scrape Airbnb pricing data to access detailed rate information for any room ID.

DataHarvester

Residential Proxy Probe

jancurn/residential-proxy-probe

Find residential proxy sessions on Apify Proxy with target IP addresses geo-located in specific postal codes or DMAs.

Jan Čurn

654

Ultimate Articles Extractor

web.harvester/ultimate-articles-extractor

A powerful and modular web scraping tool designed to extract content from any webpage, article, or news site. Get clean, structured data from any website with optimized extraction algorithms, anti-bot detection avoidance, and proxy support.