cfxfind Genel API
Normalleştirilmiş genel FiveM sunucu bilgilerine anonim ve salt okunur erişim.
Bulucuyla aynı doğrulanmış sözleşmeyi kullanın. Hesap veya API anahtarı gerekmez.
Rotalar
https://api.cfxfind.com/v1
Tüm rotalar GET ve OPTIONS kabul eder. Arama rotaları hem tam hem kısmi anlık görüntüler için 200 döndürür.
/servers/{cfxCode}
GET · Yanıt durumları: 200, 400, 403, 404, 429, 500, 504
OPTIONS · Yanıt durumları: 204
/resolve
GET · Yanıt durumları: 200, 400, 403, 404, 429, 500, 504
OPTIONS · Yanıt durumları: 204
/health
GET · Yanıt durumları: 200
OPTIONS · Yanıt durumları: 204
/build
GET · Yanıt durumları: 200
OPTIONS · Yanıt durumları: 204
/openapi.json
GET · Yanıt durumları: 200
OPTIONS · Yanıt durumları: 204
Yanıt durumları
İstemci başına 60 saniyede 6 istek.
Başarılı aramalar 60 saniye önbelleğe alınır. Hatalar önbelleğe alınmaz.
Tam yanıt
{
"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": []
}Kısmi yanıt
{
"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."
}
]
}Hata yanıtı
{
"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."
}
]
}Kod örnekleri
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()