Wuraren kira a wannan shafin
GET /v1/mobile: Jera toshin mobileGET /v1/mobile/{portId}: Duba toshin mobilePATCH /v1/mobile/{portId}: Sauya suna, kunna/kashe sabuntawa ta atomatik, ko saita sauyawa ta atomatikPOST /v1/mobile/{portId}/rotate: Sauya IP yanzuGET /v1/mobile/{portId}/rotate: Hanyar sauyawa (GET da maɓallin API a query string)POST /v1/mobile/{portId}/reset-password: Ƙirƙiri sabon kalmar sirrin proxy ga toshinGET /v1/mobile/{portId}/usage: Traffic na rana ta toshi (na bayani: data marar iyaka, ƙarƙashin amfani cikin adalci)GET /v1/catalog/countries/{countryCode}/carriers: Kamfanonin mobile masu toshin 4G/5G da suke samuwa a ƙasa
URL na asali https://africaproxies.com/api/v1. Tabbatar da shiga, kurakurai da iyaka: duba bayanin API.
Jera toshin mobile
GET/v1/mobile
Authentication: API madaidaiciya a cikin Authorization: Bearer API_KEY taken.
Amsa 200 OK
{
"data": [
{
"id": "mob_2v8k1q",
"label": "AE Etisalat #1",
"status": "active",
"country": "AE",
"city": null,
"carrier": "etisalat",
"carrierName": "Etisalat",
"networkType": "4G",
"currentIp": "203.0.113.201",
"ipChangedAt": "2026-10-05T14:03:11Z",
"endpoint": {
"host": "gw.africaproxies.com",
"httpPort": 7777,
"socksPort": 7778
},
"username": "USERNAME",
"password": "PASSWORD",
"rotation": {
"mode": "interval",
"intervalMinutes": 10
},
"minRotationIntervalSeconds": 30,
"rotationLink": "https://africaproxies.com/api/v1/mobile/mob_2v8k1q/rotate?key=API_KEY",
"planId": "mob-30d",
"autoRenew": false,
"createdAt": "2026-10-05T14:03:11Z",
"expiresAt": "2026-11-04T14:03:11Z"
}
]
}Misalan lambobin kwamfuta
curl -s "https://africaproxies.com/api/v1/mobile" \
-H "Authorization: Bearer $API_KEY"import os
import requests
API = "https://africaproxies.com/api/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['API_KEY']}"}
r = requests.get(f"{API}/mobile", headers=HEADERS, timeout=30)
r.raise_for_status()
print(r.json())// Node.js 18+ (built-in fetch), ES module
const API = 'https://africaproxies.com/api/v1';
const res = await fetch(`${API}/mobile`, {
headers: { Authorization: `Bearer ${process.env.API_KEY}` },
});
if (!res.ok) throw new Error((await res.json()).error?.message ?? `HTTP ${res.status}`);
console.log(await res.json());Duba toshin mobile
GET/v1/mobile/{portId}
Authentication: API madaidaiciya a cikin Authorization: Bearer API_KEY taken.
Ma'aunin aiki
| Suna | A cikin | Nau'i | Abin bukata | Bayani |
|---|---|---|---|---|
portId | path | string | I | — |
Amsa 200 OK
{
"id": "mob_2v8k1q",
"label": "AE Etisalat #1",
"status": "active",
"country": "AE",
"city": null,
"carrier": "etisalat",
"carrierName": "Etisalat",
"networkType": "4G",
"currentIp": "203.0.113.201",
"ipChangedAt": "2026-10-05T14:03:11Z",
"endpoint": {
"host": "gw.africaproxies.com",
"httpPort": 7777,
"socksPort": 7778
},
"username": "USERNAME",
"password": "PASSWORD",
"rotation": {
"mode": "interval",
"intervalMinutes": 10
},
"minRotationIntervalSeconds": 30,
"rotationLink": "https://africaproxies.com/api/v1/mobile/mob_2v8k1q/rotate?key=API_KEY",
"planId": "mob-30d",
"autoRenew": false,
"createdAt": "2026-10-05T14:03:11Z",
"expiresAt": "2026-11-04T14:03:11Z"
}Misalan lambobin kwamfuta
curl -s "https://africaproxies.com/api/v1/mobile/mob_2v8k1q" \
-H "Authorization: Bearer $API_KEY"import os
import requests
API = "https://africaproxies.com/api/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['API_KEY']}"}
r = requests.get(f"{API}/mobile/mob_2v8k1q", headers=HEADERS, timeout=30)
r.raise_for_status()
print(r.json())// Node.js 18+ (built-in fetch), ES module
const API = 'https://africaproxies.com/api/v1';
const res = await fetch(`${API}/mobile/mob_2v8k1q`, {
headers: { Authorization: `Bearer ${process.env.API_KEY}` },
});
if (!res.ok) throw new Error((await res.json()).error?.message ?? `HTTP ${res.status}`);
console.log(await res.json());Sauya suna, kunna/kashe sabuntawa ta atomatik, ko saita sauyawa ta atomatik
PATCH/v1/mobile/{portId}
Sauya sunan toshi, kunna ko kashe sabuntawa ta atomatik, ko saita lokacin sauyawa ta atomatik daga kowane mintuna 2 zuwa kowane sa'o'i 24: "rotation": { "mode": "interval", "intervalMinutes": 10 } (mintuna 2–1440); "mode": "manual" yana kashe shi. In ba haka ba toshinka yana riƙe IP ɗinsa har sai ka sauya shi, ko da kamfanin sadarwa na iya sauya shi da kansa lokaci-lokaci.
Authentication: API madaidaiciya a cikin Authorization: Bearer API_KEY taken.
Ma'aunin aiki
| Suna | A cikin | Nau'i | Abin bukata | Bayani |
|---|---|---|---|---|
portId | path | string | I | — |
Sashin buƙata
| Fasali | Nau'i | Abin bukata | Bayani |
|---|---|---|---|
label | string | A'a | iyakar haruffa 60 |
autoRenew | boolean | A'a | — |
rotation | object | A'a | Agogon sauyawa ta atomatik: { "mode": "interval", "intervalMinutes": 2–1440 } (daga kowane mintuna 2 zuwa kowane sa'o'i 24), ko { "mode": "manual", "intervalMinutes": null } don sauyawa idan an nema kawai. |
{
"rotation": {
"mode": "interval",
"intervalMinutes": 10
}
}{
"rotation": {
"mode": "manual",
"intervalMinutes": null
}
}Amsa 200 OK
{
"id": "mob_2v8k1q",
"label": "AE Etisalat #1",
"status": "active",
"country": "AE",
"city": null,
"carrier": "etisalat",
"carrierName": "Etisalat",
"networkType": "4G",
"currentIp": "203.0.113.201",
"ipChangedAt": "2026-10-05T14:03:11Z",
"endpoint": {
"host": "gw.africaproxies.com",
"httpPort": 7777,
"socksPort": 7778
},
"username": "USERNAME",
"password": "PASSWORD",
"rotation": {
"mode": "interval",
"intervalMinutes": 10
},
"minRotationIntervalSeconds": 30,
"rotationLink": "https://africaproxies.com/api/v1/mobile/mob_2v8k1q/rotate?key=API_KEY",
"planId": "mob-30d",
"autoRenew": false,
"createdAt": "2026-10-05T14:03:11Z",
"expiresAt": "2026-11-04T14:03:11Z"
}Misalan lambobin kwamfuta
curl -s -X PATCH "https://africaproxies.com/api/v1/mobile/mob_2v8k1q" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"rotation":{"mode":"interval","intervalMinutes":10}}'import os
import requests
API = "https://africaproxies.com/api/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['API_KEY']}"}
r = requests.patch(f"{API}/mobile/mob_2v8k1q", headers=HEADERS, json={"rotation": {"mode": "interval", "intervalMinutes": 10}}, timeout=30)
r.raise_for_status()
print(r.json())// Node.js 18+ (built-in fetch), ES module
const API = 'https://africaproxies.com/api/v1';
const res = await fetch(`${API}/mobile/mob_2v8k1q`, {
method: 'PATCH',
headers: { Authorization: `Bearer ${process.env.API_KEY}`, 'Content-Type': 'application/json' },
body: JSON.stringify({ rotation: { mode: 'interval', intervalMinutes: 10 } }),
});
if (!res.ok) throw new Error((await res.json()).error?.message ?? `HTTP ${res.status}`);
console.log(await res.json());Sauya IP yanzu
POST/v1/mobile/{portId}/rotate
Kowace sauyawa tana sake haɗa toshinka da kamfanin sadarwa domin samun sabon IP, kuma yawanci tana ɗaukar daƙiƙa 5–15; wani lokaci kamfanin na iya mayar da IP ɗaya: sake sauyawa kawai. Sau ɗaya ne mafi yawa a cikin daƙiƙa 30 ga kowane toshi (minRotationIntervalSeconds): neman sauyawa da wuri yana mayar da 429 rotation_too_soon tare da Retry-After (daƙiƙun jira).
Authentication: API madaidaiciya a cikin Authorization: Bearer API_KEY taken.
Ma'aunin aiki
| Suna | A cikin | Nau'i | Abin bukata | Bayani |
|---|---|---|---|---|
portId | path | string | I | — |
Amsa 200 OK
{
"ip": "203.0.113.201",
"previousIp": "203.0.113.77",
"rotatedAt": "2026-10-05T14:03:11Z",
"nextRotationAvailableAt": "2026-10-05T14:03:41Z"
}Misalan lambobin kwamfuta
curl -s -X POST "https://africaproxies.com/api/v1/mobile/mob_2v8k1q/rotate" \
-H "Authorization: Bearer $API_KEY"import os
import requests
API = "https://africaproxies.com/api/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['API_KEY']}"}
r = requests.post(f"{API}/mobile/mob_2v8k1q/rotate", headers=HEADERS, timeout=30)
r.raise_for_status()
print(r.json())// Node.js 18+ (built-in fetch), ES module
const API = 'https://africaproxies.com/api/v1';
const res = await fetch(`${API}/mobile/mob_2v8k1q/rotate`, {
method: 'POST',
headers: { Authorization: `Bearer ${process.env.API_KEY}` },
});
if (!res.ok) throw new Error((await res.json()).error?.message ?? `HTTP ${res.status}`);
console.log(await res.json());Hanyar sauyawa (GET da maɓallin API a query string)
GET/v1/mobile/{portId}/rotate
Daidai da POST, don scripts da alamomin shafi: GET https://africaproxies.com/api/v1/mobile/{portId}/rotate?key=API_KEY. Maɓallin yana buƙatar izinin proxies. format=text yana mayar da sabon IP a matsayin text/plain.
Tabbatar da shiga: API mabuɗi a cikin key query parameter (scope proxies), don haka hanyar za ta yi aiki daga bookmark.
Ma'aunin aiki
| Suna | A cikin | Nau'i | Abin bukata | Bayani |
|---|---|---|---|---|
key | query | string | I | Maɓallinka na API (izinin proxies). |
portId | path | string | I | — |
format | query | json · text | A'a | tsohon saiti json |
Amsa 200 OK
{
"ip": "203.0.113.201",
"previousIp": "203.0.113.77",
"rotatedAt": "2026-10-05T14:03:11Z",
"nextRotationAvailableAt": "2026-10-05T14:03:41Z"
}Misalan lambobin kwamfuta
curl -s "https://africaproxies.com/api/v1/mobile/mob_2v8k1q/rotate?key=$API_KEY&format=text"import os
import requests
API = "https://africaproxies.com/api/v1"
r = requests.get(f"{API}/mobile/mob_2v8k1q/rotate", params={"key": os.environ["API_KEY"], "format": "text"}, timeout=30)
r.raise_for_status()
print(r.text)// Node.js 18+ (built-in fetch), ES module
const API = 'https://africaproxies.com/api/v1';
const res = await fetch(`${API}/mobile/mob_2v8k1q/rotate?key=${process.env.API_KEY}&format=text`);
if (!res.ok) throw new Error((await res.json()).error?.message ?? `HTTP ${res.status}`);
console.log(await res.text());Ƙirƙiri sabon kalmar sirrin proxy ga toshin
POST/v1/mobile/{portId}/reset-password
Authentication: API madaidaiciya a cikin Authorization: Bearer API_KEY taken.
Ma'aunin aiki
| Suna | A cikin | Nau'i | Abin bukata | Bayani |
|---|---|---|---|---|
portId | path | string | I | — |
Amsa 200 OK
{
"id": "mob_2v8k1q",
"label": "AE Etisalat #1",
"status": "active",
"country": "AE",
"city": null,
"carrier": "etisalat",
"carrierName": "Etisalat",
"networkType": "4G",
"currentIp": "203.0.113.201",
"ipChangedAt": "2026-10-05T14:03:11Z",
"endpoint": {
"host": "gw.africaproxies.com",
"httpPort": 7777,
"socksPort": 7778
},
"username": "USERNAME",
"password": "PASSWORD",
"rotation": {
"mode": "interval",
"intervalMinutes": 10
},
"minRotationIntervalSeconds": 30,
"rotationLink": "https://africaproxies.com/api/v1/mobile/mob_2v8k1q/rotate?key=API_KEY",
"planId": "mob-30d",
"autoRenew": false,
"createdAt": "2026-10-05T14:03:11Z",
"expiresAt": "2026-11-04T14:03:11Z"
}Misalan lambobin kwamfuta
curl -s -X POST "https://africaproxies.com/api/v1/mobile/mob_2v8k1q/reset-password" \
-H "Authorization: Bearer $API_KEY"import os
import requests
API = "https://africaproxies.com/api/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['API_KEY']}"}
r = requests.post(f"{API}/mobile/mob_2v8k1q/reset-password", headers=HEADERS, timeout=30)
r.raise_for_status()
print(r.json())// Node.js 18+ (built-in fetch), ES module
const API = 'https://africaproxies.com/api/v1';
const res = await fetch(`${API}/mobile/mob_2v8k1q/reset-password`, {
method: 'POST',
headers: { Authorization: `Bearer ${process.env.API_KEY}` },
});
if (!res.ok) throw new Error((await res.json()).error?.message ?? `HTTP ${res.status}`);
console.log(await res.json());Traffic na rana ta toshi (na bayani: data marar iyaka, ƙarƙashin amfani cikin adalci)
GET/v1/mobile/{portId}/usage
Na bayani kawai. Data marar iyaka a keɓaɓɓen toshinka, ƙarƙashin amfani cikin adalci: kamfanin sadarwa na iya rage sauri ko dakatar da amfani mai nauyi sosai.
Authentication: API madaidaiciya a cikin Authorization: Bearer API_KEY taken.
Ma'aunin aiki
| Suna | A cikin | Nau'i | Abin bukata | Bayani |
|---|---|---|---|---|
portId | path | string | I | — |
from | query | string (date) | A'a | Ranar farko (UTC), har da ita. Tsohon saiti = kwanaki 29 kafin to. |
to | query | string (date) | A'a | Ranar ƙarshe (UTC), har da ita. Tsohon saiti = yau. Iyakar zangon kwanaki 366. |
Amsa 200 OK
{
"from": "2026-10-04",
"to": "2026-10-05",
"totalBytes": 2350000000,
"totalRequests": 48210,
"points": [
{
"date": "2026-10-04",
"bytes": 1200000000,
"requests": 24800
},
{
"date": "2026-10-05",
"bytes": 1150000000,
"requests": 23410
}
],
"byCountry": [
{
"country": "AE",
"bytes": 2350000000
}
]
}Misalan lambobin kwamfuta
curl -s "https://africaproxies.com/api/v1/mobile/mob_2v8k1q/usage" \
-H "Authorization: Bearer $API_KEY"import os
import requests
API = "https://africaproxies.com/api/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['API_KEY']}"}
r = requests.get(f"{API}/mobile/mob_2v8k1q/usage", headers=HEADERS, timeout=30)
r.raise_for_status()
print(r.json())// Node.js 18+ (built-in fetch), ES module
const API = 'https://africaproxies.com/api/v1';
const res = await fetch(`${API}/mobile/mob_2v8k1q/usage`, {
headers: { Authorization: `Bearer ${process.env.API_KEY}` },
});
if (!res.ok) throw new Error((await res.json()).error?.message ?? `HTTP ${res.status}`);
console.log(await res.json());Kamfanonin mobile masu toshin 4G/5G da suke samuwa a ƙasa
GET/v1/catalog/countries/{countryCode}/carriers
Baiwa: ba a buƙatar mabuɗin API.
Ma'aunin aiki
| Suna | A cikin | Nau'i | Abin bukata | Bayani |
|---|---|---|---|---|
countryCode | path | string | I | ISO 3166-1 alpha-2, manyan haruffa. |
Amsa 200 OK
{
"data": [
{
"id": "etisalat",
"name": "Etisalat",
"networkTypes": [
"4G",
"5G"
],
"available": true,
"cities": []
}
]
}Misalan lambobin kwamfuta
curl -s "https://africaproxies.com/api/v1/catalog/countries/AE/carriers"import os
import requests
API = "https://africaproxies.com/api/v1"
r = requests.get(f"{API}/catalog/countries/AE/carriers", timeout=30)
r.raise_for_status()
print(r.json())// Node.js 18+ (built-in fetch), ES module
const API = 'https://africaproxies.com/api/v1';
const res = await fetch(`${API}/catalog/countries/AE/carriers`);
if (!res.ok) throw new Error((await res.json()).error?.message ?? `HTTP ${res.status}`);
console.log(await res.json());