--- title: "Search PlayStation games dataset" method: GET path: "/datasets/playstation-games/search" tags: ["Datasets"] --- # Search PlayStation games dataset `GET /datasets/playstation-games/search` ## Request - Base URL: `https://api.crawlora.net/api/v1` - URL: `https://api.crawlora.net/api/v1/datasets/playstation-games/search` - Auth: API key in header `x-api-key` Searches the crawled public PlayStation Store catalog stored in a search index. One row per product SKU (game, edition or add-on); concept_id / np_title_id group a title's SKUs. price_tier enum: `free`, `under_5`, `5_to_10`, `10_to_20`, `20_to_40`, `40_to_60`, `60_plus`. Sort enum: `relevance`, `rating_desc`, `reviews_desc`, `price_asc`, `price_desc`, `discount_desc`, `release_desc`, `release_asc`. Billing: this search costs 1 credit per record returned, with a minimum of 2 (an empty result costs 2, a full page of 100 costs 100). ## Query parameters - `q` string - `publisher` string - `classification` string - `genre` string - `platform` string - `content_rating` string - `content_descriptor` string - `price_tier` 'free' | 'under_5' | '5_to_10' | '10_to_20' | '20_to_40' | '40_to_60' | '60_plus' - `branding` string - `region` string - `concept_id` string - `np_title_id` string - `run_id` string - `is_free` boolean - `is_addon` boolean - `is_tied_to_subscription` boolean - `coming_soon` boolean - `on_sale` boolean - `min_price_value` integer - `max_price_value` integer - `min_star_rating` number - `min_star_count` integer - `min_discount_pct` integer - `min_release_year` integer - `max_release_year` integer - `sort` 'relevance' | 'rating_desc' | 'reviews_desc' | 'price_asc' | 'price_desc' | 'discount_desc' | 'release_desc' | 'release_asc' - `page` integer - `page_size` integer ## Headers - `x-api-key` string, required ## Response `200` OK - DatasetsPlaystationGamesSearchResponseDoc - `code` integer - `data` DatasetsPlaystationSearchResponse - `dataset` string - `items` EsPlaystationGameRecord[] - `addon_count` integer: Number of add-ons the game has on the PlayStation Store. - `base_price_value` integer: List price before any discount, in minor units of `currency` (for example cents). - `classification` string: Classification is the storeDisplayClassification (FULL_GAME, PREMIUM_EDITION, GAME_BUNDLE, ADD_ON_PACK, VIRTUAL_CURRENCY, LEVEL, OTHER, ...). - `coming_soon` boolean: Whether the product is not yet purchasable and is listed as coming soon. - `concept_id` string: PlayStation Store id shared by all editions and add-ons of the same title. - `content_descriptors` string[]: Content notices shown with the rating, for example `Blood` or `In-Game Purchases`. - `content_rating_authority` string: Organization that issued the age rating, for example `ESRB`. - `content_rating_desc` string: Description text of the age rating. - `content_rating_name` string: Name of the age rating. - `crawled_at` string: Time the product's data was fetched, in UTC (RFC 3339). - `currency` string: ISO currency code that the prices are in. - `description` string: Product description from the PlayStation Store. - `discount_end_time` string: Time the current discount ends, as the PlayStation Store reports it. - `discount_pct` integer: Discount off the list price, as a percentage from 0 to 100. - `discount_text` string: Discount label shown on the PlayStation Store. - `discounted_value` integer: Current price after any discount, in minor units of `currency` (for example cents). - `edition_count` integer: Number of editions the title has on the PlayStation Store. - `genres` string[]: List of genres the PlayStation Store shows for the title. - `header_image` string: URL of the header image shown on the store page. - `is_addon` boolean: Whether the product is an add-on such as DLC or in-game currency, rather than a game or edition. - `is_free` boolean: Whether the product is free. - `is_tied_to_subscription` boolean: Whether the product is included with a subscription such as PlayStation Plus. - `name` string: Product name as shown on the PlayStation Store. - `np_title_id` string: PlayStation title id shared by all SKUs of the same title. - `platforms` string[]: Consoles the product runs on, for example `PS4` or `PS5`. - `price_tier` string: Price band of the current price: `free`, `under_5`, `5_to_10`, `10_to_20`, `20_to_40`, `40_to_60` or `60_plus`. - `product_id` string: PlayStation Store product id of this edition or add-on. - `publisher` string: Name of the book's publisher. - `quality_checked_at` string: Time the record was last repaired, in UTC (RFC 3339). Present only for repaired records. - `quality_reason` string: Outcome of the last completeness check on the record. - `quality_state` string: Quality* records the terminal/backfill state without changing the last known crawl snapshot. It is populated only for the targeted repair flow. - `region` string: Region is the store country code the record was crawled from (selects currency). - `release_date` string: Release date as the PlayStation Store reports it. - `release_year` integer: Year the title was released. - `run_id` string: Identifier of the collection run that produced this record. Accepted as a `run_id` filter. - `schema_version` integer: Version of the record layout. - `seed_rank` integer: Discovery priority of the title; lower values mean it was found earlier. - `service_branding` string[]: Subscription service labels shown on the product. - `source_url` string: URL the data was read from. - `star_rating_avg` number: Average user star rating of the title. - `star_rating_count` integer: Number of user ratings behind the star rating. - `page` integer - `page_size` integer - `sort` string - `total` integer - `msg` string ## Other responses - `400`: Bad Request - `429`: Too Many Requests - `500`: Internal Server Error --- [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/afac9b012a27?raw)