Torn API

https://www.torn.com/api/
Admin
The official API for the Torn online game, providing programmatic access to game data and features.
Tokens:2,227
Snippets:30
Trust Score:9.3
Update:2 months ago
Show doc for...
Tokens:
Raw
### GET https://api.torn.com/key/

Source: https://www.torn.com/api.html

Validates an API key and checks its permissions.

```APIDOC
## GET https://api.torn.com/key/

### Description
Checks the permissions and status of a specific API key.

### Method
GET

### Endpoint
https://api.torn.com/key/

### Parameters
#### Query Parameters
- **selections** (string) - Required - Set to 'info' to retrieve key information.
- **key** (string) - Required - The API key to validate.
```

--------------------------------

### GET https://api.torn.com/market/:ID

Source: https://www.torn.com/api.html

Retrieves market data for a specific item ID.

```APIDOC
## GET https://api.torn.com/market/:ID

### Description
Retrieves market information for a specific item.

### Method
GET

### Endpoint
https://api.torn.com/market/:ID?selections=:SELECTIONS&key=:KEY

### Parameters
#### Path Parameters
- **ID** (string) - Required - The item ID.

#### Query Parameters
- **selections** (string) - Required - Comma separated list of data fields to retrieve.
- **key** (string) - Required - Your API key.
```

--------------------------------

### GET https://api.torn.com/faction/:ID

Source: https://www.torn.com/api.html

Retrieves faction data based on the provided faction ID and selections.

```APIDOC
## GET https://api.torn.com/faction/:ID

### Description
Retrieves information about a specific faction. If no ID is provided, it returns data for the owner's faction.

### Method
GET

### Endpoint
https://api.torn.com/faction/:ID?selections=:SELECTIONS&key=:KEY

### Parameters
#### Path Parameters
- **ID** (string) - Optional - The faction ID. Not required when requesting the key's owner data.

#### Query Parameters
- **selections** (string) - Required - Comma separated list of data fields to retrieve.
- **key** (string) - Required - Your API key.
- **stat** (string) - Optional - Required for 'contributors' selection (e.g., &stat=busts).
- **from** (integer) - Optional - UNIX timestamp to filter selections.
- **to** (integer) - Optional - UNIX timestamp to filter selections.
```

--------------------------------

### GET https://api.torn.com/user/:ID

Source: https://www.torn.com/api.html

Retrieves user data based on the provided user ID and selections.

```APIDOC
## GET https://api.torn.com/user/:ID

### Description
Retrieves information about a specific user. If no ID is provided, it returns data for the owner of the API key.

### Method
GET

### Endpoint
https://api.torn.com/user/:ID?selections=:SELECTIONS&key=:KEY

### Parameters
#### Path Parameters
- **ID** (string) - Optional - The user ID. Not required when requesting the key's owner data.

#### Query Parameters
- **selections** (string) - Required - Comma separated list of data fields to retrieve.
- **key** (string) - Required - Your API key.
- **from** (integer) - Optional - UNIX timestamp to filter selections.
- **to** (integer) - Optional - UNIX timestamp to filter selections.
```

--------------------------------

### GET https://api.torn.com/property/:ID

Source: https://www.torn.com/api.html

Retrieves property data based on the provided property ID and selections.

```APIDOC
## GET https://api.torn.com/property/:ID

### Description
Retrieves information about a specific property.

### Method
GET

### Endpoint
https://api.torn.com/property/:ID?selections=:SELECTIONS&key=:KEY

### Parameters
#### Path Parameters
- **ID** (string) - Required - The property ID.

#### Query Parameters
- **selections** (string) - Required - Comma separated list of data fields to retrieve.
- **key** (string) - Required - Your API key.
```

--------------------------------

### GET https://api.torn.com/torn/:ID

Source: https://www.torn.com/api.html

Retrieves general data from the Torn API based on the provided ID and selections.

```APIDOC
## GET https://api.torn.com/torn/:ID

### Description
Retrieves general game data from the Torn API. Accepts comma-separated selections to filter the returned fields.

### Method
GET

### Endpoint
https://api.torn.com/torn/:ID

### Parameters
#### Path Parameters
- **ID** (string) - Required - The specific ID for the data requested.

#### Query Parameters
- **selections** (string) - Optional - Comma separated list of data fields to retrieve.
- **key** (string) - Required - Your API key for authentication.
```

--------------------------------

### GET https://api.torn.com/company/:ID

Source: https://www.torn.com/api.html

Retrieves company data based on the provided company ID and selections.

```APIDOC
## GET https://api.torn.com/company/:ID

### Description
Retrieves information about a specific company. If no ID is provided, it returns data for the owner's company.

### Method
GET

### Endpoint
https://api.torn.com/company/:ID?selections=:SELECTIONS&key=:KEY

### Parameters
#### Path Parameters
- **ID** (string) - Optional - The company ID. Not required when requesting the key's owner data.

#### Query Parameters
- **selections** (string) - Required - Comma separated list of data fields to retrieve.
- **key** (string) - Required - Your API key.
```

--------------------------------

### Check API Key Permissions

Source: https://www.torn.com/api.html

Endpoint to verify the permissions associated with a specific API key.

```text
https://api.torn.com/key/?selections=info&key=YOUR_KEY_HERE
```

--------------------------------

### Property API Endpoint

Source: https://www.torn.com/api.html

Base URL for accessing property-related data.

```text
https://api.torn.com/property/
```

--------------------------------

### Faction API Endpoint

Source: https://www.torn.com/api.html

Base URL for accessing faction-related data.

```text
https://api.torn.com/faction/
```

--------------------------------

### User API Endpoint

Source: https://www.torn.com/api.html

Base URL for accessing user-related data.

```text
https://api.torn.com/user/
```

--------------------------------

### Market API Endpoint

Source: https://www.torn.com/api.html

Base URL for accessing market-related data.

```text
https://api.torn.com/market/
```

--------------------------------

### Company API Endpoint

Source: https://www.torn.com/api.html

Base URL for accessing company-related data.

```text
https://api.torn.com/company/
```

--------------------------------

### Torn API Base URL

Source: https://www.torn.com/api.html

The base endpoint for accessing general Torn data.

```text
https://api.torn.com/torn/
```
Tokens:
Raw