HollyHQ API Документация

Сайта разполага с API за интеграция с други сайтове и приложения. Взимането на текста от публикация е ограничено до първите няколко изречения и е неформатирано.

POST метод

Всички адреси по-долу очакват POST заявка.

https://hollyhq.info/api/tvshow https://hollyhq.info/api/tvshow/news
Сериали

За информация за сериал, направете заявка към:

https://hollyhq.info/api/tvshow

Трябва да предоставите един от следните параметри:

Параметър Описание
id Уникално id за всеки сериал. Използва се в URL адреса.
imdb IMDB.com код на сериала.
original_title Оригиналното име на сериала на английски.
title Българско име на сериала
name Смесено. Ще потърси най-близкия сериал по всички параметри.

При следната заявка:

https://hollyhq.info/api/tvshow?name=Gossip Girl

Ще получите:

    {
        "data": {
        "id": "Gossip-Girl",
        "url": "https://hollyhq.info/tv-shows/Gossip-Girl",
        "img_url":
        "https://m.media-amazon.com/images/M/MV5BYTdjN2JkMGM[email protected]@._V1_QL75_UX190_CR0,0,190,281_.jpg",
        "title": "Клюкарката",
        "full_title": "Клюкарката (Gossip Girl)",
        "bg_title": "Клюкарката",
        "original_title": "Gossip Girl",
        "pilot": "Продължението на едноименият сериал от 2007 г. проследява ново поколение
        тийнейджъри от елита на Ню Йорк.",
        "type": "TV Series",
        "status": "Текущ",
        "status_code": 1,
        "status_descr": "Получава втори сезон.",
        "year": 2021,
        "end_year": 0,
        "imdb_code": 10653784,
        "rating": "5.3/10 от 5935 вота."
        }
    }
                                                                            
                                            

Полето status_descr може да е празно. Полето bg_title може е празно когато няма превод на заглавието. Когато няма превод на български за името, full_title и title съдържа оригиналното име.

Новини За Сериали

За да получите последните новини за даден сериал, се обърнете към този адрес:

https://hollyhq.info/api/tvshow/news

Параметрите са същите като описаните по-горе.

При следната заявка:

https://hollyhq.info/api/tvshow/news?name=Gossip Girl

Ще получите:

    {
        "data": [
            {
                "id": "Gossip-Girl-Podnoven-za-vtori-sezon-79",
                "url": "https://hollyhq.info/news/Gossip-Girl-Podnoven-za-vtori-sezon-79",
                "title": "'Gossip Girl': Подновен за втори сезон!",
                "content": " 'Клюкарката' е един от онези емблематични сериали които можеш да гледаш многократно и пак да има нещо което си пропуснал, но колкото и големи фенове да сме на класиката - всичко с времето си!",
                "img_url": "https://hollyhq.info/blublog-uploads/photos/2021/9/E1BB3zOzHpNZSsHatiIEjGDUjZlM9jp9BTIlGyhx_1.webp",
                "thumb_url": "https://hollyhq.info/blublog-uploads/photos/2021/9/E1BB3zOzHpNZSsHatiIEjGDUjZlM9jp9BTIlGyhx_2.webp",
                "author_url": "https://hollyhq.info/author/%D0%90%D0%B4%D1%80%D0%B8%D1%8F%D0%BD%D0%B0%20%D0%9A%D1%80%D1%8A%D1%81%D1%82%D0%B5%D0%B2%D0%B0",
                "author_name": "Адрияна Кръстева",
                "date_full": "2021-09-12T14:39:43.000000Z",
                "date": "12.09.2021"
            },
            {
                "id": "Koga-shte-se-zavarne-parvi-sezon-na-Gossip-Girl-9",
                "url": "https://hollyhq.info/news/Koga-shte-se-zavarne-parvi-sezon-na-Gossip-Girl-9",
                "title": "Кога ще се завърне първи сезон на 'Gossip Girl'?",
                "content": "HBO Max разкри миналата седмица, че ще получим втората половина на първи сезон на reboot-a на 'Gossip Girl' през ноември тази година!",
                "img_url": "https://hollyhq.info/blublog-uploads/photos/2021/8/uTDltIXtcr1yDIk26qAaY601u1SwKZFKoIfxCTZ5_1.jpg",
                "thumb_url": "https://hollyhq.info/blublog-uploads/photos/2021/8/uTDltIXtcr1yDIk26qAaY601u1SwKZFKoIfxCTZ5_2.jpg",
                "author_url": "https://hollyhq.info/author/%D0%92%D1%8F%D1%80%D0%B0%20%D0%A2%D1%8A%D0%BF%D1%87%D0%B5%D0%B2%D0%B0",
                "author_name": "Вяра Тъпчева",
                "date_full": "2021-08-16T06:50:58.000000Z",
                "date": "16.08.2021"
            }
        ]
    }
                                                                                                                        
        
