PlayStation API endpoint
Returns typeahead-style PlayStation Store search suggestions for a partial or full term: id, name, classification, platforms, publisher, release date, price, a representative image, and a direct store URL per match. Matching is upstream-ordered and loose (it may include titles that only loosely relate to the term), not a ranked exact-substring search. limit caps how many suggestions are returned (max 20; the upstream API does not honor a higher value). 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/suggestQuery parameters:
term (required) — search term, partial or full (e.g. god of war).limit (optional, default 5) — maximum number of suggestions to return. The upstream API caps at 20 regardless of a higher requested value.cc (optional, default us) — two-letter store country code (ISO); selects the store region and price currency. Malformed values return 400.l (optional, default en) — language code such as en or ja; locale-shaped values such as en-US are normalized to en.Matching is upstream-ordered and loose — suggestions may include titles that only loosely relate to the term (e.g. a franchise tie-in or an unrelated title sharing a word), not a ranked exact-substring search. A term with no matches returns 200 with an empty items[] and total: 0.
Returns term, cc, l, total (the upstream's total match count across all pages, not just the returned page), items[] (id, name, short_name, classification, platforms[], publisher, release_date, price (display, value — the upstream does not expose a separate currency code here; display already carries the region's currency symbol/format), image (type, role, url), store_url), and source_url.
| Field | Filled in, of 20 checked | Values in the sample |
|---|---|---|
| id | 20 | |
| name | 20 | “God of War” and 18 other values |
| short_name | 20 | “God of War” and 17 other values |
| classification | 19 | FULL_GAME (15), GAME_BUNDLE (2), PREMIUM_EDITION (2) |
| platforms | 20 | median 1 entry |
| publisher | 20 | Sony Interactive Entertainment in all 20 |
| release_date | 18 | 2010-11-02 to 2026-02-12 |
| price | 18 | |
| image | 20 | |
| store_url | 20 | store.playstation.com |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| term | string | Yes | Search term (partial or full) | god of war | |
| limit | integer | No | Maximum number of suggestions to return (max 20) | ||
| 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/suggest?term=god+of+war&limit=10" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"term": "god of war",
"cc": "us",
"l": "en",
"total": 160,
"items": [
{
"id": "UP9000-CUSA07408_00-00000000GODOFWAR",
"name": "God of War",
"short_name": "God of War",
"classification": "FULL_GAME",
"platforms": [
"PS4"
],
"publisher": "Sony Interactive Entertainment",
"release_date": "2018-04-20T00:00:00Z",
"price": {
"display": "$19.99",
"value": 1999
},
"image": {
"type": "10",
"url": "https://vulcan.dl.playstation.net/img/rnd/202011/1021/X3WIAh63yKhRRiMohLoJMeQu.png"
},
"store_url": "https://store.playstation.com/en-us/product/UP9000-CUSA07408_00-00000000GODOFWAR"
}
],
"source_url": "https://store.playstation.com/store/api/chihiro/00_09_000/tumbler/US/en/99/god%20of%20war?size=5&suggested_size=5&mode=game"
}
}Request schema
No body schema
Response schema
#/definitions/playstation.suggestResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | playstation.SuggestResponse | No | ||||
| data.cc | string | No | ||||
| data.items | array | No | ||||
| data.items[].classification | string | No | ||||
| data.items[].id | string | No | ||||
| data.items[].image | playstation.Media | No | ||||
| data.items[].image.role | string | No | Role of the asset on the store page, as the store labels it. | |||
| data.items[].image.type | string | No | Kind of asset, such as an image or a video. | |||
| data.items[].image.url | string | No | URL of the image or video. | |||
| data.items[].name | string | No | ||||
| data.items[].platforms | array | No | ||||
| data.items[].price | playstation.SuggestPrice | No | ||||
| data.items[].price.display | string | No | ||||
| data.items[].price.value | integer | No | ||||
| data.items[].publisher | string | No | ||||
| data.items[].release_date | string | No | ||||
| data.items[].short_name | string | No | ||||
| data.items[].store_url | string | No | ||||
| data.l | string | No | ||||
| data.source_url | string | No | ||||
| data.term | string | No | ||||
| data.total | integer | No | ||||
| 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/suggest?term=god+of+war&limit=10" \
-H "x-api-key: $CRAWLORA_API_KEY"