Datasets API endpoint
Returns terms aggregation counts for the PlayStation games dataset. Facet enum: `publisher`, `classification`, `genres`, `platforms`, `content_rating_authority`, `content_descriptors`, `price_tier`, `service_branding`, `region`, `release_year`, `run_id`, `is_free`, `is_addon`, `is_tied_to_subscription`, `coming_soon`. price_tier enum: `free`, `under_5`, `5_to_10`, `10_to_20`, `20_to_40`, `40_to_60`, `60_plus`.
/datasets/playstation-games/facetsReturns terms-aggregation counts for one field over the PlayStation games dataset, honoring the same filters as search.
Query parameters:
facet (required) — one of publisher, classification, genres, platforms, content_rating_authority, content_descriptors, price_tier, service_branding, region, release_year, run_id, is_free, is_addon, is_tied_to_subscription, coming_soon.q, publisher, genre, platform, classification, content_rating, price_tier, branding, region, concept_id, np_title_id, run_id, is_free, is_addon, coming_soon, on_sale, min_price_value, max_price_value, min_star_rating, min_star_count, min_discount_pct, min_release_year, max_release_year) apply. price_tier enum: free, under_5, 5_to_10, 10_to_20, 20_to_40, 40_to_60, 60_plus.Returns {dataset, facet, items:[{value, count}]} (top 50 buckets).
| Field | Filled in, of 47 checked | Values in the sample |
|---|---|---|
| value | 47 | |
| count | 47 | 3 to 24,716, median 1,177 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| facet | string | Yes | Facet enum: publisher, classification, genres, platforms, content_rating_authority, content_descriptors, price_tier, service_branding, region, release_year, run_id, is_free, is_addon, is_tied_to_subscription, coming_soon Allowed values: publisher, classification, genres, platforms, content_rating_authority, content_descriptors, price_tier, service_branding, region, release_year, run_id, is_free, is_addon, is_tied_to_subscription, coming_soon. | publisher | |
| q | string | No | Full-text query over name and publisher, max 256 characters | ||
| publisher | string | No | Exact publisher filter, max 128 characters | ||
| classification | string | No | Exact classification filter, max 128 characters | ||
| genre | string | No | Exact genre filter, max 128 characters | ||
| platform | string | No | Exact platform filter: PS4 or PS5 | ||
| content_rating | string | No | Exact content-rating authority filter, max 128 characters | ||
| content_descriptor | string | No | Exact content-descriptor filter, max 128 characters | ||
| price_tier | string | No | Price-tier enum: free, under_5, 5_to_10, 10_to_20, 20_to_40, 40_to_60, 60_plus Allowed values: free, under_5, 5_to_10, 10_to_20, 20_to_40, 40_to_60, 60_plus. | ||
| branding | string | No | Exact subscription/service-branding filter, max 128 characters | ||
| region | string | No | Exact store region (country code) filter, max 128 characters | ||
| concept_id | string | No | Exact concept id filter, max 128 characters | ||
| np_title_id | string | No | Exact np_title_id filter, max 128 characters | ||
| run_id | string | No | Exact crawl run-id filter, max 128 characters | ||
| is_free | boolean | No | Filter by free flag | ||
| is_addon | boolean | No | Filter add-ons vs games | ||
| is_tied_to_subscription | boolean | No | Filter subscription-included titles | ||
| coming_soon | boolean | No | Filter for pre-release titles | ||
| on_sale | boolean | No | Filter by titles currently discounted (discount_pct > 0) | ||
| min_price_value | integer | No | Minimum current price in minor units | ||
| max_price_value | integer | No | Maximum current price in minor units | ||
| min_star_rating | number | No | Minimum average star rating, 0 through 5 | ||
| min_star_count | integer | No | Minimum number of star ratings | ||
| min_discount_pct | integer | No | Minimum discount percent, 0 through 100 | ||
| min_release_year | integer | No | Minimum release year | ||
| max_release_year | integer | No | Maximum release year | ||
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/datasets/playstation-games/facets?facet=publisher&q=coffee&price_tier=free&is_free=true&is_addon=true&is_tied_to_subscription=true&coming_soon=true&on_sale=true" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"dataset": "playstation-games",
"facet": "genres",
"items": [
{
"value": "Action",
"count": 6005
},
{
"value": "Adventure",
"count": 2354
}
]
}
}Request schema
No body schema
Response schema
#/definitions/datasets.playstationGamesFacetResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | datasets.PlaystationFacetResponse | No | ||||
| data.dataset | string | No | ||||
| data.facet | string | No | ||||
| data.items | array | No | ||||
| data.items[].count | integer | No | ||||
| data.items[].value | string | No | ||||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 500 | Internal Server Error | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/datasets/playstation-games/facets?facet=publisher&q=coffee&price_tier=free&is_free=true&is_addon=true&is_tied_to_subscription=true&coming_soon=true&on_sale=true" \
-H "x-api-key: $CRAWLORA_API_KEY"