FFScouter is a free tool. It is a tool designed to help estimate the difficulty and battle stats of your opponents. Using this tool will not expose any information about yourself to other players, nor will you be able to view information about others except battle stat estimates. Your actual battle stats, and those of others, will remain private and are not stored in the raw form (see bss_private definition below). Any stat estimates made are available for any person or group to access and use, free of charge, for any purpose.

FFScouter is not affiliated with Torn, it is an independent community tool.

FFScouter is developed by Glasnost [1844049]. Please join our Discord server for support and updates.

Generate Custom API Key

Please use a Custom key for FFScouter. New permissions attached as of 16th September 2025 - Click here for more information.

TornPDA users are recommended to use their TornPDA key due to known issues with TornPDA's script handling.

Use old permissions (pre-16th September 2025) - May limit other FFScouter features

API Key

Terms and Conditions

I understand FFScouter will make API requests to Torn using my API key to obtain the information set out on this page. These requests will only be for information about me and my attacks, and may be made up to 12 times per day. If the terms of this service change, my key will be deleted and I will be required to accept the new conditions before I may use it again. I understand my data will be used to make predictions about the battle stats of people who I attack, or who have attacked me. The estimates of other people will then become public, and FFScouter has no control or knowledge how it may be used by third parties. I understand the battle stat predictions of other people will be provided free of charge to other users of FFScouter (the general public). These estimates, once made, belong to FFScouter. I understand that by using FFScouter, I am contributing to this shared pool of stat estimates of other people, and using it will not update my own public stat estimates and my own raw battle stats will never be provided to anyone else or stored in the database. I can remove my API key from FFScouter at any time by deleting or pausing the API key in the Torn API Settings page. At the next occasion when FFScouter attempts to update your data and Torn's API indicates your key is paused or deleted, your private information will be deleted. Estimates of your battle stats calculated by other people, are not deleted. Alternatively, using the form at the bottom of this page will remove all of my API keys and private data (ie not my player ID or bss_public score). I have read and agree to the terms and conditions set out on this page. I will direct any questions to Glasnost [1844049] prior to signing up.

Sign Up

After you have signed up, please allow up to 5 minutes for your tool of choice to display stat estimates.

Details of our data policy can be found below. Please note this policy only covers the main FFScouter service/tool as your API key is used, and does not cover the volunteer data gathering service.

Torn API selections requested (Core FFScouter): basic, battlestats, attacks, hof

Additional selections (Post 16th September 2025): profile, cooldowns, refills, faction (members, rankedwarreport, warfare, wars, rankedwars), torn (rankedwarreport, rankedwars)

Data Stored: player_id, bss_private (*), bss_private_timestamp (*), bss_public (**), bss_public_timestamp (**), API key, created_at, last_updated

Basis for request selections:

• basic: Contains your player_id so we can attribute the data correctly
• battlestats: This is used to calculate your bss_private, but the raw stat data is not stored once this is calculated
• attacks: Retrieves your opponents and the Fair Fight score so we can calculate their bss_public
• hof: Identifies players who are in the top 1,000 HoF for battle stats (FF entries excluded)

Attack history is used with your bss_private (a score only you can see and is stored on FFScouter) to estimate opponents' bss_public (a score everyone can see). We never store who updated a public score, except temporarily to help diagnose any errors we encounter and will share it with Torn Admins. This will be deleted when it is no longer required, but no later than 30 days after it was saved in any case.

Your attack logs are not saved to the database at any point; they are deleted once analysed (usually within 1–2 seconds of a request being made using your key, exceptionally up to 10 seconds). Attack logs are never saved to the database, shared, or sold.

(*) Your bss_private is calculated from your battle stats using the formula found on the Torn Wiki (Fair fights). It is stored by FFScouter to provide you with an accurate estimated "Fair Fight" score of your opponent. It is never visible to other users, sold, shared or used except to enable you to use the service. The bss_private_timestamp is used to schedule updates to your bss_private score by storing the last time it was updated.

(**) Your bss_private is then used, alongside the Fair Fight score from each attack requested, to estimate the bss_public of your opponents where they are known (i.e. not stealthed). This bss_public is stored against their profile, but with the exception of fixing bugs (noted above), we do not store that your score provided this estimate. A bss_public also has a "bss_public_timestamp" associated with it, so we know when it was last updated to prevent old estimates replacing newer ones.

Your own bss_public is not updated by registering for this service. You will likely have a bss_public even if you never sign up to FFScouter, as this data is generated by the estimates of other users. You may view your own stat estimates when using FFScouter by requesting it for your own ID.

API Key (Must be a current FFScouter API key)

I understand this action is irreversible and I will need to sign up again to use FFScouter in the future.

Remove My Data