API publique cfxfind
Accès anonyme en lecture seule aux données publiques normalisées des serveurs FiveM.
Utilisez le même contrat validé que le moteur de recherche. Aucun compte ni clé API n’est requis.
Routes
https://api.cfxfind.com/v1
Toutes les routes acceptent GET et OPTIONS. Les routes de recherche renvoient 200 pour les instantanés complets comme partiels.
/servers/{cfxCode}
GET · Statuts de réponse: 200, 400, 403, 404, 429, 500, 504
OPTIONS · Statuts de réponse: 204
/resolve
GET · Statuts de réponse: 200, 400, 403, 404, 429, 500, 504
OPTIONS · Statuts de réponse: 204
/health
GET · Statuts de réponse: 200
OPTIONS · Statuts de réponse: 204
/build
GET · Statuts de réponse: 200
OPTIONS · Statuts de réponse: 204
/openapi.json
GET · Statuts de réponse: 200
OPTIONS · Statuts de réponse: 204
Statuts de réponse
6 requêtes par période de 60 secondes et par client.
Les recherches réussies sont mises en cache pendant 60 secondes. Les erreurs ne le sont pas.
Réponse complète
{
"data": {
"identity": {
"cfxId": "abc123",
"name": "Example Roleplay",
"description": "A public server description.",
"hostname": "play.example.com",
"iconUrl": null,
"bannerUrl": null,
"locale": "en-US",
"tags": [
"roleplay"
],
"map": "San Andreas",
"gameType": "Roleplay",
"joinUrl": "https://cfx.re/join/abc123",
"ownerName": null
},
"network": {
"endpoint": "play.example.com:30120",
"hostname": "play.example.com",
"port": 30120,
"ipv4": [
"1.1.1.1"
],
"ipv6": [],
"ptr": [
"one.one.one.one"
],
"responseTimeMs": 42,
"asn": "AS13335",
"networkName": "Example Network",
"rir": "ARIN",
"country": "US",
"rdapName": "EXAMPLE-NET",
"rdapHandle": "NET-1-1-1-0-1",
"registrationCountry": "US",
"allocationStart": "1.1.1.0",
"allocationEnd": "1.1.1.255",
"allocationRange": "1.1.1.0 – 1.1.1.255"
},
"runtime": {
"serverVersion": "FXServer-master SERVER v1.0.0.12100 linux",
"artifact": "12100",
"gameBuild": "3258",
"oneSync": true,
"txAdmin": null,
"pureLevel": 1,
"scriptHook": false,
"steamRequired": false,
"enhancedHostSupport": true
},
"players": {
"available": true,
"count": 12,
"max": 64,
"items": [
{
"id": 7,
"name": "Example Player",
"ping": 42
}
]
},
"resources": [
"pma-voice",
"qb-core"
],
"variables": [
{
"key": "gametype",
"value": "Roleplay",
"redacted": false
},
{
"key": "locale",
"value": "en-US",
"redacted": false
},
{
"key": "mapname",
"value": "San Andreas",
"redacted": false
},
{
"key": "onesync",
"value": "on",
"redacted": false
},
{
"key": "sv_enforceGameBuild",
"value": "3258",
"redacted": false
},
{
"key": "sv_maxClients",
"value": "64",
"redacted": false
},
{
"key": "sv_projectDesc",
"value": "A public server description.",
"redacted": false
},
{
"key": "sv_projectName",
"value": "Example Roleplay",
"redacted": false
},
{
"key": "sv_pureLevel",
"value": "1",
"redacted": false
},
{
"key": "sv_scriptHookAllowed",
"value": "false",
"redacted": false
},
{
"key": "sv_steamRequired",
"value": "false",
"redacted": false
},
{
"key": "tags",
"value": "roleplay",
"redacted": false
}
],
"technologies": [
{
"category": "framework",
"name": "QBCore",
"confidence": "direct",
"evidence": [
"resource:qb-core"
]
},
{
"category": "voice",
"name": "pma-voice",
"confidence": "direct",
"evidence": [
"resource:pma-voice"
]
},
{
"category": "utility",
"name": "OneSync",
"confidence": "possible",
"evidence": [
"convar:onesync"
]
}
]
},
"meta": {
"requestId": "req_example_complete",
"state": "complete",
"checkedAt": "2026-07-21T10:00:00.120Z",
"cached": false,
"partial": false,
"durationMs": 120,
"sources": [
{
"name": "join",
"status": "ok",
"durationMs": 10,
"evidence": [
{
"field": "identity.cfxId",
"value": "abc123"
},
{
"field": "identity.joinUrl",
"value": "https://cfx.re/join/abc123"
}
]
},
{
"name": "dns",
"status": "ok",
"durationMs": 15,
"evidence": [
{
"field": "identity.hostname",
"value": "play.example.com"
},
{
"field": "network.endpoint",
"value": "play.example.com:30120"
},
{
"field": "network.hostname",
"value": "play.example.com"
},
{
"field": "network.port",
"value": 30120
},
{
"field": "network.ipv4",
"value": [
"1.1.1.1"
]
},
{
"field": "network.ipv6",
"value": []
},
{
"field": "network.ptr",
"value": [
"one.one.one.one"
]
}
]
},
{
"name": "rdap",
"status": "ok",
"durationMs": 20,
"evidence": [
{
"field": "network.asn",
"value": "AS13335"
},
{
"field": "network.networkName",
"value": "Example Network"
},
{
"field": "network.rir",
"value": "ARIN"
},
{
"field": "network.country",
"value": "US"
},
{
"field": "network.rdapName",
"value": "EXAMPLE-NET"
},
{
"field": "network.rdapHandle",
"value": "NET-1-1-1-0-1"
},
{
"field": "network.registrationCountry",
"value": "US"
},
{
"field": "network.allocationStart",
"value": "1.1.1.0"
},
{
"field": "network.allocationEnd",
"value": "1.1.1.255"
},
{
"field": "network.allocationRange",
"value": "1.1.1.0 – 1.1.1.255"
}
]
},
{
"name": "info",
"status": "ok",
"durationMs": 45,
"evidence": [
{
"field": "identity.name",
"value": "Example Roleplay"
},
{
"field": "identity.description",
"value": "A public server description."
},
{
"field": "identity.locale",
"value": "en-US"
},
{
"field": "identity.tags",
"value": [
"roleplay"
]
},
{
"field": "identity.map",
"value": "San Andreas"
},
{
"field": "identity.gameType",
"value": "Roleplay"
},
{
"field": "runtime.serverVersion",
"value": "FXServer-master SERVER v1.0.0.12100 linux"
},
{
"field": "runtime.artifact",
"value": "12100"
},
{
"field": "runtime.gameBuild",
"value": "3258"
},
{
"field": "runtime.oneSync",
"value": true
},
{
"field": "runtime.pureLevel",
"value": 1
},
{
"field": "runtime.scriptHook",
"value": false
},
{
"field": "runtime.steamRequired",
"value": false
},
{
"field": "runtime.enhancedHostSupport",
"value": true
},
{
"field": "resources.names",
"value": [
"pma-voice",
"qb-core"
]
},
{
"field": "variables.keys",
"value": [
"gametype",
"locale",
"mapname",
"onesync",
"sv_enforceGameBuild",
"sv_maxClients",
"sv_projectDesc",
"sv_projectName",
"sv_pureLevel",
"sv_scriptHookAllowed",
"sv_steamRequired",
"tags"
]
},
{
"field": "technologies.names",
"value": [
"QBCore",
"pma-voice",
"OneSync"
]
},
{
"field": "players.max",
"value": 64
}
]
},
{
"name": "dynamic",
"status": "ok",
"durationMs": 42,
"evidence": [
{
"field": "identity.name",
"value": "Example Roleplay"
},
{
"field": "identity.map",
"value": "San Andreas"
},
{
"field": "identity.gameType",
"value": "Roleplay"
},
{
"field": "players.count",
"value": 12
},
{
"field": "players.max",
"value": 64
},
{
"field": "network.responseTimeMs",
"value": 42
}
]
},
{
"name": "players",
"status": "ok",
"durationMs": 60,
"evidence": [
{
"field": "players.count",
"value": 1
}
]
}
]
},
"errors": []
}Réponse partielle
{
"data": {
"identity": {
"cfxId": "abc123",
"name": "Example Roleplay",
"description": "A public server description.",
"hostname": "play.example.com",
"iconUrl": null,
"bannerUrl": null,
"locale": "en-US",
"tags": [
"roleplay"
],
"map": "San Andreas",
"gameType": "Roleplay",
"joinUrl": "https://cfx.re/join/abc123",
"ownerName": null
},
"network": {
"endpoint": "play.example.com:30120",
"hostname": "play.example.com",
"port": 30120,
"ipv4": [
"1.1.1.1"
],
"ipv6": [],
"ptr": [
"one.one.one.one"
],
"responseTimeMs": 42,
"asn": "AS13335",
"networkName": "Example Network",
"rir": "ARIN",
"country": "US",
"rdapName": "EXAMPLE-NET",
"rdapHandle": "NET-1-1-1-0-1",
"registrationCountry": "US",
"allocationStart": "1.1.1.0",
"allocationEnd": "1.1.1.255",
"allocationRange": "1.1.1.0 – 1.1.1.255"
},
"runtime": {
"serverVersion": "FXServer-master SERVER v1.0.0.12100 linux",
"artifact": "12100",
"gameBuild": "3258",
"oneSync": true,
"txAdmin": null,
"pureLevel": 1,
"scriptHook": false,
"steamRequired": false,
"enhancedHostSupport": true
},
"players": {
"available": false,
"count": 12,
"max": 64,
"items": []
},
"resources": [
"pma-voice",
"qb-core"
],
"variables": [
{
"key": "gametype",
"value": "Roleplay",
"redacted": false
},
{
"key": "locale",
"value": "en-US",
"redacted": false
},
{
"key": "mapname",
"value": "San Andreas",
"redacted": false
},
{
"key": "onesync",
"value": "on",
"redacted": false
},
{
"key": "sv_enforceGameBuild",
"value": "3258",
"redacted": false
},
{
"key": "sv_maxClients",
"value": "64",
"redacted": false
},
{
"key": "sv_projectDesc",
"value": "A public server description.",
"redacted": false
},
{
"key": "sv_projectName",
"value": "Example Roleplay",
"redacted": false
},
{
"key": "sv_pureLevel",
"value": "1",
"redacted": false
},
{
"key": "sv_scriptHookAllowed",
"value": "false",
"redacted": false
},
{
"key": "sv_steamRequired",
"value": "false",
"redacted": false
},
{
"key": "tags",
"value": "roleplay",
"redacted": false
}
],
"technologies": [
{
"category": "framework",
"name": "QBCore",
"confidence": "direct",
"evidence": [
"resource:qb-core"
]
},
{
"category": "voice",
"name": "pma-voice",
"confidence": "direct",
"evidence": [
"resource:pma-voice"
]
},
{
"category": "utility",
"name": "OneSync",
"confidence": "possible",
"evidence": [
"convar:onesync"
]
}
]
},
"meta": {
"requestId": "req_example_partial",
"state": "partial",
"checkedAt": "2026-07-21T10:00:04.120Z",
"cached": false,
"partial": true,
"durationMs": 4120,
"sources": [
{
"name": "join",
"status": "ok",
"durationMs": 10,
"evidence": [
{
"field": "identity.cfxId",
"value": "abc123"
},
{
"field": "identity.joinUrl",
"value": "https://cfx.re/join/abc123"
}
]
},
{
"name": "dns",
"status": "ok",
"durationMs": 15,
"evidence": [
{
"field": "identity.hostname",
"value": "play.example.com"
},
{
"field": "network.endpoint",
"value": "play.example.com:30120"
},
{
"field": "network.hostname",
"value": "play.example.com"
},
{
"field": "network.port",
"value": 30120
},
{
"field": "network.ipv4",
"value": [
"1.1.1.1"
]
},
{
"field": "network.ipv6",
"value": []
},
{
"field": "network.ptr",
"value": [
"one.one.one.one"
]
}
]
},
{
"name": "rdap",
"status": "ok",
"durationMs": 20,
"evidence": [
{
"field": "network.asn",
"value": "AS13335"
},
{
"field": "network.networkName",
"value": "Example Network"
},
{
"field": "network.rir",
"value": "ARIN"
},
{
"field": "network.country",
"value": "US"
},
{
"field": "network.rdapName",
"value": "EXAMPLE-NET"
},
{
"field": "network.rdapHandle",
"value": "NET-1-1-1-0-1"
},
{
"field": "network.registrationCountry",
"value": "US"
},
{
"field": "network.allocationStart",
"value": "1.1.1.0"
},
{
"field": "network.allocationEnd",
"value": "1.1.1.255"
},
{
"field": "network.allocationRange",
"value": "1.1.1.0 – 1.1.1.255"
}
]
},
{
"name": "info",
"status": "ok",
"durationMs": 45,
"evidence": [
{
"field": "identity.name",
"value": "Example Roleplay"
},
{
"field": "identity.description",
"value": "A public server description."
},
{
"field": "identity.locale",
"value": "en-US"
},
{
"field": "identity.tags",
"value": [
"roleplay"
]
},
{
"field": "identity.map",
"value": "San Andreas"
},
{
"field": "identity.gameType",
"value": "Roleplay"
},
{
"field": "runtime.serverVersion",
"value": "FXServer-master SERVER v1.0.0.12100 linux"
},
{
"field": "runtime.artifact",
"value": "12100"
},
{
"field": "runtime.gameBuild",
"value": "3258"
},
{
"field": "runtime.oneSync",
"value": true
},
{
"field": "runtime.pureLevel",
"value": 1
},
{
"field": "runtime.scriptHook",
"value": false
},
{
"field": "runtime.steamRequired",
"value": false
},
{
"field": "runtime.enhancedHostSupport",
"value": true
},
{
"field": "resources.names",
"value": [
"pma-voice",
"qb-core"
]
},
{
"field": "variables.keys",
"value": [
"gametype",
"locale",
"mapname",
"onesync",
"sv_enforceGameBuild",
"sv_maxClients",
"sv_projectDesc",
"sv_projectName",
"sv_pureLevel",
"sv_scriptHookAllowed",
"sv_steamRequired",
"tags"
]
},
{
"field": "technologies.names",
"value": [
"QBCore",
"pma-voice",
"OneSync"
]
},
{
"field": "players.max",
"value": 64
}
]
},
{
"name": "dynamic",
"status": "ok",
"durationMs": 42,
"evidence": [
{
"field": "identity.name",
"value": "Example Roleplay"
},
{
"field": "identity.map",
"value": "San Andreas"
},
{
"field": "identity.gameType",
"value": "Roleplay"
},
{
"field": "players.count",
"value": 12
},
{
"field": "players.max",
"value": 64
},
{
"field": "network.responseTimeMs",
"value": 42
}
]
},
{
"name": "players",
"status": "timeout",
"durationMs": 4000,
"evidence": []
}
]
},
"errors": [
{
"source": "players",
"code": "source_timeout",
"message": "The players source timed out."
}
]
}Réponse d’erreur
{
"data": null,
"meta": {
"requestId": "req_example_400",
"state": "invalid"
},
"errors": [
{
"code": "invalid_input",
"message": "Use a valid CFX code, join URL, or public host and port."
}
]
}Exemples de code
cURL
curl --fail --silent --show-error --header 'Accept: application/json' 'https://api.cfxfind.com/v1/servers/abc123'JavaScript
const response = await fetch("https://api.cfxfind.com/v1/servers/abc123", {
headers: {Accept: "application/json"}
});
if (!response.ok) throw new Error(`Lookup failed: ${response.status}`);
const snapshot = await response.json();Python
import requests
response = requests.get(
"https://api.cfxfind.com/v1/servers/abc123",
headers={"Accept": "application/json"},
timeout=10,
)
response.raise_for_status()
snapshot = response.json()