GET метод

Всички адреси по-долу очакват заявка с GET.

https://hollyhq.info/api/latest https://hollyhq.info/api/tvshow/{show-name-here} https://hollyhq.info/api/tvshow/{show-name-here}/news
Последни Новини

За да получите последните новини се обърнете към този адрес:

https://hollyhq.info/api/latest

Ще получите:

    {
        "data": [
            {
                "id": "Gossip-Girl-Podnoven-za-vtori-sezon-79",
                "url": "https://hollyhq.info/news/Gossip-Girl-Podnoven-za-vtori-sezon-79",
                "title": "'Gossip Girl': Подновен за втори сезон!",
                "content": " 'Клюкарката' е един от онези емблематични сериали които можеш да гледаш многократно и пак да има нещо което си пропуснал, но колкото и големи фенове да сме на класиката - всичко с времето си!",
                "img_url": "https://hollyhq.info/blublog-uploads/photos/2021/9/E1BB3zOzHpNZSsHatiIEjGDUjZlM9jp9BTIlGyhx_1.webp",
                "thumb_url": "https://hollyhq.info/blublog-uploads/photos/2021/9/E1BB3zOzHpNZSsHatiIEjGDUjZlM9jp9BTIlGyhx_2.webp",
                "author_url": "https://hollyhq.info/author/%D0%90%D0%B4%D1%80%D0%B8%D1%8F%D0%BD%D0%B0%20%D0%9A%D1%80%D1%8A%D1%81%D1%82%D0%B5%D0%B2%D0%B0",
                "author_name": "Адрияна Кръстева",
                "date_full": "2021-09-12T14:39:43.000000Z",
                "date": "12.09.2021"
            },
            {
                "id": "Treti-sezon-za-Star-Trek-Picard--treylar-97",
                "url": "https://hollyhq.info/news/Treti-sezon-za-Star-Trek-Picard--treylar-97",
                "title": "Трети сезон за 'Star Trek: Picard' + трейлър!",
                "content": "'Имаме броени дни, докато нашето бъдеще се промени безвъзратно', Патрик Стюарт казва в новия трейлър на предстоящия 2-ри сезон на 'Star Trek: Picard'. Научихме, че дългоочаквания 2-ри сезон ще излезе през февруари 2022 година.",
                "img_url": "https://hollyhq.info/blublog-uploads/photos/2021/9/2qrv1YDA5S1nMjCg8M4mz28KPSI4F3SSB4n87ySt_1.jpg",
                "thumb_url": "https://hollyhq.info/blublog-uploads/photos/2021/9/2qrv1YDA5S1nMjCg8M4mz28KPSI4F3SSB4n87ySt_2.jpg",
                "author_url": "https://hollyhq.info/author/%D0%92%D1%8F%D1%80%D0%B0%20%D0%A2%D1%8A%D0%BF%D1%87%D0%B5%D0%B2%D0%B0",
                "author_name": "Вяра Тъпчева",
                "date_full": "2021-09-10T09:51:45.000000Z",
                "date": "10.09.2021"
            }
        ]
    }

                                                    

Връщат се последните 10 публикации. В примера по-горе са премахнати, за да не е излишно дълго.

Сериали

За информация за сериал, направете заявка към:

https://hollyhq.info/api/tvshow/{show-name-here}

На мястото на {show-name-here} трябва да е името на сериала. Може да използвате оригиналното име или името на български.

При следната заявка:

https://hollyhq.info/api/tvshow/Gossip Girl

