ID Converter alias 'converter.tools.dedns.org' is closing it's doors, forever.
All related services will reach their end of life in December 2023.
At the end of the year all services will be discontinued.
All related services will reach their end of life in December 2023.
At the end of the year all services will be discontinued.
With the release of our API endpoint v4, all previously deprecated endpoints have been discontinued.
It's not possible any longer to receive a valid response sending requests to v3 or earlier.
It's not possible any longer to receive a valid response sending requests to v3 or earlier.
Requests still being sent to 'converter.api.dedns.org' will be responded with an error.
Due to compatibility issues and the reset of all API tokens, you will receive a 409 Gone.
For security reasons you are required to register a new account here to generate a new API token.
Due to compatibility issues and the reset of all API tokens, you will receive a 409 Gone.
For security reasons you are required to register a new account here to generate a new API token.
Getting started
This API allows you to lookup and check any existing Steam account.
Get access to public details about the target such as it's profile name, status, the creation date etc.
Furthermore bans of the Steam account issued by Valve or BattlEye can be determined.
Additionally the requested value will be converted to any sort of unique IDs you're also able to lookup.
Get access to public details about the target such as it's profile name, status, the creation date etc.
Furthermore bans of the Steam account issued by Valve or BattlEye can be determined.
Additionally the requested value will be converted to any sort of unique IDs you're also able to lookup.
Authentication
Generating an API token requires to register an account
Account registrations are free, uncomplicated and done in seconds
Account registrations are free, uncomplicated and done in seconds
An authentication at this endpoint is not necessarily required.
The response for unauthorized requests will only include ID conversions.
Requesting details of Steam accounts and known friends does require an authentication.
To authenticate a request provide your API token in the HTTP header or as GET parameter.
The response for unauthorized requests will only include ID conversions.
Requesting details of Steam accounts and known friends does require an authentication.
To authenticate a request provide your API token in the HTTP header or as GET parameter.
-
HTTP header
{ "Authorization": "api-token" }
-
GET parameter
https://api.id-converter.org/76561197960265729?api-key=api-token
Bothapi-key
andapi_key
are valid parameter names to provide your API token.
Requests
A request can be made by adding the value to lookup to the request URI.
Details about a Steam account, e.g. bans or known friends requires to use GET parameters.
Details about a Steam account, e.g. bans or known friends requires to use GET parameters.
-
Request schema
https://api.id-converter.org/value-to-convert-lookup
Steam URL Steam Vanity URL Steam Invite URL Steam ID Hex Steam ID 64 Steam ID 3 Steam ID BattlEye ID Bohemia ID
You can pass an entire URL, for example a Steam URL as value to the request URI.
Various examples of requests including how to determine details can be found below.
Passed values should never be URL encoded. -
Optional parameters
These GET parameters can be used to get details of the Steam account and known friends.detailsused to provide public profile details of the Steam accountbansused to provide details of bans of the Steam accountfriendsused to provide details of known friends of the Steam account
Both GET parameters bans and friends do require the GET parameter details.
curl -X GET "https://api.id-converter.org/76561197960265729?details&api-key=api-token" \
(includes details about the Steam account; does not include ban checks or known friends)
-H "Content-Type: application/json"curl -X GET "https://api.id-converter.org/STEAM_0:1:0?details&bans&api-key=api-token" \
(includes details about the Steam account and ban checks; does not include known friends)
-H "Content-Type: application/json"curl -X GET "https://api.id-converter.org/[U:1:1]?details&bans&friends&api-key=api-token" \
(includes details about the Steam account, ban checks and known friends)
-H "Content-Type: application/json" -
Unauthorized requests
-
curl -X GET "https://api.id-converter.org/https://steam.../profiles/76561197960265729" \
-H "Content-Type: application/json"curl -X GET "https://api.id-converter.org/steamcommunity.com/id/vanity-id" \
-H "Content-Type: application/json" { "error": false, "data": { "steam_url": "https://steamcommunity.com/profiles/76561197960265729", "steam_id_hex": "110000100000001", "steam_id64": "76561197960265729", "steam_id3": "[U:1:1]", "steam_id": "STEAM_0:1:0", "battleye_id": "74ae012b5407e0a3cc2cd82ec1f8ba7d", "bohemia_id": "ccuWIpEIrX_wmD5VsthErf1qNQbEK7IdG6fL1Il4KuA=" } }
-
-
Authorized requests
An authorized request is not automatically a detailed request.
These requests however are not heavily rate limited like unauthorized requests.
-
curl -X GET "https://api.id-converter.org/76561197960265729" \
-H "Content-Type: application/json" \
-H "Authorization: api-token"curl -X GET "https://api.id-converter.org/110000100000001?api-key=api-token" \
-H "Content-Type: application/json" { "error": false, "data": { "steam_url": "https://steamcommunity.com/profiles/76561197960265729", "steam_id_hex": "110000100000001", "steam_id64": "76561197960265729", "steam_id3": "[U:1:1]", "steam_id": "STEAM_0:1:0", "battleye_id": "74ae012b5407e0a3cc2cd82ec1f8ba7d", "bohemia_id": "ccuWIpEIrX_wmD5VsthErf1qNQbEK7IdG6fL1Il4KuA=" } }
-
-
Detailed requests
Detailed requests do not automatically include ban checks and details of known friends.
They can be made by adding the GET parameter details to the request URI.
Optional parameters are required to include ban checks and details of known friends.
-
curl -X GET "https://api.id-converter.org/STEAM_0:1:0?details" \
-H "Content-Type: application/json" \
-H "Authorization: api-token"curl -X GET "https://api.id-converter.org/[U:1:1]?details&api-key=api-token" \
-H "Content-Type: application/json" { "error": false, "data": { "steam_avatar": "https://steamcdn-a...f56526a5d6989eb_full.jpg", "steam_url": "https://steamcommunity.com/profiles/76561197960265729", "steam_vanity_url": null, "steam_invite_url": "https://steamcommunity.com/user/c", "steam_configured": true, "steam_visibility": true, "steam_created": 1063193240, "steam_last_seen": null, "steam_origin": null, "steam_name": "rich", "steam_id_hex": "110000100000001", "steam_id64": "76561197960265729", "steam_id3": "[U:1:1]", "steam_id": "STEAM_0:1:0", "battleye_id": "74ae012b5407e0a3cc2cd82ec1f8ba7d", "bohemia_id": "ccuWIpEIrX_wmD5VsthErf1qNQbEK7IdG6fL1Il4KuA=" } }
-
curl -X GET "https://api.id-converter.org/STEAM_0:1:0?details&bans" \
-H "Content-Type: application/json" \
-H "Authorization: api-token"curl -X GET "https://api.id-converter.org/[U:1:1]?details&bans&api-key=api-token" \
-H "Content-Type: application/json" { "error": false, "data": { "steam_avatar": "https://steamcdn-a...f56526a5d6989eb_full.jpg", "steam_url": "https://steamcommunity.com/profiles/76561197960265729", "steam_vanity_url": null, "steam_invite_url": "https://steamcommunity.com/user/c", "steam_configured": true, "steam_visibility": true, "steam_created": 1063193240, "steam_last_seen": null, "steam_origin": null, "steam_name": "rich", "steam_id_hex": "110000100000001", "steam_id64": "76561197960265729", "steam_id3": "[U:1:1]", "steam_id": "STEAM_0:1:0", "battleye_id": "74ae012b5407e0a3cc2cd82ec1f8ba7d", "bohemia_id": "ccuWIpEIrX_wmD5VsthErf1qNQbEK7IdG6fL1Il4KuA=", "bans": { "battleye": false, "vac": 0, "games": 0, "economy": false, "community": false, "last_ban": { "days": null, "date": null } } } }
-
curl -X GET "https://api.id-converter.org/STEAM_0:1:0?details&friends" \
-H "Content-Type: application/json" \
-H "Authorization: api-token"curl -X GET "https://api.id-converter.org/[U:1:1]?details&friends&api-key=api-token" \
-H "Content-Type: application/json" { "error": false, "data": { "steam_avatar": "https://steamcdn-a...f56526a5d6989eb_full.jpg", "steam_url": "https://steamcommunity.com/profiles/76561197960265729", "steam_vanity_url": null, "steam_invite_url": "https://steamcommunity.com/user/c", "steam_configured": true, "steam_visibility": true, "steam_created": 1063193240, "steam_last_seen": null, "steam_origin": null, "steam_name": "rich", "steam_id_hex": "110000100000001", "steam_id64": "76561197960265729", "steam_id3": "[U:1:1]", "steam_id": "STEAM_0:1:0", "battleye_id": "74ae012b5407e0a3cc2cd82ec1f8ba7d", "bohemia_id": "ccuWIpEIrX_wmD5VsthErf1qNQbEK7IdG6fL1Il4KuA=", "friends": [] } }
-
Response
Content type | application/json |
-
No match found
An invalid value passed in the request URI will return null as data in the response.
{ "error": false, "data": null }
-
Basic response
Without using the GET parameter details the response only include ID conversions.
{ "error": false, "data": { "steam_url": "https://steamcommunity.com/profiles/76561197960265729", "steam_id_hex": "110000100000001", "steam_id64": "76561197960265729", "steam_id3": "[U:1:1]", "steam_id": "STEAM_0:1:0", "battleye_id": "74ae012b5407e0a3cc2cd82ec1f8ba7d", "bohemia_id": "ccuWIpEIrX_wmD5VsthErf1qNQbEK7IdG6fL1Il4KuA=" } }
-
Detailed response
Some fields can be null if they are not set or unavailable due to privacy reasons.
{ "error": false, "data": { "steam_avatar": "https://steamcdn-a...f56526a5d6989eb_full.jpg", "steam_url": "https://steamcommunity.com/profiles/76561197960265729", "steam_vanity_url": null, "steam_invite_url": "https://steamcommunity.com/user/c", "steam_configured": true, "steam_visibility": true, "steam_created": 1063193240, "steam_last_seen": null, "steam_origin": null, "steam_name": "rich", "steam_id_hex": "110000100000001", "steam_id64": "76561197960265729", "steam_id3": "[U:1:1]", "steam_id": "STEAM_0:1:0", "battleye_id": "74ae012b5407e0a3cc2cd82ec1f8ba7d", "bohemia_id": "ccuWIpEIrX_wmD5VsthErf1qNQbEK7IdG6fL1Il4KuA=" } }
-
Data fields
Frields marked as are only available in detailed requests
Frields marked as are only available using the GET parameter bans
Frields marked as are only available using the GET parameter friendsField Type Description steam_avatar string | null URL of the Steam profile avatar steam_url string URL of the Steam profile steam_vanity_url string | null Vanity URL of the Steam profile steam_invite_url string | null Invite URL of the Steam profile steam_configured boolean | null Indicates if the Steam community profile has been configured after it's creation steam_visibility boolean | null Indicates if details of the Steam profile are publicly visible steam_created integer | null Timestamp of the creation date of the Steam account (UTC) steam_last_seen integer | null Timestamp of the last logout of the Steam account (UTC) steam_origin string | null Currently set country code (ISO 3166, two letters) steam_name string Publicly visible Steam profile name steam_id_hex string Steam ID Hexadecimal steam_id64 string Steam ID 64 steam_id3 string Steam ID 3 steam_id string Steam ID (aka. Steam ID 2) battleye_id string Steam ID 64 hash by BattlEye bohemia_id string Steam ID 64 hash by Bohemia Interactive bans object bans->battleye boolean | null Banned by BattlEye bans->vac integer | null The amount of bans issued by Valve bans->games integer | null The amount of game bans bans->economy boolean | null Banned from the Steam community market bans->community boolean | null Banned from the Steam platform bans->last_ban object bans->last_ban->days integer | null The amount of days since the last ban bans->last_ban->date integer | null The date of the last ban (ISO 8601, YYYY-MM-DD) (UTC) friends array | false List of known account bans of friends
(false indicates the account has a private friend list)friends->steam_url string URL of the Steam profile friends->steam_id_hex string Steam ID Hexadecimal friends->steam_id64 string Steam ID 64 friends->battleye_id string Steam ID 64 hash by BattlEye friends->bohemia_id string Steam ID 64 hash by Bohemia Interactive friends->bans object friends->bans->battleye boolean | null Banned by BattlEye friends->bans->vac integer | null The amount of bans issued by Valve friends->bans->games integer | null The amount of game bans friends->bans->economy boolean | null Banned from the Steam community market friends->bans->community boolean | null Banned from the Steam platform friends->bans->last_ban object friends->bans->last_ban->days integer | null The amount of days since the last ban friends->bans->last_ban->date integer | null The date of the last ban (ISO 8601, YYYY-MM-DD) (UTC) -
HTTP status codes
Status code Message Description 200 - The request has been made successfully 400 Bad Request An invalid or no value has been passed to the request URI 401 Unauthorized This request type requires an authentication
The provided API token is invalid403 Forbidden The provided API token has been disabled 404 - No match has been found based on the passed value 429 Too Many Requests
Daily Limited ExceededThe rate limit has been exceeded 500 Internal Server Error An internal server error has occurred 502 Bad Gateway An error has occurred while requesting an external service * 504 Gateway Timeout A timeout has occurred while requesting an external service *
*We depend on external services to fetch informations about Steam accounts and to determine possible bans. These services commonly experience outages.
Rate limit
Unauthorized requests
Requests without authentication are heavily rate limited.
Current limitation |
200 requests per day |
Authorized requests
The current amount of requests done using your API token can found in your user profile.
Current limitation |
5000 requests per day |
Exceeding the rate limit
When exceeding the rate limit the API will respond with an error.
Ignoring this error and continuing your requests can get your API token disabled.
Ignoring this error and continuing your requests can get your API token disabled.
-
{ "error": true, "message": "Too Many Requests", "retry-after": 3600 }
The field retry-after will provide a timeout in seconds when you're allowed to do requests again.
Too many requests per second have been done. -
{ "error": true, "message": "Daily Limited Exceeded", "retry-after": 10800 }
The field retry-after will provide a timeout in seconds when the daily limit will be reset.
Too many requests have been done today.