# DataPremiery.pl

> Polish release-date database: upcoming and past premieres of movies, TV series, games, music albums, books, consumer electronics and events, with Polish and international release dates. Content language: Polish. Updated daily.

Use the sitemap or the RSS feeds to discover pages instead of crawling links. Pages with `=` or `?` in the URL (pagination, sorting, filters, internal search) are not meant for agents and are disallowed in robots.txt. Please keep to at most one request every few seconds; anonymous page views are cached for 5 to 30 minutes, so re-fetching sooner returns the same data.

## Site structure

- [Movies and TV series](https://datapremiery.pl/filmy/): upcoming premieres in category "filmy"; [recent premieres](https://datapremiery.pl/filmy/premiery/)
- [Games](https://datapremiery.pl/gry/): upcoming premieres in category "gry"; [recent premieres](https://datapremiery.pl/gry/premiery/)
- [Music](https://datapremiery.pl/muzyka/): upcoming premieres in category "muzyka"; [recent premieres](https://datapremiery.pl/muzyka/premiery/)
- [Books](https://datapremiery.pl/ksiazki/): upcoming premieres in category "ksiazki"; [recent premieres](https://datapremiery.pl/ksiazki/premiery/)
- [Hardware](https://datapremiery.pl/elektronika/): upcoming premieres in category "elektronika"; [recent premieres](https://datapremiery.pl/elektronika/premiery/)
- [Other and events](https://datapremiery.pl/pozostale/): concerts, shows, sports and other dated events; [recent](https://datapremiery.pl/pozostale/premiery/)
- [News](https://datapremiery.pl/newsy/): editorial news about premieres
- [Ranking](https://datapremiery.pl/ranking/): most anticipated premieres

A premiere page has the form `https://datapremiery.pl/{slug}-premiera-{type}-{id}/`, for example `https://datapremiery.pl/avatar-4-premiera-filmu-5563/`. Type words: filmu, serialu, gry, plyty, ksiazki, urzadzenia, wydarzenia and others. The page contains the title, Polish and world release dates, platforms or formats, creators, description, cover and trailer links.

## Machine-readable access

- [Sitemap index](https://datapremiery.pl/ext/sitemap/sitemap.xml): every premiere, news and review URL with last-modified dates; fetch this once a day instead of crawling
- [RSS: all upcoming premieres](https://datapremiery.pl/ext/rss/rss.php): newest dated premieres across all categories
- [RSS per category](https://datapremiery.pl/ext/rss/rss.php?c=2): parameter `c` is the category number (1 movies, 2 games, 3 music, 4 books, 5 hardware, 6 other); optional `t` narrows to a type id
- [JSON API documentation](https://datapremiery.pl/api/doc): key-based read API with `getlist/{category}`, `updatelist/{category}` (changes since last call), `get/dp-{category}-{id}` and `search`; keys are issued on request via the contact page

## Policies

- [robots.txt](https://datapremiery.pl/robots.txt): training crawlers for AI models are not allowed; search and user-triggered fetchers may read content pages
- [Terms of use](https://datapremiery.pl/regulamin): data may be quoted with attribution and a link to the source page
- [Contact](https://datapremiery.pl/kontakt): API keys, bulk data requests, corrections

## Optional

- [About](https://datapremiery.pl/onas): project history and editorial team
- [Help](https://datapremiery.pl/pomoc): how dates, regions and statuses are defined
- [Press](https://datapremiery.pl/media/): press materials and logos