# Steam

> Look up Steam player profiles, resolve vanity URLs to Steam IDs, and list the games people own, have played recently, and their friends.

App · Gaming · 5 actions. Web page: https://docs.lodol.com/docs/integrations/steam

## Actions

### Get friend list

List a Steam user's friends. The target profile's friends list must be public.

**Inputs**

- Steam ID (`steam_id`, text, required): The Steam ID of the user whose friends you want to list.
- Relationship (`relationship`, text): Which relationships to include: 'all' (the default) or 'friend'. One of: `all` (All relationships), `friend` (Friends only). Default: `all`.

**Outputs**

- `friends` (list): The user's friends.

**Example output**

```json
{
  "friends": [
    {
      "friend_since": 1512803400,
      "relationship": "friend",
      "steamid": "76561198000000001"
    }
  ]
}
```

### Get owned games

List the games a Steam user owns.

**Inputs**

- Steam ID (`steam_id`, text, required): The Steam ID of the user whose games you want to list.
- Include game details (`include_appinfo`, true/false): Set to true to include each game's name and images. Default: `true`.

**Outputs**

- `games` (list): Owned games.

**Example output**

```json
{
  "games": [
    {
      "appid": 570,
      "name": "Dota 2",
      "playtime_forever": 120
    }
  ]
}
```

### Get player profiles

Look up Steam player profiles by Steam ID.

**Inputs**

- Steam IDs (`steam_ids`, list, required): The Steam IDs of the players to look up.

**Outputs**

- `players` (list): Player profiles.

**Example output**

```json
{
  "players": [
    {
      "personaname": "PlayerOne",
      "profileurl": "https://steamcommunity.com/id/playerone/",
      "steamid": "76561198000000000"
    }
  ]
}
```

### Get recently played games

List the games a Steam user has played in the last two weeks.

**Inputs**

- Steam ID (`steam_id`, text, required): The Steam ID of the user whose recent games you want.
- Count (`count`, number): Maximum number of games to return (default: all). At least 1.

**Outputs**

- `games` (list): Games played in the last two weeks.

**Example output**

```json
{
  "games": [
    {
      "appid": 730,
      "name": "Counter-Strike 2",
      "playtime_2weeks_hours": 5.5,
      "playtime_hours": 320.0
    }
  ]
}
```

### Resolve vanity URL

Convert a Steam custom (vanity) profile name into its 64-bit Steam ID, which the other actions require.

**Inputs**

- Vanity URL or name (`vanity_url`, text, required): The custom name from a profile's web address, for example 'gabelogannewell' in steamcommunity.com/id/gabelogannewell. A full profile URL is also accepted.
- URL type (`url_type`, number): What the name refers to: 1 for an individual profile (the default), 2 for a group, or 3 for an official game group. From 1 to 3. Default: `1`.

**Outputs**

- `steamid` (text): The resolved 64-bit Steam ID.
- `vanity_url` (text): The vanity name that was resolved.

**Example output**

```json
{
  "steamid": "76561197960287930",
  "vanity_url": "gabelogannewell"
}
```
