PlayStation API endpoint
Returns a page of PlayStation Store search results (concepts and products) for a term, with pagination and per-item price, platforms, classification, and media. Pass page to advance; next_page is set when more results exist. cc selects the store region (and price currency); l accepts a language code or locale such as en or en-US, with the locale's primary language used for text.
/playstation/searchQuery parameters:
term (required) — the search term (e.g. god of war).page (optional, default 1) — 1-based page number.page_size (optional, default 24, max 48) — results per page.cc (optional, default us) — store country code (ISO); selects the store region and price currency.l (optional, default en) — language code such as en or ja. Locale-shaped values such as en-US are accepted and normalized to en.Returns term, page_info (total_count, offset, size, is_last), next_page (present when more results exist), count, items[] (each: kind — concept or product, id, name, np_title_id, classification, platforms[], price (base_price, discounted_price, discount_text, is_free, service_branding[], upsell_text, …), media[]), and source_url.
| Field | Filled in, of 20 checked | Values in the sample |
|---|---|---|
| kind | 20 | product in all 20 |
| id | 20 | |
| name | 20 | “God of War” and 18 other values |
| np_title_id | 20 | |
| classification | 20 | FULL_GAME (9), LEVEL (3), PREMIUM_EDITION (3) and 3 more |
| platforms | 20 | median 1 entry |
| price | 20 | |
| media | 20 | median 14 entries |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| term | string | Yes | Search term | god of war | |
| page | integer | No | 1-based page number | ||
| page_size | integer | No | Results per page (max 48) | ||
| cc | string | No | Store country code (ISO, selects currency) | ||
| l | string | No | Language code | ||
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/playstation/search?term=god+of+war&page=1" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"term": "god of war",
"page_info": {
"total_count": 40,
"offset": 0,
"size": 24,
"is_last": false
},
"next_page": 2,
"count": 24,
"items": [
{
"kind": "product",
"id": "UP9000-CUSA07408_00-00000000GODOFWAR",
"name": "God of War",
"np_title_id": "CUSA07408_00",
"classification": "FULL_GAME",
"platforms": [
"PS4"
],
"price": {
"base_price": "$19.99",
"discounted_price": "$9.99",
"discount_text": "-50%",
"is_free": false
}
}
],
"source_url": "https://store.playstation.com/en-us/search/god%20of%20war"
}
}Request schema
No body schema
Response schema
#/definitions/playstation.searchResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | playstation.SearchResponse | No | ||||
| data.count | integer | No | Number of items returned on this page. | |||
| data.items | array | No | Search results on this page. | |||
| data.items[].classification | string | No | Store classification of the item, for example `FULL_GAME`. | |||
| data.items[].id | string | No | PlayStation Store id of the item. Use it with the concept endpoint when `kind` is `concept`, or with the product endpoint when it is `product`. | |||
| data.items[].kind | string | No | Type of store entry: `concept` or `product`. | |||
| data.items[].media | array | No | Images and videos for the item. | |||
| data.items[].media[].role | string | No | Role of the asset on the store page, as the store labels it. | |||
| data.items[].media[].type | string | No | Kind of asset, such as an image or a video. | |||
| data.items[].media[].url | string | No | URL of the image or video. | |||
| data.items[].name | string | No | Item name as shown on the PlayStation Store. | |||
| data.items[].np_title_id | string | No | PlayStation title id of the item, for example `CUSA07408_00`. | |||
| data.items[].platforms | array | No | PlayStation platforms the item is available on. | |||
| data.items[].price | object | No | Price of the item. | |||
| data.items[].price.base_price | string | No | Regular price as a formatted string, for example `$19.99`. | |||
| data.items[].price.discount_text | string | No | Discount label shown on the store, for example `-50%`. | |||
| data.items[].price.discounted_price | string | No | Current price after discount as a formatted string. | |||
| data.items[].price.is_exclusive | boolean | No | Whether the store marks the price as exclusive to a membership. | |||
| data.items[].price.is_free | boolean | No | Whether the item is free. | |||
| data.items[].price.is_tied_to_subscription | boolean | No | Whether the store marks the price as tied to a subscription. | |||
| data.items[].price.service_branding | array | No | Names of the PlayStation services the price is tied to. | |||
| data.items[].price.upsell_service_branding | array | No | Names of the PlayStation services the upsell offer refers to. | |||
| data.items[].price.upsell_text | string | No | Promotional text the store shows next to the price. | |||
| data.next_page | integer | No | Number of the next page. Omitted on the last page. | |||
| data.page_info | object | No | Pagination details of the results. | |||
| data.page_info.is_last | boolean | No | Whether this is the last page of results. | |||
| data.page_info.offset | integer | No | Position of the first item on this page within all results. | |||
| data.page_info.size | integer | No | Number of items per page. | |||
| data.page_info.total_count | integer | No | Total number of results across all pages. | |||
| data.source_url | string | No | PlayStation Store page the data was read from. | |||
| data.term | string | No | Search term that was run. | |||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/playstation/search?term=god+of+war&page=1" \
-H "x-api-key: $CRAWLORA_API_KEY"