Generating an API key requires to register an account.
Account registrations are free, fast and uncomplicated - done in seconds.
They will help us to track statistics for your generated API key.



Getting started


We are providing an API that allows you to lookup any Steam account.
Furthermore our service will convert your value to all existing forms of Steam IDs.
On request the system will additionally check the Steam account's global ban status.



Endpoint


https://converter.api.dedns.org/



Requests


Requests need to be made to the HTTPS endpoint.

Method
GET


Possible query arguments


Steam URL Steam Vanity URL Steam ID 64 Steam ID 3 Steam ID BattlEye ID Bohemia ID

Query arguments should not be URL encoded.


Basic ID conversation


curl "https://converter.api.dedns.org/76561197960265729"
curl "https://converter.api.dedns.org/74ae012b5407e0a3cc2cd82ec1f8ba7d"
curl "https://converter.api.dedns.org/https://steam.../76561197960265729"


Account details and bans


The GET parameter details is required.

curl "https://converter.api.dedns.org/STEAM_0:1:0?details"


Authorized request


The GET parameter api-key is required.

curl "https://converter.api.dedns.org/[U:1:1]?api-key=test"
curl "https://converter.api.dedns.org/[U:1:1]?details&api-key=test"



Response


Content-Type
application/json

Example response including the Steam account details and bans: 

curl "https://converter.api.dedns.org/76561197960265729?details"

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
{
  "error": false,
  "data": {
    "steam_avatar": "https://steamcdn-a.akama...f56526a5d6989eb_full.jpg",
    "steam_url": "https://steamcommunity.com/profiles/76561197960265729",
    "steam_vanity_url": null,
    "steam_visibility": 3,
    "steam_configured": 1,
    "steam_created": 1063193240,
    "steam_name": "rich",
    "steam_id64": "76561197960265729",
    "steam_id3": "[U:1:1]",
    "steam_id": "STEAM_0:1:0",
    "battleye_id": "74ae012b5407e0a3cc2cd82ec1f8ba7d",
    "bohemia_id": "ccuWIpEIrX_wmD5VsthErf1qNQbEK7IdG6fL1Il4KuA=",
    "bans": {
      "eac": 0,
      "battleye": 0,
      "vac": 0,
      "games": 0,
      "economy": 0,
      "community": 0,
      "last_ban": null
    }
  }
}


Data fields


As ? marked data fields can be NULL if they are private or unavailable.

Field
Type
Description
steam_avatar ?
string
URL of the full size avatar of the Steam account
steam_url
string
URL to the public Steam account website
steam_vanity_url ?
string
Vanity URL to the public Steam account website
steam_visibility ?
integer
1 - the profile is set to private, friends only, etc.
3 - the profile is set to public
steam_configured ?
integer
0 - the Steam community profile is not configured yet
1 - the Steam community profile is configured
steam_created ?
integer
UNIX timestamp in seconds of the Steam account's creation date
steam_name ?
string
Currently defined public name of the Steam account
steam_id64
string
Steam account ID (64 bit)
steam_id3
string
Steam account ID (version 2)
steam_id
string
Original Steam account ID (version 1)
battleye_id
string
BattlEye's hashed version of the Steam ID 64
bohemia_id
string
Bohemia's hashed version of the Steam ID 64
bans -> eac ?
integer
0 - Steam account is not banned by Easy Anti Cheat
1 - Steam account got global banned by Easy Anti Cheat
bans -> battleye ?
integer
0 - Steam account is not banned by BattlEye
1 - Steam account got global banned by BattlEye
bans -> vac ?
integer
Amount of VAC bans on the Steam account
bans -> games ?
integer
Amount of game bans on the Steam account
bans -> economy ?
integer
0 - Steam account is not banned off Steam's market place
1 - Steam account got banned off Steam's market place
bans -> community ?
integer
0 - Steam account is not banned off the Steam platform
1 - Steam account got banned off the Steam platform
bans -> last_ban ?
integer
Time in days since the last ban by Steam
(doesn't include economy bans or bans by BattlEye)


No match found


An invalid query argument will result in the following response: 

1
2
3
4
{
  "error": false,
  "data": null
}



Rate limit


Sending too many unsucessful requests can get your IP address banned.


Unauthorized requests


Requests without an API key are heavily rate limited.
Registering an account will allow you to generate an API key.

Current limitation:

  • 100 requests per day
  • 100 requests per hour   removed
  • 60 requests per minute   removed


Authorized requests


Current limitation:

  • 5.000 requests per day
  • 3.600 requests per hour   removed
  • 300 requests per minute   removed


You need to do more requests?


Please contact our support.
Include details about your project and the expected amount of requests.



Errors


If an error occurs the data field error will be TRUE.

1
2
3
4
{
  "error": true,
  "message": "error message"
}


HTTP status codes


Status code
Possible messages
200 (OK)
none
400 (Bad Request)
Query arguments are missing
403 (Forbidden)
Your IP address got flagged as threat
VPN/proxy use is prohibited
401 (Unauthorized)
The API key is not activated yet
The API key is not allowed to do requests
The API key has expired
The API key is not valid
429 (Too Many Requests)
You have exceeded your request limit
500 (Internal Server Error)
An unexpected error has occured