Help & Documentation

What are these tools?

This is a collection of web-based tools designed to help Torn City players access and analyze game data more efficiently.

All tools work directly in your browser and communicate with the official Torn API to fetch real-time information.

Features include player tracking, target list management, bounty browsing, and faction monitoring.

Getting Started

To use these tools, you'll need a Torn API key. This is a unique identifier that allows the tools to access your Torn City data.

How to get your API key:

1. Go to Torn Preferences → API
2. Click on "Create New Key"
3. Select "Limited Access" as the key type (required for full functionality)
4. Give it a name (e.g., "Torn Tools")
5. Copy the generated API key
6. Return to the home page and paste it in the API Key Configuration section
7. Click "Save Key"

Note: Some tools work with "Public Only" keys, but to use all available tools you'll need a "Limited Access" key.

Using the Tools

Once your API key is configured, you can access any of the available tools from the home page.

Most tools feature:

• Sortable tables - Click on column headers to sort data
• Real-time data - Information is fetched directly from Torn's servers
• Auto-refresh - Some tools automatically update every 30 seconds
• Filtering options - Customize what data you see

Security & Privacy

Your data is safe:

• Your API key is stored only in your browser's local storage
• No data is sent to any third-party servers
• All communication is directly between your browser and Torn's official API
• The tools are open-source and transparent - you can inspect the code

How to verify the security yourself:

• Check local storage: Press F12 → Application tab → Local Storage → Select the site → You'll see your "tornApiKey" stored locally
• Inspect network traffic: Press F12 → Network tab → Load a tool → You'll see all requests go only to "api.torn.com"
• Review the code: Press F12 → Sources tab → Browse the .js files → All code is readable and unobfuscated

Best practices:

• Use "Limited Access" API keys for full functionality
• Never share your API key with anyone
• Don't use these tools on public or shared computers
• You can clear your API key at any time from the home page
• Regularly review your active API keys in Torn preferences

Troubleshooting

Data not loading?

• Check that you've configured your API key on the home page
• Verify your API key is still valid in Torn preferences
• Check your browser console (F12) for error messages
• Try refreshing the page

API errors?

• Make sure your API key has the necessary permissions
• You may be rate-limited - wait a minute and try again
• Check if Torn's API is experiencing issues