API Extraction-Todaylist

Todaylist API allows you to get proxies from the 'TodayList'. Below, you will find step-by-step instructions and examples on how to use this API.（This feature is supported in versions 2.1.7 and above）

The Todaylist API supports the following three usage methods:

-Forwarding Random Proxy: Set port to obtain IPs

-TodayList Proxy: Get IP information for 24-hour list

-Custom proxy extraction: Unique identifier (SN) binding port

一、Forwarding Random Proxy

Dynamically get random proxy IP addresses by forwarding through a specified port

Common URL examples:

http://hostname：port/v1/today_random_ip?num=1&country=all&state=all&city=all&t=json&port=30000&isp=all

Parameter Description:

port: forwarding start port (default is 30000)

num: IP number (each proxy corresponds to an independent port)

Step 1: Filter the country/state/city/ISP and other parameter information you need, enter the number of IPs, and select the starting port for forwarding

Note: You can only select countries/states/cities in the todaylist. For available online IPs in the list within 12 hours, the corresponding balance will not be deducted if you extract again. If the status becomes unavailable after 12 hours, and the IP status shows "online", you can continue to extract and use it and the corresponding IP balance will be deducted.

Step 2:Port forwarding information can be viewed through the port forwarding list or 24-hour list; or click "Use Now" to jump directly to the browser.

Step 3: The port forwarding information will be synchronized to the Todaylist. Click the "Copy" button to copy the local IP address and port.

API Parameters Explanation

parameter	Description	Example
country	Country (default All), can filter the countries in the "Todaylist", not case-sensitive; Country code	us
state	State (Default: All)	california
city	City (default All)	losangeles
t	Return format, default json	json/text
isp	ISP operator, default All	camcast
num	Extracted IP number (single ≤ 500)	1
port	Port, default 30000	30000

So how to modify and use parameters? Next I will give an example

1. Use random forwarding proxy in any country

http://hostname：port/v1/today_random_ip?num=1&country=all&state=all&city=all&t=json&port=30000&isp=all

2. Use a random forwarding proxy from the United States

http://hostname：port/v1/today_random_ip?num=1&country=US&state=all&city=all&t=json&port=30000&isp=all

3、Used from the United States, State: Texas

http://hostname：port/v1/today_random_ip?num=1&country=US&state=texas&city=all&t=json&port=30000&isp=all

4、Used from the United States, State: Florida; Province: cape coral

http://hostname：port/v1/today_random_ip?num=1&country=US&state=florida&city=capecoral&t=json&port=30000&isp=all

5、Use the designated ISP's proxy and set ISP=Comcast Cable Communications LLC

http://hostname：port/v1/today_random_ip?num=1&country=all&state=all&city=all&t=json&port=30000&isp=Comcast Cable Communications LLC

6、Set up a random proxy forwarding for port 30001 (set the port number in the settings)

http://hostname：port/v1/today_random_ip?num=1&country=all&state=all&city=all&t=json&port=30001&isp=all

7、To forward multiple IPs, set num=5 (if the number of eligible IPs exceeds the number in the Todaylist, all eligible IPs in the Todaylist will be extracted)

http://hostname：port/v1/today_random_ip?num=5&country=all&state=all&city=all&t=json&port=30000&isp=all

二、Todaylist Proxy

Get the IP information in the Todaylist. The IP can generate a corresponding unique identifier

Common URL examples:

http://hostname：port/v1/today_proxy_list?num=1&country=all&state=all&city=all&t=json&isp=all

Step 1: Filter the country/state/city/ISP information you need and enter the number of IPs;

Step 2: Copy and paste the API URL into the software or script you want to use it in to use the proxy. Or click "Use Now" to jump directly to the browser

Request example:

To forward multiple IPs, set num=3 (if the number of eligible IPs in the Todaylist exceeds the number of eligible IPs in the Todaylist, all eligible IPs in the Todaylist will be extracted)

http://hostname：port/v1/today_proxy_list?num=3&country=all&state=all&city=all&t=json&isp=all

三、Custom proxy extraction

Request custom port forwarding via the proxy's unique identifier (SN)

General URL example: (SN parameter needs to be replaced)

http://hostname：port/v1/today_custom_ip?sn=proxy_sn_from_today_list&t=json&port=30000

Step 1: Set the port value, copy and paste the API URL into your browser

Step 2: Copy the SN parameter of the corresponding IP from the Todaylist and replace the SN information in the example

Request example:

Set port=30002，SN=55af27c7d144ffeb5c6fc13e7e6edcad

http://hostname：port/v1/today_custom_ip?sn=55af27c7d144ffeb5c6fc13e7e6edcad&t=json&port=30002

四、Code Sample

C#

// var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "http://hostname：port/v1/today_random_ip?num=1&country=all&state=all&city=all&t=json&port=30000&isp=all");
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync())

Curl

curl --location "http://hostname：portv1/today_random_ip?num=1&country=all&state=all&city=all&t=json&port=30000&isp=all"

GO

package main

import (
    "fmt"
    "net/http"
    "io"
)

func main() {
    url := http://hostname：port/v1/today_random_ip?num=1&country=all&state=all&city=all&t=json&port=30000&isp=all
    method := "GET"

    client := &http.Client {}
    req, err := http.NewRequest(method, url, nil)
    if err != nil {
        fmt.Println(err)
        return
    }
    res, err := client.Do(req)
    if err != nil {
        fmt.Println(err)
        return
    }
    defer res.Body.Close()
    body, err := io.ReadAll(res.Body)
    if err != nil {
        fmt.Println(err)
        return
    }
    fmt.Println(string(body))
}

Java

const requestOptions = {
    method: "GET",
    redirect: "follow"
};
fetch("http://hostname：port/v1/today_random_ip?num=1&country=all&state=all&city=all&t=json&port=30000&isp=all", requestOptions)
    .then((response) => response.text())
    .then((result) => console.log(result))
    .catch((error) => console.error(error));

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => 'http://hostname：port/v1/today_random_ip?num=1&country=all&state=all&city=all&t=json&port=30000&isp=all',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => '',
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 0,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    CURLOPT_CUSTOMREQUEST => 'GET',
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

五、Error message

If you cannot get proxies through the API, the following errors and reasons may occur:

1. The account balance has been used up, please recharge

2. Interface request failed, please check the network environment and try again

3. No IP matching the set conditions has been found. Please change the parameters.

Through the above tutorial, you can now start using the Todaylist API function of the 922S5 proxy. You can click to download the latest version of the application for use.

If you still have problems, please contact our customer support team (Email - [e-mail]). Please provide us with your details so that our support team can better assist you with your issue.