# Whitelist Usage Tutorial

If you have not purchased PIA Proxy's residential proxy plan, you will not be able to use the endpoint generator related features. [Click here](https://www.piaproxy.com/hk/pay/?paynavVal=8) to buy now

<mark style="color:red;">Please note:</mark> To use the IP whitelist extraction function, the user's IP must be added to the whitelist.



1. **Add IP Whitelist**

Click 【Whitelist】 to add IP whitelist

<figure><img src="https://1208415570-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F52u7wi9B41aCy2DPr6Vu%2Fuploads%2Fj04x52hKVyGqa57inmsB%2F%E5%9B%BE%E7%89%871.png?alt=media&#x26;token=3f1f1a4b-9312-4bdb-9c47-4f8eb8963deb" alt=""><figcaption></figcaption></figure>

You can click 【Add To whitelist】 to quickly save the local whitelist

<figure><img src="https://1208415570-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F52u7wi9B41aCy2DPr6Vu%2Fuploads%2F6Aji8X2Vx394xFvluwa3%2F%E5%9B%BE%E7%89%872.png?alt=media&#x26;token=6d81efa8-51c5-4207-aaa4-05f0a2b3ee25" alt=""><figcaption></figcaption></figure>

You can also enter the IP you want to add and click the 【Add】 button to save.

<figure><img src="https://1208415570-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F52u7wi9B41aCy2DPr6Vu%2Fuploads%2FfXB4Jz5M1xiRK4L7pL2O%2F%E5%9B%BE%E7%89%873.png?alt=media&#x26;token=fd6e5976-50a4-4225-a6e1-4d685aaefeb9" alt=""><figcaption></figcaption></figure>

2. **Whitelist addition completed**

<figure><img src="https://1208415570-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F52u7wi9B41aCy2DPr6Vu%2Fuploads%2FtXYxEv7jVemYIL22Ue3D%2F%E5%9B%BE%E7%89%874.png?alt=media&#x26;token=3feb4da0-e34e-4acb-91e7-c0e72c902380" alt=""><figcaption></figcaption></figure>

3. **Extract using API link**

Select 【Endpoint generator】 on the endpoint generator page

<figure><img src="https://1208415570-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F52u7wi9B41aCy2DPr6Vu%2Fuploads%2FzuiSm07p3M9s6qxxyIOe%2F%E5%9B%BE%E7%89%875.png?alt=media&#x26;token=46f9674b-e443-4945-9029-0bf0d0b31675" alt=""><figcaption></figcaption></figure>

4. **Configure extraction related parameters**

(1) Extraction Type: 【Link Extraction】 Extract IP by opening the generated API link. 【Direct Generation】Direct or area name: port information
\
(2) Region: The country to be extracted
\
(3) Number: Extract quantity
\
Session Type: 【Rotating session】 Select a rotating session to obtain a new IP on each request 【Sticky session】 Keep the same IP address for up to 10 minutes through a sticky session

<figure><img src="https://1208415570-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F52u7wi9B41aCy2DPr6Vu%2Fuploads%2FtgafFJe38jauhhzqGFBk%2F%E5%9B%BE%E7%89%876.png?alt=media&#x26;token=aa1db88a-426d-43e0-915c-5d987846cda3" alt=""><figcaption></figcaption></figure>

You can also modify the relevant parameters directly in AP|Link to configure
\
The following are instructions for modifying parameter configuration

**Modify the number of extracted IPs:**
\
If you need to adjust the number of extracted IPs, please modify the num parameter. For example, change the num parameter to num=15
\
`https://extract.piaproxy.com/getflowip?neek=3573444&num=15&regions=all&ip_si=2`

**Modify the extraction country:**
\
If you need to adjust the extracted countries, please modify the regions parameter. For example, to extract the US IP, change the regions parameter to regions=us
\
`http://piatq.321174.com/getflowip?neek=1119454482&num=10&regions=us&ip_si=2`

[Click here](https://doc.piaproxy.com/zh/zhu-zhai-dai-li-liu-liang-ji-hua/yong-hu-zhang-hu-he-mi-ma-shi-yong-jiao-cheng/gu-ding-guo-jia-di-qu) to view the list of supported countries and codes

**To modify the session type:**
\
If you need to change the session type, please modify the ip\_si parameter. 1 represents a sticky session, and 2 represents a rotating session. For example, if you need to use a rotating session, change the ip\_si parameter to ip\_si=2
\
`http://piatq.321174.com/getflowip?neek=1119454482&num=10&regions=us&ip_si=2`

