> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.trendhero.io/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# API: как пользоваться? Пошаговая инструкция

**Тестирование API в ** [Postman](https://www.postman.com)  
Для теста используйте коллекцию: 
**Postman-коллекция для API**
****
**Инструкция по использованию:**

1. Перейдите по ссылке на коллекцию:
[Postman](https://www.postman.com)
2. Импортируйте коллекцию в Postman.   
3. Используйте ваш токен в разделе:
   [ API → Токены доступа](https://trendhero.io/app/api/access-tokens)    
4. Вставьте токен в Postman
**Post create **

![](https://storage.crisp.chat/users/helpdesk/website/-/8/d/a/5/8da58b676c829000/snimok-ekrana-2025-04-24-v-184_1tei431.png)
**Get show**

![](https://storage.crisp.chat/users/helpdesk/website/-/8/d/a/5/8da58b676c829000/snimok-ekrana-2025-04-24-v-184_h05x91.png)5.  **Для теста вы можете ввести любой демо-аккаунт в разделе Dashboard, чтобы сервис не списывал с вас проверки.**  

[https://trendhero.io/app/dashboard](https://trendhero.io/app/dashboard) — *Demo reports* (в самом низу страницы)

6.  **Для начала вам нужно запросить/создать отчёт (POST create).**  
Обратите внимание, что нужно использовать следующую ссылку:  
`https://api.trendhero.io/api/public/v1/reports?username=davidrobsonyoga`  
После знака `=` указываете логин нужного блогера.

После того как вы отправите запрос, в разделе **Body** будет отображаться информация по блогеру (частично, и данные будут периодически обновляться по мере получения новой информации).

![](https://storage.crisp.chat/users/helpdesk/website/-/8/d/a/5/8da58b676c829000/snimok-ekrana-2025-04-25-v-105_7x6n1h.png)
**Чтобы проверить** статус отчёта, в поиске введите `status`.  
Вы получите два результата — вам нужно обратить внимание на **первый**.
Как на скриншоте:  
`status — collecting`  

Также возможны следующие статусы:
* `recollecting` — сервис повторно формирует отчёт    
* `ready` — отчёт готов    
* `impossible` — аккаунт закрыт или сервис не может сформировать отчёт

**После того** как вы запросили отчёт в разделе **Post create**, обязательно сохраните значение поля `"pk"`.  
Это и есть **account_pk** — уникальный идентификатор (Instagram ID) данного аккаунта.

![](https://storage.crisp.chat/users/helpdesk/website/-/8/d/a/5/8da58b676c829000/zl-snimok-ekrana-2025-04-25-v-_fi1vbt.png)
Наш сервис идентифицирует аккаунт именно по этому параметру ( `pk` / `account_pk`).  
Это важно, чтобы при получении **callback** вы точно понимали, по какому аккаунту пришло уведомление.
```
"account_pk": 72018706099 / "pk": 72018706099 = "username": "model.gen.mgmt"
```

**P.S.** Если вы отправили запрос и получили сообщение:  
`"error": "У вас самая свежая версия"` 

![](https://storage.crisp.chat/users/helpdesk/website/-/8/d/a/5/8da58b676c829000/snimok-ekrana-2025-04-25-v-104_4ituo3.png)
Это означает, что вы уже запрашивали отчет ранее.
В этом случае просто перейдите в раздел **GET Show**, чтобы получить готовый отчет.

7. **Что происходит после отправки запроса на получение отчета?**

После того как вы отправили запрос на получение отчета, сервису потребуется время для его формирования.  
Скорость зависит от размера аккаунта и актуальности данных:
* Если отчёт уже есть в базе, он сформируется моментально.    
* Если аккаунт ранее не проверялся или проверялся давно, и у него большая аудитория (например, миллион подписчиков), процесс анализа может занять от 2 до 4 часов.    
* Для небольших аккаунтов (до 10 000 подписчиков) отчёт формируется в течение 30–60 минут.

**Как узнать, что отчёт готов?**

Когда отчёт будет сформирован, сервис отправит вам **callback**.
Чтобы получать callback-уведомления, вам нужно в разделе  
[API - Токены доступа](https://trendhero.io/app/api/access-tokens)  Webhook url 
указать URL вашего сервера — **адрес, по которому вы хотите получать уведомления.**
****
![](https://storage.crisp.chat/users/helpdesk/website/-/8/d/a/5/8da58b676c829000/snimok-ekrana-2025-04-24-v-203_2e3z41.png)
Пример Call back, который вы получите от сервиса:
{"report_type": "overall_report",
  "notification_type": "report_ready",
  "account_pk": 209749858,
  "version": "1601367830"}

Пояснение:  
`account_pk` — это уникальный идентификатор аккаунта в Instagram (Instagram ID).

**Раздел Get Show**  

Чтобы получить данные отчета, используйте следующую ссылку:  
`https://api.trendhero.io/api/public/v1/reports/davidrobsonyoga`
Вместо `davidrobsonyoga` укажите логин нужного блогера после последнего `/`

Вот так выглядят данные по отчетам.  
Количество строк зависит от самого аккаунта и того, как давно он был в базе.  
Если аккаунт крупный и добавлен давно, данных может быть много — до 20 000 строк.

![](https://storage.crisp.chat/users/helpdesk/website/-/8/d/a/5/8da58b676c829000/snimok-ekrana-2025-04-25-v-111_11ebmqe.png)





**Кейсы и типичные ошибки:**
 ****
**Раздел Get Show**  
1. "error": "Wrong token"
```
"error": "Wrong token"
```
![](https://storage.crisp.chat/users/helpdesk/website/-/8/d/a/5/8da58b676c829000/snimok-ekrana-2025-04-25-v-110_pfh0uf.png)
![](https://storage.crisp.chat/users/helpdesk/website/-/8/d/a/5/8da58b676c829000/snimok-ekrana-2025-04-25-v-110_lplpk0.png)
Вы неправильно ввели ваш токен. 
Перейдите в раздел [API – Токены доступа](https://trendhero.io/app/api/access-tokens),  
проверьте, правильно ли вы скопировали и вставили токен.

2. В разделе Body слишком мало информации (например, только до 1000 строк).
Статус отчета — `preview`.
 Вы не запрашивали этот отчет через раздел **Post create**. 

![](https://storage.crisp.chat/users/helpdesk/website/-/8/d/a/5/8da58b676c829000/snimok-ekrana-2025-04-25-v-110_1pr6vj8.png)
Откройте раздел **Post create** и сначала отправьте запрос на генерацию отчета для нужного аккаунта.

3.