Eindpunten op deze pagina
GET /v1/mobile: Mobiele poorten weergevenGET /v1/mobile/{portId}: Een mobiele poort ophalenPATCH /v1/mobile/{portId}: Naam wijzigen, automatisch verlengen in- of uitschakelen of automatische rotatie instellenPOST /v1/mobile/{portId}/rotate: Het IP-adres nu wijzigenGET /v1/mobile/{portId}/rotate: Rotatielink (GET met API-sleutel in de querystring)POST /v1/mobile/{portId}/reset-password: Een nieuw proxywachtwoord voor de poort genererenGET /v1/mobile/{portId}/usage: Dagelijks dataverbruik via de poort (ter informatie: onbeperkte data, onder fair use)GET /v1/catalog/countries/{countryCode}/carriers: Mobiele providers met beschikbare 4G/5G-poorten in een land
Basis-URL https://localserpproxy.com/api/v1. Authenticatie, fouten en limieten: zie het API-overzicht.
Mobiele poorten weergeven
GET/v1/mobile
Authenticatie: API-sleutel in de Authorization: Bearer API_KEY-header.
Response 200 OK
{
"data": [
{
"id": "mob_2v8k1q",
"label": "US Verizon #1",
"status": "active",
"country": "US",
"city": null,
"carrier": "verizon",
"carrierName": "Verizon",
"networkType": "4G",
"currentIp": "203.0.113.201",
"ipChangedAt": "2026-10-05T14:03:11Z",
"endpoint": {
"host": "gw.localserpproxy.com",
"httpPort": 7777,
"socksPort": 7778
},
"username": "USERNAME",
"password": "PASSWORD",
"rotation": {
"mode": "interval",
"intervalMinutes": 10
},
"minRotationIntervalSeconds": 30,
"rotationLink": "https://localserpproxy.com/api/v1/mobile/mob_2v8k1q/rotate?key=API_KEY",
"planId": "mob-us-30d",
"autoRenew": false,
"createdAt": "2026-10-05T14:03:11Z",
"expiresAt": "2026-11-04T14:03:11Z"
}
]
}Codevoorbeelden
curl -s "https://localserpproxy.com/api/v1/mobile" \
-H "Authorization: Bearer $API_KEY"import os
import requests
API = "https://localserpproxy.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://localserpproxy.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());Een mobiele poort aanvragen
GET/v1/mobile/{portId}
Authenticatie: API-sleutel in de Authorization: Bearer API_KEY-header.
Parameters
| Naam | In | Type | Verplicht | Beschrijving |
|---|---|---|---|---|
portId | path | string | Ja | — |
Response 200 OK
{
"id": "mob_2v8k1q",
"label": "US Verizon #1",
"status": "active",
"country": "US",
"city": null,
"carrier": "verizon",
"carrierName": "Verizon",
"networkType": "4G",
"currentIp": "203.0.113.201",
"ipChangedAt": "2026-10-05T14:03:11Z",
"endpoint": {
"host": "gw.localserpproxy.com",
"httpPort": 7777,
"socksPort": 7778
},
"username": "USERNAME",
"password": "PASSWORD",
"rotation": {
"mode": "interval",
"intervalMinutes": 10
},
"minRotationIntervalSeconds": 30,
"rotationLink": "https://localserpproxy.com/api/v1/mobile/mob_2v8k1q/rotate?key=API_KEY",
"planId": "mob-us-30d",
"autoRenew": false,
"createdAt": "2026-10-05T14:03:11Z",
"expiresAt": "2026-11-04T14:03:11Z"
}Codevoorbeelden
curl -s "https://localserpproxy.com/api/v1/mobile/mob_2v8k1q" \
-H "Authorization: Bearer $API_KEY"import os
import requests
API = "https://localserpproxy.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://localserpproxy.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());De naam wijzigen, automatisch verlengen in- of uitschakelen of automatische IP-wisseling instellen
PATCH/v1/mobile/{portId}
Wijzig de naam van de poort, schakel automatisch verlengen in of uit, of stel een timer voor automatische IP-wisseling in van elke 2 minuten tot elke 24 uur: "rotation": { "mode": "interval", "intervalMinutes": 10 } (2–1440 minuten); met "mode": "manual" schakel je dit uit. Anders behoudt je poort zijn IP totdat je dit zelf wijzigt, al kan de provider het af en toe zelf veranderen.
Authenticatie: API-sleutel in de Authorization: Bearer API_KEY-header.
Parameters
| Naam | In | Type | Verplicht | Beschrijving |
|---|---|---|---|---|
portId | path | string | Ja | — |
Requestbody
| Veld | Type | Verplicht | Beschrijving |
|---|---|---|---|
label | string | Nee | max. 60 tekens |
autoRenew | boolean | Nee | — |
rotation | object | Nee | Timer voor automatische IP-wisseling: { "mode": "interval", "intervalMinutes": 2–1440 } (elke 2 minuten tot elke 24 uur), of { "mode": "manual", "intervalMinutes": null } om alleen op aanvraag van IP te wisselen. |
{
"rotation": {
"mode": "interval",
"intervalMinutes": 10
}
}{
"rotation": {
"mode": "manual",
"intervalMinutes": null
}
}Response 200 OK
{
"id": "mob_2v8k1q",
"label": "US Verizon #1",
"status": "active",
"country": "US",
"city": null,
"carrier": "verizon",
"carrierName": "Verizon",
"networkType": "4G",
"currentIp": "203.0.113.201",
"ipChangedAt": "2026-10-05T14:03:11Z",
"endpoint": {
"host": "gw.localserpproxy.com",
"httpPort": 7777,
"socksPort": 7778
},
"username": "USERNAME",
"password": "PASSWORD",
"rotation": {
"mode": "interval",
"intervalMinutes": 10
},
"minRotationIntervalSeconds": 30,
"rotationLink": "https://localserpproxy.com/api/v1/mobile/mob_2v8k1q/rotate?key=API_KEY",
"planId": "mob-us-30d",
"autoRenew": false,
"createdAt": "2026-10-05T14:03:11Z",
"expiresAt": "2026-11-04T14:03:11Z"
}Codevoorbeelden
curl -s -X PATCH "https://localserpproxy.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://localserpproxy.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://localserpproxy.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());IP nu wijzigen
POST/v1/mobile/{portId}/rotate
Bij elke IP-wisseling maakt je poort opnieuw verbinding met de provider om een nieuw IP te krijgen. Dit duurt meestal 5–15 seconden. Soms geeft de provider hetzelfde IP opnieuw uit: wissel dan nog een keer. Maximaal één keer per 30 seconden per poort (minRotationIntervalSeconds): wordt een IP-wisseling te snel aangevraagd, dan krijg je 429 rotation_too_soon met Retry-After (het aantal seconden dat je moet wachten).
Authenticatie: API-sleutel in de Authorization: Bearer API_KEY-header.
Parameters
| Naam | In | Type | Verplicht | Beschrijving |
|---|---|---|---|---|
portId | path | string | Ja | — |
Response 200 OK
{
"ip": "203.0.113.201",
"previousIp": "203.0.113.77",
"rotatedAt": "2026-10-05T14:03:11Z",
"nextRotationAvailableAt": "2026-10-05T14:03:41Z"
}Codevoorbeelden
curl -s -X POST "https://localserpproxy.com/api/v1/mobile/mob_2v8k1q/rotate" \
-H "Authorization: Bearer $API_KEY"import os
import requests
API = "https://localserpproxy.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://localserpproxy.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());Link voor IP-wisseling (GET met API-sleutel in de querystring)
GET/v1/mobile/{portId}/rotate
Hetzelfde als POST, voor scripts en bladwijzers: GET https://localserpproxy.com/api/v1/mobile/{portId}/rotate?key=API_KEY. De sleutel moet de scope proxies hebben. format=text geeft het nieuwe IP terug als text/plain.
Authenticatie: API-sleutel in de key-queryparameter (scope proxies), zodat de link vanuit een bladwijzer werkt.
Parameters
| Naam | In | Type | Verplicht | Beschrijving |
|---|---|---|---|---|
key | query | string | Ja | Je API-sleutel (scope proxies). |
portId | path | string | Ja | — |
format | query | json · text | Nee | standaard json |
Response 200 OK
{
"ip": "203.0.113.201",
"previousIp": "203.0.113.77",
"rotatedAt": "2026-10-05T14:03:11Z",
"nextRotationAvailableAt": "2026-10-05T14:03:41Z"
}Codevoorbeelden
curl -s "https://localserpproxy.com/api/v1/mobile/mob_2v8k1q/rotate?key=$API_KEY&format=text"import os
import requests
API = "https://localserpproxy.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://localserpproxy.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());Genereer een nieuw proxypoortwachtwoord
POST/v1/mobile/{portId}/reset-password
Authenticatie: API-sleutel in de Authorization: Bearer API_KEY-header.
Parameters
| Naam | In | Type | Verplicht | Beschrijving |
|---|---|---|---|---|
portId | path | string | Ja | — |
Response 200 OK
{
"id": "mob_2v8k1q",
"label": "US Verizon #1",
"status": "active",
"country": "US",
"city": null,
"carrier": "verizon",
"carrierName": "Verizon",
"networkType": "4G",
"currentIp": "203.0.113.201",
"ipChangedAt": "2026-10-05T14:03:11Z",
"endpoint": {
"host": "gw.localserpproxy.com",
"httpPort": 7777,
"socksPort": 7778
},
"username": "USERNAME",
"password": "PASSWORD",
"rotation": {
"mode": "interval",
"intervalMinutes": 10
},
"minRotationIntervalSeconds": 30,
"rotationLink": "https://localserpproxy.com/api/v1/mobile/mob_2v8k1q/rotate?key=API_KEY",
"planId": "mob-us-30d",
"autoRenew": false,
"createdAt": "2026-10-05T14:03:11Z",
"expiresAt": "2026-11-04T14:03:11Z"
}Codevoorbeelden
curl -s -X POST "https://localserpproxy.com/api/v1/mobile/mob_2v8k1q/reset-password" \
-H "Authorization: Bearer $API_KEY"import os
import requests
API = "https://localserpproxy.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://localserpproxy.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());Dagelijks dataverbruik via de poort (ter informatie: onbeperkte data, onder fair use)
GET/v1/mobile/{portId}/usage
Alleen ter informatie. Onbeperkte data op je eigen poort, onder fair use: de provider kan het gebruik bij zeer intensief verkeer vertragen of tijdelijk onderbreken.
Authenticatie: API-sleutel in de Authorization: Bearer API_KEY-header.
Parameters
| Naam | In | Type | Verplicht | Beschrijving |
|---|---|---|---|---|
portId | path | string | Ja | — |
from | query | string (date) | Nee | Eerste dag (UTC), inclusief. Standaard = 29 dagen vóór to. |
to | query | string (date) | Nee | Laatste dag (UTC), inclusief. Standaard = vandaag. Maximale periode: 366 dagen. |
Response 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": "US",
"bytes": 2350000000
}
]
}Codevoorbeelden
curl -s "https://localserpproxy.com/api/v1/mobile/mob_2v8k1q/usage" \
-H "Authorization: Bearer $API_KEY"import os
import requests
API = "https://localserpproxy.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://localserpproxy.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());Mobiele providers met beschikbare 4G/5G-poorten in een land
GET/v1/catalog/countries/{countryCode}/carriers
Openbaar: geen API-sleutel nodig.
Parameters
| Naam | In | Type | Verplicht | Beschrijving |
|---|---|---|---|---|
countryCode | path | string | Ja | ISO 3166-1 alpha-2, in hoofdletters. |
Response 200 OK
{
"data": [
{
"id": "verizon",
"name": "Verizon",
"networkTypes": [
"4G",
"5G"
],
"available": true,
"cities": []
}
]
}Codevoorbeelden
curl -s "https://localserpproxy.com/api/v1/catalog/countries/US/carriers"import os
import requests
API = "https://localserpproxy.com/api/v1"
r = requests.get(f"{API}/catalog/countries/US/carriers", timeout=30)
r.raise_for_status()
print(r.json())// Node.js 18+ (built-in fetch), ES module
const API = 'https://localserpproxy.com/api/v1';
const res = await fetch(`${API}/catalog/countries/US/carriers`);
if (!res.ok) throw new Error((await res.json()).error?.message ?? `HTTP ${res.status}`);
console.log(await res.json());