Ще получите:

    {
        "data": {
        "id": "Gossip-Girl",
        "url": "https://hollyhq.info/tv-shows/Gossip-Girl",
        "img_url":
        "https://m.media-amazon.com/images/M/MV5BYTdjN2JkMGM[email protected]@._V1_QL75_UX190_CR0,0,190,281_.jpg",
        "title": "Клюкарката",
        "full_title": "Клюкарката (Gossip Girl)",
        "bg_title": "Клюкарката",
        "original_title": "Gossip Girl",
        "pilot": "Продължението на едноименият сериал от 2007 г. проследява ново поколение
        тийнейджъри от елита на Ню Йорк.",
        "type": "TV Series",
        "status": "Текущ",
        "status_code": 1,
        "status_descr": "Получава втори сезон.",
        "year": 2021,
        "end_year": 0,
        "imdb_code": 10653784,
        "rating": "5.3/10 от 5935 вота."
        }
    }
                                                                            
                                                            
Новини За Сериали

За да получите последните новини за даден сериал, се обърнете към този адрес:

https://hollyhq.info/api/tvshow/{show-name-here}/news

Където отното на мястото на {show-name-here} трябва да е името на сериала. Може да използвате оригиналното име или името на български.

При следната заявка:

https://hollyhq.info/api/tvshow/Gossip Girl/news

Ще получите:

    {
    "data": [
        {
            "id": "Gossip-Girl-Podnoven-za-vtori-sezon-79",
            "url": "https://hollyhq.info/news/Gossip-Girl-Podnoven-za-vtori-sezon-79",
            "title": "'Gossip Girl': Подновен за втори сезон!",
            "content": " 'Клюкарката' е един от онези емблематични сериали които можеш да гледаш многократно и пак да има нещо което си пропуснал, но колкото и големи фенове да сме на класиката - всичко с времето си!",
            "img_url": "https://hollyhq.info/blublog-uploads/photos/2021/9/E1BB3zOzHpNZSsHatiIEjGDUjZlM9jp9BTIlGyhx_1.webp",
            "thumb_url": "https://hollyhq.info/blublog-uploads/photos/2021/9/E1BB3zOzHpNZSsHatiIEjGDUjZlM9jp9BTIlGyhx_2.webp",
            "author_url": "https://hollyhq.info/author/%D0%90%D0%B4%D1%80%D0%B8%D1%8F%D0%BD%D0%B0%20%D0%9A%D1%80%D1%8A%D1%81%D1%82%D0%B5%D0%B2%D0%B0",
            "author_name": "Адрияна Кръстева",
            "date_full": "2021-09-12T14:39:43.000000Z",
            "date": "12.09.2021"
        },
        {
            "id": "Koga-shte-se-zavarne-parvi-sezon-na-Gossip-Girl-9",
            "url": "https://hollyhq.info/news/Koga-shte-se-zavarne-parvi-sezon-na-Gossip-Girl-9",
            "title": "Кога ще се завърне първи сезон на 'Gossip Girl'?",
            "content": "HBO Max разкри миналата седмица, че ще получим втората половина на първи сезон на reboot-a на 'Gossip Girl' през ноември тази година!",
            "img_url": "https://hollyhq.info/blublog-uploads/photos/2021/8/uTDltIXtcr1yDIk26qAaY601u1SwKZFKoIfxCTZ5_1.jpg",
            "thumb_url": "https://hollyhq.info/blublog-uploads/photos/2021/8/uTDltIXtcr1yDIk26qAaY601u1SwKZFKoIfxCTZ5_2.jpg",
            "author_url": "https://hollyhq.info/author/%D0%92%D1%8F%D1%80%D0%B0%20%D0%A2%D1%8A%D0%BF%D1%87%D0%B5%D0%B2%D0%B0",
            "author_name": "Вяра Тъпчева",
            "date_full": "2021-08-16T06:50:58.000000Z",
            "date": "16.08.2021"
        }
    ]
    }
                                                                                                                    
        
Ограничения и Отговори

Ако IP адрес надвиши броя заявки за една минута, ще получите отговор със статус код 429. Ако съдържанието, което търсите не е намерено ще върне статус 404. При успешна обработка връща съдържанието със статус 200.

API 1.0