---
title: "Search the Steam store by title"
method: GET
path: "/steam/search"
tags: ["Steam"]
---

# Search the Steam store by title

`GET /steam/search`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/steam/search`
- Auth: API key in header `x-api-key`

Resolves a search term to Steam apps via the store typeahead (title, appid, price, platforms, metascore). Best for title -> appid lookup; returns roughly ten results. For faceted, paginated search use /steam/search/results.

## Query parameters

- `term` string, required
- `cc` string
- `l` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- SteamSearchResponseDoc
  - `code` integer
  - `data` SteamSearchResponse
    - `count` integer: Number of results returned.
    - `items` SteamSearchItem[]: Store items matching the search term.
      - `controller_support` string: Level of controller support Steam lists for the item.
      - `id` integer: Steam id of the result. Use it with the app endpoint when `type` is `app`.
      - `metascore` string: Metacritic score of the item, returned as a string such as `90`.
      - `name` string: Name of the item on the Steam store.
      - `platforms` SteamPlatforms
        - `linux` boolean: Whether the title supports Linux.
        - `mac` boolean: Whether the title supports macOS.
        - `windows` boolean: Whether the title supports Windows.
      - `price` SteamPrice
        - `currency` string: Currency code of the prices, such as `USD`.
        - `discount_percent` integer: Discount currently applied, as a percentage.
        - `final` integer: Price after any discount, in minor currency units such as cents.
        - `final_formatted` string: Price after any discount, formatted for display as Steam shows it.
        - `initial` integer: Price before any discount, in minor currency units such as cents.
        - `initial_formatted` string: Price before any discount, formatted for display as Steam shows it.
      - `streamingvideo` boolean: Whether Steam marks the item as streaming video.
      - `tiny_image` string: URL of a small image of the item.
      - `type` string: Kind of result, such as `app`.
    - `source_url` string: URL the data was read from.
    - `term` string: Search term that was used.
    - `total` integer: Total number of matches Steam reports for the term.
  - `msg` string

## Other responses

- `400`: Bad Request
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/0497899e2016?raw)