Send HTTP requests

An Apify actor that allows you to send HTTP requests to any endpoint and view the results.

Overview

This actor provides a simple way to make HTTP requests to any API endpoint without writing code. It supports all common HTTP methods (GET, POST, PUT, PATCH, DELETE), custom headers, URL parameters, and request body data.

Perfect for:

• Clay users who need API integration without upgrading to the Explorer plan
• Testing API endpoints quickly
• One-off HTTP requests for data retrieval or actions
• Debugging web services and APIs

Features

• Support for all major HTTP methods (GET, POST, PUT, PATCH, DELETE)
• Custom header configuration
• URL parameter support
• Request body data (for POST, PUT, PATCH methods)
• Detailed response data including status code, headers, and body
• Simple JSON configuration

Input Parameters

Parameter	Type	Description	Required
method	String	HTTP method to use (GET, POST, PUT, PATCH, DELETE)	Yes
url	String	The URL to make the request to	Yes
headers	Object	Custom headers to be sent with the request	No
params	Object	URL parameters to be sent with the request	No
data	Object	Data to be sent as the request body (for POST, PUT, PATCH)	No

Example Input

1{
2  "method": "GET",
3  "url": "https://api.example.com/data",
4  "headers": {
5    "Authorization": "Bearer your-token-here",
6    "Content-Type": "application/json"
7  },
8  "params": {
9    "limit": 10,
10    "offset": 0
11  }
12}

Output

The actor returns an object with the following structure:

1{
2  "data": {}, // The response body
3  "status": 200, // HTTP status code
4  "statusText": "OK", // HTTP status text
5  "headers": {} // Response headers
6}

Usage with Clay

Clay users can integrate this actor into their tables to make API calls without upgrading to the Explorer plan. Here's how:

1. Create an Apify account and set up your API token
2. In Clay, use the Apify integration and select this actor
3. Configure the HTTP request parameters in the Clay interface
4. Map the response data to your Clay table columns

This provides significant cost savings over upgrading to the Explorer plan ($200 difference) while still enabling API functionality.

Limitations

• The actor has a timeout limit based on your Apify plan

Example Use Cases

1. Fetch data from a public API

   1{
   2  "method": "GET",
   3  "url": "https://api.publicapis.org/entries",
   4  "params": {
   5    "category": "animals",
   6    "https": true
   7  }
   8}
   

2. Post data to an API endpoint

   1{
   2  "method": "POST",
   3  "url": "https://api.example.com/users",
   4  "headers": {
   5    "Content-Type": "application/json",
   6    "Authorization": "Bearer your-token"
   7  },
   8  "data": {
   9    "name": "John Doe",
   10    "email": "john@example.com"
   11  }
   12}
   

3. Update existing data

   1{
   2  "method": "PATCH",
   3  "url": "https://api.example.com/users/123",
   4  "headers": {
   5    "Content-Type": "application/json",
   6    "Authorization": "Bearer your-token"
   7  },
   8  "data": {
   9    "email": "newemail@example.com"
   10  }
   11}
   

License

ISC

Author

Mohd Rizuan