[CustomAPI] faceit last games/matches api

​
!addcom -cd=5 !playing $(eval const api = $(urlfetch json https://faceit.lcrypt.eu/?&n=YOUR_FACEIT_USER); if (api.error) {api.message;} else { if (api.current.present) { '$(user), I\'m playing round '+ api.current.round +' on '+ api.current.map +' for '+ api.current.elo +' elo points. Game duration: '+ api.current.duration +' Server: '+ api.current.server  +' Hub: '+ api.current.what} else {'$(user), I\'m playing nothing'}})

output: Xxx, I'm playing round 24 on Mirage for +24/-26 elo points. Game duration: 35' Server: Germany Hub: 5v5 PREMIUM

!playing (short version)

!addcom -cd=5 !playing $(eval const api = $(urlfetch json https://faceit.lcrypt.eu/?&n=YOUR_FACEIT_USER); if (api.error) {api.message;} else { '$(user), I\'m playing '+ api.playing })

output: Xxx, I'm playing FaceIt 5v5 FREE, Overpass (Germany), Elo: +22/-28

!stats (stats from the last played match)

!addcom -cd=5 !stats $(eval const api = $(urlfetch json https://faceit.lcrypt.eu/?n=YOUR_FACEIT_USER); if (api.error) {api.message;} else { '$(user) my last match stats -> ' + api.last_match })

output: Xxx my last match stats -> Victory on Inferno (16:9), KAD: 12/5/20 KDR: 0.6 HS: 50% MVP: 2 ELO: +11)

!ladder (ladder info)

!addcom -cd=5 !ladder $(eval const api = $(urlfetch json https://faceit.lcrypt.eu/?n=YOUR_FACEIT_USER); if (api.error) {api.message;} else { '$(user), I\'m ranked '+ api.ladder })

output: I'm ranked 24 on EU Master League (PTS: 797 W/P: 100/167 WR: 0.6))

!fpl (eu fpl ranking, if playing it, this command is outdated, use !hub command below)

!addcom -cd=5 !fpl $(eval const api = $(urlfetch json https://faceit.lcrypt.eu/?n=YOUR_FACEIT_USER); if (api.error) {api.message;} else { api.fpl })

output: Ranking: 144 (Pts: 1482 WR: 0/2 Last: LOSE 16:9 Mirage)

!hub (user rank on whatever hub you want)

!addcom -cd=5 !hub $(eval const api = $(urlfetch json https://faceit.lcrypt.eu/?o=hub&n=YOUR_FACEIT_USER&h=FACEIT_HUB_ID); if (api.error) {api.message;} else { api.hub })

output: Ranking: 144 (Pts: 1482 WR: 0/2 Last: LOSE 16:9 Mirage)

Remember that your FACEIT USER NAME IS CASE SENSITIVE, copy it from faceit.

FACEIT_HUB_ID: only for !hub command example, you can get it from the faceit hub url on the address bar, it's a value like 74caad23-077b-4ef3-8b1d-c6a2254dfa75 (this is the value for FPL EU, default value) .

Ladder data may won't be available for players not participating on... I've added ladder detailed data, so you can create more flexible commands fitting your needs. Check the second post to find out the available detailed data.

LANGUAGE: Most literals returned by the api can be translated by adding the parameter "&l=LANGUAGE_CODE" to the url. Available language codes are: en (English) no (Norwegian) es (Spanish). If needed, please, ask for your language here.

Examples to get data from any faceit user in your chat (eg: !elo s1mple)

Basically replace YOUR_FACEIT_USER with $(touser) and adapt the text.

Elo command (usage: !elo s1mple)

!addcom -cd=5 !elo $(eval const api = $(urlfetch json https://faceit.lcrypt.eu/?n=$(touser)); if (api.error) {api.message;} else { '$(user), $(touser) elo is '+ api.elo +' (Lvl: '+ api.level +')' })

Last games report (usage: !last s1mple)

!addcom -cd=5 !last $(eval const api = $(urlfetch json https://faceit.lcrypt.eu/?n=$(touser)); if (api.error) {api.message;} else { '$(user) last $(touser) matches -> ' + api.report; })

Last game stats (usage: !stats s1mple)

!addcom -cd=5 !stats $(eval const api = $(urlfetch json https://faceit.lcrypt.eu/?n=$(touser)); if (api.error) {api.message;} else { '$(user) last $(touser) match stats -> ' + api.last_match })

Ladder info (usage: !ladder FlipiN)

!addcom -cd=5 !ladder $(eval const api = $(urlfetch json https://faceit.lcrypt.eu/?n=$(touser)); if (api.error) {api.message;} else { '$(user), $(touser) is ranked '+ api.ladder })

Contact me here if you will find some bugs/errors.

Current api output:

{
    "elo": 3202,
    "level": "10",
    "playing": "FaceIt 5v5 PREMIUM, Vertigo (Netherlands), Elo: +23/-27",
    "current": {
        "present": true,
        "elo": "+23/-27",
        "map": "Vertigo",
        "server": "Netherlands",
        "what": "5v5 PREMIUM",
        "status": "LIVE",
        "score": "14:14",
        "result": "drawing"
    },
    "today": {
        "present": true,
        "count": 2,
        "elo": "+14",
        "elo_win": 35,
        "elo_lose": 21,
        "win": 1,
        "lose": 1
    },
    "detail": {
        "ladder": {
            "division": "Master League",
            "played": 36,
            "points": 81,
            "position": 1575,
            "present": true,
            "region": "EU",
            "win_rate": 0.47,
            "won": 17
        },
        "last": {
            "present": true,
            "map": "Ancient",
            "score": "12:16",
            "kill": 35,
            "assist": 5,
            "dead": 19,
            "mvp": 4,
            "kdr": 1.84,
            "hs_pct": 34,
            "elo": "-25",
            "result": "LOSE"
        }
    },
    "ladder": "1575 on EU Master League (PTS: 81 W/P: 17/36 WR: 0.47)",
    "report": "WIN 16:6 Mirage (+35), LOSE 16:6 Vertigo (-21), LOSE 16:8 Inferno (-14), LOSE 10:16 Nuke (-26), WIN 11:16 Nuke (+24)",
    "trend": "WLLLW",
    "last_match": "Defeat on Ancient (12:16), KAD: 35/5/19 KDR: 1.84 HS: 34% MVP: 4 ELO: -25",
    "hub": "Position 81 (WR: 1/5 Pts: 1480 Last: LOSE 16:8 Vertigo)",
    "region": "EU",
    "country": "ca",
    "country_flag":"🇨🇦",
    "region_ranking": 65269,
    "country_ranking": 109,
    "error": false
}

Notes:

For backward compatibility “hub” is named “fplc” when no o=hub param is given

Hello, is it possible to create command, which will print out possible win/lose elo of current match of certain player?

@Wiry Goose
Is there any way you could specify how to set it up? Like, mine always say “player not found”
Faceit ID is: Proxi

@Kind Wolf

Elo command (command: !elo)
!addcom -cd=5 !elo $(eval const api = $(urlfetch json https://faceit.lcrypt.eu/?n=Proxi); if (api.error) {api.message;} else { '$(user), my elo is '+ api.elo +' (Lvl: '+ api.level +')' })

Last games report command (command: !last)
!addcom -cd=5 !last $(eval const api = $(urlfetch json https://faceit.lcrypt.eu/?n=Proxi); if (api.error) {api.message;} else { '$(user) my last matches -> ' + api.report; })

Last game stats command (command: !stats)
!addcom -cd=5 !stats $(eval const api = $(urlfetch json https://faceit.lcrypt.eu/?n=Proxi); if (api.error) {api.message;} else { '$(user) my last match stats -> ' + api.last_match })

@Silver Eagle

I gonna try but at this moment I don't know how to get this data once the match has started.

@Wiry Goose, thank you my guy!

Is there a way how i can use it for six siege when i play on ps4 username NoVeM_Shotgone

hey, is there someway you can or i can change the output to say: Nederlag på Inferno insteed of: Defeat on Inferno? And how to i input the "trend" in the command?

And, is it possible to make 1 command for all 3^^ So it says, Lvl 10: 2506 and then the last match history and the trend at last?

@Agile Giraffe try this, for instance

$(eval const api = $(urlfetch json https://faceit.lcrypt.eu/?l=YOUR_LANGUAGE&n=YOUR_FACEIT_USER); if (api.error) {api.message;} else { '$(user) --> Lvl '+ api.level +': '+ api.elo +' << '+ api.report +' << '+ api.trend +' << Last game stats: ' + api.last_match })

Output example:
Lvl 7: 1696 << LOSE 19:17 Inferno (-25), WIN 10:16 Inferno (+21), WIN 10:16 Mirage (+22), LOSE 16:8 Inferno (-25), LOSE 16:9 Mirage (-25) << LWWLL << Last game stats: Defeat on Inferno (19:17), KAD: 29/3/23 KDR: 1.26 HS: 31% MVP: 6 ELO: -25

You must replace
YOUR_FACEIT_USER by your faceit user id, remember it's case sensitive.
YOUR_LANGUAGE by your language code (available codes are: Norwegian = no, Spanish = es, English = en)

In this command, where it says "Last game stats" you can rewrite with whatever you want. Everything between single quotes is editable.

Hi there. I've added a new command !ladder. Find out how to add it on the first post.

This command will give info about the faceit league, current position, points and win rate.

Posible output for command !ladder
I'm ranked 104 on EU Master League (PTS: 419 W/P: 55/94 WR: 0.59)

@Wiry Goose is there any way you can do a "elo + trend" command
output example: Lvl: 10 Elo: 2001 Trend: WWLWL
or
Xxx, my elo is 2001 (Lvl: 10) (Trend: WWLWL)

!fplc aint working it says '[Error Connecting To WebEval Service]' what can i do?

Hello @member

I've fixed to show an "error" message: "[player] is not currently playing FPLC". When no actively playing fplc games.

The reason is that I can't have knowledge of the last season you've played, so I can only rely on last early games data.

hi, !fplc doesnt work. Bot says that (fplc player name) is not playing FPLC . How to fix it? p.s. i'm inputting correct YOUR_FACEIT_USER

Is it possible to get a stats command for last 20 matches? the stats faceit enhancer provides just in a twitch command instead?

@Wiry Goose I have a javascript function which calculates the stats of the last 20 match statistics. If it is possible, I can give you the script to add this to your API ?

I fixed fplc data some week ago.

@Topaz Ladybug if you still have this I can try to include it. Sounds good. I've added cache system so I stopped mashing up faceit and wherever I get data.

I'm sorry for the big delay but I fixed this in last weeks. I've included an option to get the user ranking from any faceit hub, specifying it's faceit hub id.

So if you still have this need you'll get this info from FPL, FPLC or whatever hub you need.

Just give look to the main post.

Finally I found the way and the api returns this data on field api.playing.elo, give a look to the second post.

Also I added to the main post a new suggested !playing command with data about the currently playing match.

Added !today command with recent consecutive matches resume of wins, loses and elo balance.

I've also added detailed data of current match so you can play with and create your own customized output.

Hi! Apologizing for respoing too(!) late .Thank you for your stuff , it works perfectly. Have a nice day!

Finally updated for CS2.

There is no action required, it just gonna show the same data from cs2 instead of csgo.

Would it be possible to show ranks on specific leaderboards? Because in some hubs they launch weekly leaderboards instead of only season ones.

have a question, want to use !ladder but change the output from I'm ranked 24 on EU Master League (PTS: 797 W/P: 100/167 WR: 0.6)) to Rank 1 EU, is that possible?

i can think of 2 ways... rank up to rank 1 in the game, or as a gag, modify the output of the command... but for the modify the output part i'd needa see which version of the command u're using, since i've seen a few different ones above

Hey, thank you for the api stuff cause i have no idea how this is working. It worked for me for csgo but now its not working anymore. I saw you changed a bit and copied it but for the nightbot it is too long. So i tryed it with the streamelements and fossabot but i only get the outcome which you can see in the picture. Can someone help me?

Please, give me an example. I checked it out and there's such a complex structure and I'm not sure about which is exactly your case.

It wasn't but I've just added ladder detailed data, so you'd be able to combine it as you prefer.

For that exact petition you can fill a command with this:

$(eval const api = $(urlfetch json https://faceit.lcrypt.eu/?n=YOUR_FACEIT_USER); if (api.error) {api.message;} else if (api.detail.ladder.present) { 'Ranked '+ api.detail.ladder.position +' '+ api.detail.ladder.region })

output: Ranked 7150 EU (this is s1mple :face_with_open_eyes_and_hand_over_mouth:)

Check the second post for the available detailed data.

You're probably doing it incorrectly. You have to copy all this:

!addcom -cd=5 !elo $(eval const api = $(urlfetch json https://faceit.lcrypt.eu/?n=FiveSoF); if (api.error) {api.message;} else { '$(user), my elo is '+ api.elo +' (Lvl: '+ api.level +')' })

and paste it directly in your chat.

I've tested this right now in my chat and it works. If it doesn't, may be your Nightbot is not correctly linked with your twitch account.

If you are not in Twitch platform (i'm not using other chats) and it doesn't work, you can alternatively add a command directly in your Nightbot commands section and paste only this part in the message box.

$(eval const api = $(urlfetch json https://faceit.lcrypt.eu/?n=FiveSoF); if (api.error) {api.message;} else { '$(user), my elo is '+ api.elo +' (Lvl: '+ api.level +')' })

PS: For other readers, note that this examples are from the opening post, and I've hardcoded this user face it id, FiveSoF, so don't copy it directly.

I need exmple ; Elo: 1874. Today: 1W, 2L, -25 elo. The current match: +24/-26 elo

js
!addcom -cd=5 !elo $(eval const api = $(urlfetch json http://api.faceit.myhosting.info:81/?n=YOUR_FACEIT_USER); if (api.error) {api.message;} else { 'Elo: '+ api.elo +'. Today: '+ api.today.win +'W, '+ api.today.lose +'L, '+ api.today.elo +' elo. The current match: '+ api.current.elo + ' elo' })

here ya go... just don't forget to change "YOUR_FACEIT_USER" to your actual username ;)

ty my freind i love you 🙂

Is it possible to somehow display this particular eu rating in the chat?

can u be more specific on what that number is?

that might mean something to somebody that knows about the game, i have no idea... this api gives alotta numbers and none of them r named "ranking" anything... my best guess would be details.ladder.position but that is entirely a guess... but if that's the case, it would be this...

js
$(eval const api = $(urlfetch json http://api.faceit.myhosting.info:81/?n=YOUR_FACEIT_USER); if (api.error) {api.message;} else { api.details.ladder.position })

or to give a bit more detail and make it look prettier...

js
$(eval const api = $(urlfetch json http://api.faceit.myhosting.info:81/?n=YOUR_FACEIT_USER); if (api.error) {api.message;} else { '$(user), I\'m ranked '+ api.ladder })

but don't forget to change "YOUR_FACEIT_USER" to your actual username

ok, I'll try, thanks for the answer and for the help.

@Tranquil Snail
I've just added this data to the response. New fields available:

region
region_ranking
country
country_ranking
country_flag (this pretends to be the flag icon, it works on cellphones but not in all browsers)

So, following @Sassy Narwhal example:

$(eval const api = $(urlfetch json https://faceit.lcrypt.eu/?n=YOUR_FACEIT_USER); if (api.error) {api.message;} else { '$(user), I\'m ranked ' + api.region + ' ' + api.region_ranking })

will give you I'm ranked EU 204

@Wiry Goose
Thank you very much for your work and your wonderful commands, you helped me a lot, have a nice day. 😉

oh, cool... and i see u added it to the json up above too (where i find the info people ask for) ;)

I have figured out how to use all the variables in different context from the api data. But one thing i doesnt understand is the difference between "urlfetch json" and "eval const api", and ofc the: "-cd=5" that u use a lot infront of the commands. Could you maybe explain those 3, so i have a full understanding of what im actually typing? 🙂

$(urlfetch) tells nightbot to acess a website... json tells him what kinda data he's lookin for... $(eval) tells him to evaluate javascript code... const is javascript code declaring a constant variable... api in this instance, is the name of the variable being declared... and -cd=5 sets the cooldown of the command to 5 seconds when u're typing it from the chat using the !addcom or the !commands add command

As requested by dm I've added TLS encryption certificates in order to have secure urls.

You'd also see I've edited my posts with a new domain. That's because I don't have full control over the old one. The previous domain (api.faceit.myhosting.info) will continue work, but it's recommended update urls to the new one, cause I can't guarantee it's life time.

Hello, would it be able to add an api for position in elo, for example.

"PLAYER is Ranked #23 with an ELO of 3756 in EU on Faceit"

and then you can EU/NA/OCE/WORLD etc... maybe this is already doable with api.ladder already, but any help would be nice 🙂

@Cuddly Fox api.region and api.region_ranking are the fields for user region rank.

$(eval const api = $(urlfetch json https://faceit.lcrypt.eu/?n=$(touser)); if (api.error) {api.message;} else { '$(touser) is Ranked #' + api.region_ranking + ' with an ELO of '+ api.elo + ' in '+ api.region + ' on Faceit' })

This eval will give your desired output:
fl0m is Ranked #32 with an ELO of 3443 in NA on Faceit

I used fl0m in this example but you can hardcode your player by replacing both $(touser) references in the eval with your player id.

Super, did you make this just now or was it always available? Sick eitherway, thanks <3

This data was added on last february 20th

how to do this but for other regions? For example my rank in Moldova?

@Sassy Narwhal hey is there any way you can do a “elo + trend” command
output example: Lvl: 10 Elo: 2001 Trend: WWLWL
or
Xxx, my elo is 2001 (Lvl: 10) (Trend: WWLWL)

do you have command like today elo + - and how much elo do you have in same command
need exmple ; Elo: 1874. Today: 1W, 2L, -25 elo. The current match: +24/-26 elo

Yes @Frisky Llama , you can do something like this:
$(eval const api = $(urlfetch json https://faceit.lcrypt.eu/?n=YOUR_FACEIT_USER); if (api.error) {api.message;} else { 'Elo: ' + api.elo +(api.today.present ? '. Today: '+ api.today.win +'W, '+ api.today.lose +'L, '+ api.today.elo +' elo' : '') +(api.current.present ? '. The current match: ' + api.current.elo + ' elo' : '')})

Don’t forget to change “YOUR_FACEIT_USER” to your actual faceit username (case sensitive)

From this command you can expect three different outputs; in case the player has/hasn't played today and if the player is/isn't playing at the moment, you'll get one of this:

Elo: 2885
Elo: 2290. Today: 2W, 1L, +10 elo
Elo: 3881. Today: 5W, 0L, +105 elo. The current match: +20/-30 elo

Hi, can you change this same code to get:

Xxx, my elo is 2885 (Lvl: 10).
Xxx, my elo is 2885 (Lvl: 10). Today: 2W, 1L, +10 elo.
Xxx, my elo is 2885 (Lvl: 10). Today: 5W, 0L, +105 elo. The current match: +20/-30 elo

Thanks in advance 🤎

@Amber Penguin

$(eval const api = $(urlfetch json https://faceit.lcrypt.eu/?n=YOUR_FACEIT_USER); if (api.error) {api.message;} else { '$(user), my elo is ' + api.elo + ' (Lvl: '+ api.level +').' + (api.today.present ? ' Today: '+ api.today.win +'W, '+ api.today.lose +'L, '+ api.today.elo +' elo.' : '') +(api.current.present ? ' The current match: ' + api.current.elo + ' elo' : '')})

pls help I want it to look like this:
Lvl: 0, Elo: 0, Today: +0, Trend: WWWWL

guys i'm trying setup command !elo but nothing work any idea?

@Cool Otter

`$(eval const api = $(urlfetch json https://faceit.lcrypt.eu/?n=YOUR_FACEIT_USER);
if (api.error) {api.message;} else {
'Lvl: '+ api.level +', Elo: ' + api.elo + (api.today.present ? ', Today: ' + api.today.elo : '') +', Trend: ' + api.trend
})`

It will show as you requested, if you haven't played today it'll skip the Today: elo part.

@Agile Ladybug

Did you get it to work?

All these commands will work only if the Nightbot account is properly linked with the Twitch account.

After this, you need to visit your nightbot.tv/dashboard and press the button to make the bot join your chat, if it's not.

The commands in the first post (and which ever command starting with !addcom) are intended for streamer/moderator to copy and paste it straight into your chat in twitch.

You can also create a custom command in your Nightbot dashboard, then you just need to paste the part since $(eval till the end.

Hello everyone,
I have noticed that the change in Elo ("elo", "elo_win", "elo_lose") under “today” is no longer updated. It always remains zero. There were definitely games played today.
Have there been any changes to the Faceit API?

Kind regards
Quai

Yo, what do I put as the command to check other peoples elo? It's the same command to check my own elo. Example, to check my own elo the command prompt is !elo. So what should the command be to check other peoples elo since I cant use the same command?

help pls make this

Elo: 3863. Today -> Win: 3 Lose: 3 Elo: +1

Hi,
i have one question. After how many hours or at what time is the Today parameter reset?

I was wondering if it would be possible to query not only by the Faceit name, but also by the Faceit ID. The reason is that usernames can change, and with the ID it would be much more stable without needing to update the commands every time.

I write this down, I’d try to do something as soon as I can.

Hello, please help me make an answer in this format (numbers as an example), I tried to do this for about two hours, but I can’t get Win/Lose/Elo (diff)

Elo: 2222. Today -> Win: 2 Lose: 0 Elo: +55

Hi,

is it possible to count matches in Hubs as ±0? If you play a game in an unranked hub followed by a standard ± 25 elo ranked match, the elo gain or loss from the ±25 elo ranked match won’t be calculated into your total for the day. Your daily Elo total is consistently undercounting one game.

Hi,

since yesterday the api is returning `` {[...]"message": "no matches found", "error": true[...]}``. is there an error?

same thing, no idea what happened 😦

Faceit included new considerations, but I’m on it.

Could you @Early Leopard give me an example (player name). I’ve problems to find examples of hub players at the moment.

@Tranquil Snail @Early Leopard service is back to work.

As abuse occurred now the service is limited to only accept calls from Nightbot servers.

So, any interested users please refer to the second message in this thread. There you’ll find the full output for this service.

thank you for your work. is it possible to whitelist fossabot? it presents different headers in every request to identify fossabot. for example user-agent: fossabot web proxy. you can read in the docs about it. https://docs.fossabot.com/variables/customapi.

Ok, I’ve added some new filtering now; so fossabot calls will also go through.

I’ve included last game stats detail breakdown which would allow customization for last game stats output if you’d like an own last_match value instead of default one.

Check second post for detail.

[s]My host/VPS provider (the.hosting ← avoid it) has sofered a major incident in its infrastructure and is telling me that will compensate customers because they consider it an unrecoverable issue. I’m inquiring them to restore all my data and backups but I’m affraid that I wont get nothing.[/s]

[s]I’m sorry, but in consequence the service will remain unavailable without a returning date.[/s]

[s]I’m so down now because I’ve lost some databases (which they were supose to backup) about other projects in this hosting, and this service isn’t unfortunatelly my main concern.[/s]

Nevermind.

that sounds really awful. i'm keeping my fingers crossed that you'll manage to get your data back somehow.

wth I forgot that I mirrored this service and is working fine. Just I need a brain check.

How did you implement the current match API? Could you tell me where you get this data from? I’ve been struggling with the Faceit API for a long time trying to implement this for my small service. Or could you tell me if I can use your API to get information about the current match?

No, you can't use this API to get information for another service. It's intended only for chat bots (nightbot and fosabot atm).

If I detect connections for another usage or massive petitions, I block them.

This is for the simple reason that Faceit added last year (like almost any site) a protection layer (cloudflare I guess) which you need to bypass. If this layer detects a massive data retrieval it will block this API. That would happen if I allowed use for obs widgets, third party APIs, etc...

In the other hand, the data retrieval is so simple. Just go to faceit, press F12, go network tab, filter by fetch/xhr, visit a player profile and analyze the requests and responses.

I've fixed some persisting errors algonside with current and last games data issues.

hi,
since a few days it says "no matches found". could you please take a look at it?

Fixed. Thanks for saying.