Profile

👤 Retrieve a Steam User's Profile with Flexible Options

Baseurl: https://www.steamwebapi.com/steam/api/profile?id=760000022222&key=YOUR_API_KEY

💬 **What this endpoint does:**
- Fetches a Steam user profile with flexible options.
- Supports full or minimal data retrieval based on your needs.

🛠️ **Features:**
- Use the `id` parameter to identify the profile. Supports SteamID, username, or profile URL (SteamID recommended for faster and more accurate results).
- Retrieve real-time data by setting `no_cache` to `1` (slower response).
- Adjust the data depth using the `state` parameter (`minimal` or `full`).
- Optimize responses with the `force_from_db_if_exists` parameter to fetch profiles from the database if available.

🌐 **How to use:**
- Provide a valid `id` parameter (SteamID, profile URL, or username).
- Use optional parameters to customize data retrieval (e.g., `state=full` for additional profile details).
get/steam/api/profile

Request

  • Base URL: https://www.steamwebapi.com
  • URL: https://www.steamwebapi.com/steam/api/profile
  • Auth: API key in query parameter key

Query parameters

Your API key for authentication. Retrieve it from your Dashboard (top-right corner).

Required. Identifier for the profile. Accepts: - SteamID (recommended for speed and accuracy). - Profile URL. - Username.

Optional. Set to 1 to bypass the cache and fetch data directly from Steam. - Default: Cached data (faster).

Optional. Defines the level of profile detail: - minimal (default): Basic profile data. - full: Includes additional details like level, trade ban info, and friend states (slower).

Optional. Set to 1 to retrieve the profile from the database if available. - If not found, fresh data will be fetched and cached automatically. - Useful for rapid responses without impacting rate limits.

Optional. Set to 1 to include the profile's Steam group memberships in the response. - Default: 0 (groups omitted to keep responses small). - When enabled, a groups array is returned (group id, name, url, primary flag, avatars, member counts).

If you run in production, please set this to 1. Default is 0. This is in future required, and if not set, you will get a warning.

formatstring

Response format: json (default), csv, xml, html, gzip, zip, ndjson, mysql, mysql_with_table, pgsql, pgsql_with_table, mongo. Example: ?format=csv

pretty'0' | '1'

Pretty-print JSON (set to 1 for json/gzip/zip formats). Example: ?format=json&pretty=1

Response

Profile retrieved successfully.

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.