Get reports of specified list

Endpoint

JSON

GET https://hypeauditor.com/api/method/auditor.list?id=0&limit=10&offset=0

Return the reports of a specified list.

Request Parameters

Field	Type	Description
id	int	Required field, List ID
limit	int	Limit, default=100, max=100
offset	int	Offset, default=0

List item object

Common fields for all report types

Field	Type	Description
report_id	int	Report ID
name	string	Channel name
username	string	Report username or channel ID (for YT)
type	string	Report type: IG, YT, TT, TW, TR
followers	int	Blogger followers/subscribers
comment	string	Report comment. Can be changed on web interface
lists	string	Comma devided list ids
created	int	Date of first report request

Additional fields for IG report type

Field	Type	Description
quality_audience	string	Quality Audience
auth_engagement	string	Authentic Engagement
aqs	string	Audience Quality Score
er	float	Engagement rate, %
audience_age	string	Audience age group, %
audience_geo	string	Audience country, %

Response example

JSON

{
    "result": [
        {
            "report_id": 678,
            "name": "LittleBig Band",
            "username": "littlebig",
            "type": "TT",
            "followers": 2600000,
            "er": 1.34,
            "audience_age": "13-17 54%",
            "audience_geo": "RU 74.76%",
            "comment": null,
            "lists": "0",
            "created": 1602857408
        },
        {
            "report_id": 770,
            "name": "NASA",
            "username": "nasa",
            "type": "IG",
            "followers": 61284055,
            "er": 8.6,
            "quality_audience": 51313139,
            "auth_engagement": 702990,
            "aqs": 97,
            "audience_age": "25-34 38%",
            "audience_geo": "US 15.49%",
            "comment": null,
            "lists": "0",
            "created": 1565617984
        },
        {
            "report_id": 15,
            "name": "karlireese",
            "username": "UCeIlPxGXbLV1tL3w-B5I6uw",
            "type": "YT",
            "followers": 443876,
            "er": 6.4,
            "audience_age": null,
            "audience_geo": null,
            "comment": null,
            "lists": "0",
            "created": 1602234547
        },
        {
            "report_id": 126,
            "name": "Wylsacom",
            "username": "UCt7sv-NKh44rHAEb-qCCxvA",
            "type": "YT",
            "followers": 9660559,
            "er": 3.39,
            "audience_age": "25-34 36%",
            "audience_geo": "RU 74.24%",
            "comment": null,
            "lists": "0,130",
            "created": 1565795644
        }
    ]
}