NoxInfluencer API Document

Get Started

You should log into our website, and buy bussiness or enterprise plan, address: NoxInfluencer Login.
Create your noxKey under the Data Service.
Please keep your own key to avoid unnecessary trouble for you after being used by others.
Your API key must exist in all API requests params, for example: noxKey=XXXXXX.
The original key will be invilad when you refresh the key.

Data API

Channel Information

Description: By using the "Channel Information", you can get the YouTube influencers’ basic information.

Quota Spend

4 Quotas Per Request

Request

https://service.noxinfluencer.com/nox/youtube/v1/channel/profile?noxKey={API Key}&channelId=UC-lHJZR3Gqxm24_Vd_AJ5Yw

Parameters

Parameter	Description
channelId	YouTube Channel ID
noxKey	NoxInfluencer Auth Key

Response

Field	Description
title	Channel Title
subscribers	Subscriber Count
totalVideos	Channel Video Count
totalViews	Channel Views Count
averageViews	Avg. Views of the Last 30 Videos
categories	Category of the YouTuber
countryCode	Country Code of the YouTuber
languages	Language of the YouTuber
noxScore	NoxScore of the YouTuber
estMonthEarning	Est. YouTuber ADs Earning(Monthly)
estOneVideoEarning	Est. Cooperation Price Per Video
subscriberRanking	Global Ranking In Number Of Subscribers
subscriberCountryRanking	Country Ranking In Number Of Subscribers
lastThirtyVideoDisLikes	Total Dislikes of the Last 30 Videos
lastThirtyVideoLikes	Total Likes of the Last 30 Videos
lastThirtyVideoViews	Total Views of the Last 30 Videos
socialContacts	Other Social Links of the YouTuber
registerYouTubeDate	YouTube Channel Creation Time
youtubeAddress	Youtube address link
estViewsPerVideo	Estimated One Video Views

{
  "code" : 10000,
  "msg" : "Success",
  "items" : [ {
    "id" : "UC-lHJZR3Gqxm24_Vd_AJ5Yw",
    "title" : "PewDiePie",
    "subscribers" : 109000000,
    "totalViews" : 27077204782,
    "averageViews" : 4416149,
    "totalVideos" : 4303,
    "categories" : [ 20 ],
    "countryCode" : "US",
    "noxScore" : 4.55,
    "lastThirtyVideoViews" : 3552891,
    "lastThirtyVideoLikes" : 10783674,
    "lastThirtyVideoDisLikes" : 108364,
    "estMonthEarning" : 576372.5,
    "estMonthCPM" : 3.44,
    "estOneVideoEarning" : 171743.4,
    "estOneVideoCPM" : 40,
    "subscriberRanking" : 2,
    "subscriberCountryRanking" : 1,
    "languages" : "en",
    "socialContacts" : [ "https://www.youtube.com/channel/UC-lHJZR3Gqxm24_Vd_AJ5Yw", "https://instagram.com/pewdiepie", "https://twitter.com/pewdiepie" ],
  	"registerYouTubeDate" : "2010-04-29",
  	"youtubeAddress" : "https://www.youtube.com/channel/UC-lHJZR3Gqxm24_Vd_AJ5Yw",
  	"estViewsPerVideo" : 4293585;
  } ]
}

Search

Description: By using the "Search", you can get the search results that match your request

Quota Spend

20 Quotas Per Request

Request

https://service.noxinfluencer.com/nox/youtube/v1/channel/search?noxKey={API Key}&pageNum=1&pageSize=30&keywords=game&categories=20&subscribersGte=1&subscribersLte=1000000&noxScoreGte=0&noxScoreLte=5&countries=US&language=en&estExposureGte=1&estExposureLte=1000000

Parameters

Parameter	Description
pageNum	Current Page Number
pageSize	Result Count Per Page
keywords	Search Keywords
categories	YouTube Category ID for One or More
subscribersGte	Subscribers Lower Limit
subscribersLte	Subscribers Upper Limit
noxScoreGte	noxScore Lower Limit
noxScoreLte	noxScore Upper Limit
countries	Country Code for One or More
language	Language Code for One or More
estExposureGte	Est. Exposure Lower Limit
estExposureLte	Est. Exposure Upper Limit
noxKey	NoxInfluencer Auth Key

Response

Field	Description
id	Youtube Channel ID
title	Channel Title
subscribers	Subscriber Count
totalViews	Channel Views Count
noxScore	NoxScore of YouTuber
countryCode	Country Code
categories	Youtube Category
interactionRate	Engagement of YouTuber

{
  "code" : 10000,
  "msg" : "Success",
  "pageInfo" : {
    "currentPage" : 1,
    "resultsPerPage" : 30,
    "totalResults" : 1000
  },
  "items" : [ {
    "id" : "UCOsLinHfFppH4XKs4PCKt2A",
    "title" : "Gallant Gaming",
    "subscribers" : 113000,
    "totalViews" : 27077234,
    "noxScore" : 4.33,
    "countryCode" : "US",
    "categories" : [ 20 ],
    "interactionRate" : 0.06626
  }, {
    "id" : "UCGnfZ4vpU6XG8Y2oA9mYOmA",
    "title" : "Kokorix Gaming",
    "subscribers" : 144000,
    "totalViews" : 69018304,
    "noxScore" : 3.5,
    "countryCode" : "US",
    "categories" : [ 20 ],
    "interactionRate" : 0.00875
  } ]
}

Audience

Description: By using the "Audience", you can get the specific Audience Portrait of the YouTube channel.

Quota Spend

5 Quotas Per Request

Request

https://service.noxinfluencer.com/nox/youtube/v1/channel/subscribersDataPortrait?noxKey={API Key}&channelId=UC-lHJZR3Gqxm24_Vd_AJ5Yw

Parameters

Parameter	Description
channelId	YouTube Channel ID
noxKey	NoxInfluencer Auth Key

Response

Field	Description
ageAndGenderWithViewPercent	Age and Gender Distribution Percent
viewPercentWithCountry	Country Distribution Percent
weekActive	Active Time Each Week
hourTimeActive	Active Time Each Day
activeObserver	Active Viewers
activeObserver.commentDetails	Comment Content of Active Viewers
activeObserver.comments	Comment Count of Active Viewers
activeObserver.channelId	Active Viewers YouTuber ID
activeObserver.totalVideos	Active Viewers Videos Count
commonSubscriberChannel	Overlap Subscribers Channels
commonSubscriberChannel.channelId	Overlap Subscribers Channels ID
commonSubscriberChannel.commonRatio	Overlap Ratio
commonSubscriberChannel.commonSubscriber	Overlap Subscribers

{
  "code" : 10000,
  "msg" : "Success",
  "items" : [ {
    "ageAndGenderWithViewPercent" : [ [ "age13-17", "female", 4.0 ], [ "age13-17", "male", 5.0 ], [ "age18-24", "female", 12.0 ], [ "age18-24", "male", 12.0 ], [ "age25-34", "female", 23.0 ], [ "age25-34", "male", 25.0 ], [ "age35-44", "female", 6.0 ], [ "age35-44", "male", 7.000000000000001 ], [ "age45-54", "female", 2.0 ], [ "age45-54", "male", 3.0 ], [ "age55-64", "female", 0.0 ], [ "age55-64", "male", 1.0 ], [ "age65-", "female", 0 ], [ "age65-", "male", 0 ] ],
    "viewPercentWithCountry" : [ [ "UM", 6 ], [ "VI", 3 ], [ "CA", 8 ], [ "US", 83 ] ],
    "weekActive" : {
      "mon" : 0.1216,
      "tue" : 0.1071,
      "wed" : 0.1416,
      "thu" : 0.1366,
      "fri" : 0.1562,
      "sat" : 0.1722,
      "sun" : 0.1647
    },
    "hourTimeActive" : {
      "22" : 0.0455,
      "11" : 0.0516,
      "23" : 0.04,
      "12" : 0.0601,
      "13" : 0.0501,
      "14" : 0.0531,
      "15" : 0.0506,
      "16" : 0.046,
      "17" : 0.044,
      "18" : 0.0415,
      "19" : 0.0415,
      "0" : 0.0305,
      "1" : 0.0305,
      "2" : 0.033,
      "3" : 0.0355,
      "4" : 0.03,
      "5" : 0.0315,
      "6" : 0.028,
      "7" : 0.0395,
      "8" : 0.044,
      "9" : 0.034,
      "20" : 0.0485,
      "21" : 0.048,
      "10" : 0.0425
    },
    "activeObserver" : [ {
      "channelId" : "UC3kGBgwt3AhcpdSpwyjHE4g",
      "commentDetails" : [ {
        "content" : "imagine having I girlfriend that would play Minecraft with you...",
        "pubTime" : 1582405286,
        "videoId" : "yncoNo7tr2s"
      }...],
    "commonSubscriberChannel" : [ {
      "channelId" : "UCxSz6JVYmzVhtkraHWZC7HQ",
      "commonRatio" : 0.035,
      "commonSubscriber" : [ "UC2Tbav7HSZDneMc0ncTd-gA", "UCqRFyWuJRDRvXXqV9mygQpg", "UCgyZ0M3f6ssWp0GoFG8w0tQ", "UCTn9grf8A823c_OFGR70TEQ", "UCL9DoygLhTD3lfBgSX7TX9A", "UCO0IfPLAXVsBWrdgwvJ-Zow", "UC45btmso1BISZutSLzVhj8g" ]
    }...]
  } ]
}

Videos

Description: By using the "videos", you can get the specific data of recent 30 videos of the YouTube Channel.

Quota Spend

4 Quotas Per Request

Request

https://service.noxinfluencer.com/nox/youtube/v1/channel/video?noxKey={API Key}&channelId=UC-lHJZR3Gqxm24_Vd_AJ5Yw

Parameters

Parameter	Description
channelId	YouTube Channel ID
noxKey	NoxInfluencer Auth Key

Response

Field	Description
id	Video ID
title	Video Title
publishDate	Video Publish Date
views	Video Views
likes	Video Likes Count
comments	Video Comments Count
dislikes	Video Dislikes Count
channelId	YouTube Channel ID
estOneVideoEarning	Estimated Value of the Video
tags	Video Keywords
description	Video Description

{
  "code" : 10000,
  "msg" : "Success",
  "pageInfo" : {
    "currentPage" : 1,
    "resultsPerPage" : 30,
    "totalResults" : 30
  },
  "items" : [ {
    "id" : "FJMQjF6I4Bw",
    "title" : "NEVER call me a SIMP!",
    "publishDate" : "2020-03-09",
    "views" : 3679823,
    "likes" : 333749,
    "comments" : 32435,
    "dislikes" : 6209,
    "channelId" : "UC-lHJZR3Gqxm24_Vd_AJ5Yw",
    "estOneVideoEarning" : 99355.22,
    "tags" : [ "SATIRE" ],
    "description" : "simping isnt a joke stop calling me a simp now\n100 CLUB MERCH OUT NOW! https://represent.com/store/pewdiepie (Thank you)\n\nPewdiepie's Pixelings DOWNLOAD:\niOS: https://buff.ly/2pNG0aT\nAndroid: https://buff.ly/34C68nZ\n#pewdiepie #pixelings\n\nMinecraft Playlist:\nhttps://www.youtube.com/watch?v=mhgS6...\n\nMy Stores:\nTSUKI:\nhttps://tsuki.market/\nMerch:\nhttps://represent.com/store/pewdiepie\n\nI drink GFUEL (affiliate link):\nhttps://gfuel.ly/31Kargr\n\nMy Setup (affiliate links):\nChair: https://clutchchairz.com/pewdiepie/\nOfficial Razer hardware:\nRazer Nari Ultimate headset: http://rzr.to/pdp-razer-nari \nRazer Customs phone cases: http://rzr.to/pdp-razer-case\n\nNordVPN DOWNLOAD (affiliate link):\nGo to https://NordVPN.com/pewdiepie and use code PEWDIEPIE to get 70% off a 3 year plan plus 1 additional month free.\n\nI stream on DLive (ad):\nhttps://go.dlive.tv/pewdiepie"
  },{
    "id" : "AAODp5upEF0",
    "title" : "Decade of Pewdiepie, photos from my childhood",
    "publishDate" : "2019-12-31",
    "views" : 4671162,
    "likes" : 424643,
    "comments" : 26234,
    "dislikes" : 2284,
    "channelId" : "UC-lHJZR3Gqxm24_Vd_AJ5Yw",
    "estOneVideoEarning" : 126121.37,
    "tags" : [ "SATIRE" ],
    "description" : "omg so embarrassing old photos of pewdiepie\n100 CLUB MERCH OUT NOW! https://represent.com/store/pewdiepie (Thank you)\n\nPewdiepie's Pixelings DOWNLOAD:\niOS: https://buff.ly/2pNG0aT\nAndroid: https://buff.ly/34C68nZ\n#pewdiepie #pixelings\n\nMinecraft Playlist:\nhttps://www.youtube.com/watch?v=mhgS6...\n\nMy Stores:\nTSUKI:\nhttps://tsuki.market/\nMerch:\nhttps://represent.com/store/pewdiepie\n\nI drink GFUEL (affiliate link):\nhttps://gfuel.ly/31Kargr\n\nMy Setup (affiliate links):\nChair: https://clutchchairz.com/pewdiepie/\nOfficial Razer hardware:\nRazer Nari Ultimate headset: http://rzr.to/pdp-razer-nari \nRazer Customs phone cases: http://rzr.to/pdp-razer-case\n\nNordVPN DOWNLOAD (affiliate link):\nGo to https://NordVPN.com/pewdiepie or use code PEWDIEPIE for a special holiday deal. Get a 3-year plan with 81% off plus two amazing gifts: 4 extra months + NordPass password manager app (worth $194.61)\n\nI stream on DLive (ad):\nhttps://go.dlive.tv/pewdiepie"
  } ]
}

Ranking

Description: By using the "Ranking", you can get the YouTube rank.

Quota Spend

20 Quotas Per Request

Request

https://service.noxinfluencer.com/nox/youtube/v1/channel/ranking?noxKey={API Key}&country=US&category=20&rankSize=100&rankType=2

Parameters

Parameter	Description
noxKey	NoxInfluencer Auth Key
country	Country Code
category	YouTube Category ID
pageSize	Result for One Page
pageNum	Current Page Number
rankType	1:Sort By noxScore 2:Sort By Subscribers 3:Sort By AvgViews 4:Sort By Subs Growth 5:Sort By Unsubscribed 6:Sort By MonthViews

Response

Field	Description
ranking	Rankings of the YouTuber
id	YouTube Channel ID
title	Channel Title
subscribers	Subscriber Count
noxStarLevel	NoxScore
averageViews	Average Views
categories	Youtube Category
countryCode	Country Code

{
  "code" : 10000,
  "msg" : "Success",
  "pageInfo" : {
    "currentPage" : 1,
    "resultsPerPage" : 100,
    "totalResults" : 1000
  },
  "items" : [ {
    "ranking" : 1,
    "id" : "UC7_YxT-KID8kRbqZo7MyscQ",
    "title" : "Markiplier",
    "subscribers" : 25100000,
    "noxStarLevel" : 3.73,
    "averageViews" : 1813972,
    "categories" : [ "Gaming" ],
    "countryCode" : "US"
  }, {
    "ranking" : 100,
    "id" : "UCI4Wh0EQPjGx2jJLjmTsFBQ",
    "title" : "Node",
    "subscribers" : 3220000,
    "noxStarLevel" : 2.5,
    "averageViews" : 363194,
    "categories" : [ "Gaming" ],
    "countryCode" : "US"
  } ]
}

Data Trending

Description: By using "Data Trending", you can get the trending data in the past year of the specific YouTube channel, like the subscribers and views.

Quota Spend

20 Quotas Per Request

Request

https://service.noxinfluencer.com/nox/youtube/v1/channel/subscribersAndViewsTrend?noxKey={API Key}&channelId=UC-lHJZR3Gqxm24_Vd_AJ5Yw

Parameters

Parameter	Description
channelId	YouTube Channel ID
noxKey	NoxInfluencer Auth Key

Response

Field	Description
recentYearsSubscribers	Daily Total Subscribers in the Past Year
recentYearsSubscribersIncrement	Daily Subscribers Growth in the Past Year
recentYearsViews	Daily Total Views in the Past Year
recentYearsViewsIncrement	Daily Views in the Past Year

{
  "code" : 10000,
  "msg" : "Success",
  "items" : [ {
    "recentYearsSubscribers" : [ {
      "dataX" : "2019-03-11",
      "dataY" : "88786252"
    }..., {
      "dataX" : "2020-03-09",
      "dataY" : "0"
    }, {
      "dataX" : "2020-03-10",
      "dataY" : "0"
    } ],
    "recentYearsSubscribersIncrement" : [ {
      "dataX" : "2019-03-11",
      "dataY" : "88786252"
    }..., {
      "dataX" : "2020-03-09",
      "dataY" : "0"
    }, {
      "dataX" : "2020-03-10",
      "dataY" : "0"
    } ],
    "recentYearsViews" : [ {
      "dataX" : "2019-03-11",
      "dataY" : "20692823492"
    }..., {
      "dataX" : "2020-03-09",
      "dataY" : "24841058277"
    }, {
      "dataX" : "2020-03-10",
      "dataY" : "24850982304"
    } ],
    "recentYearsViewsIncrement" : [ {
      "dataX" : "2019-03-11",
      "dataY" : "6192825"
    }..., {
      "dataX" : "2020-03-09",
      "dataY" : "9924027"
    }, {
      "dataX" : "2020-03-10",
      "dataY" : "0"
    } ]
  } ]
}

References

Response codes

Code	Message
10000	Success
20000	Server Not Available
20001	Insufficient Authorization
30001	More Than Max Limit Channels Count
40001	Missing Required Parameters
40002	Invalid Parameter
40003	Invalid NoxKey
40004	Source Not Found
40005	No Quota Available
50000	Business Processing Failure
50001	Request Rate is Too Fast
50002	Result Exceed Max Size

Category Codes

Code	Category
1	Film & Animation
2	Autos & Vehicles
10	Music
15	Pets & Animals
17	Sports
18	Short Movies
19	Travel & Events
20	Gaming
21	Videoblogging
22	People & Blogs
24	Entertainment
25	News & Politics
26	Howto & Style
27	Education
28	Science & Technology
29	Nonprofits & Activism
30	Movies
31	Anime & Animation
32	Action & Adventure
33	Classics
34	Comedy
35	Documentary
36	Drama
37	Family
38	Foreign
39	Horror
40	Sci-Fi & Fantasy
41	Thriller
42	Shorts
43	Shows
44	Trailers

Country Codes

Code	Country
PR	Puerto Rico
PS	Palestinian Territories
PT	Portugal
PW	Palau
PY	Paraguay
QA	Qatar
AD	Andorra
AE	United Arab Emirates
AF	Afghanistan
AG	Antigua & Barbuda
AI	Anguilla
AL	Albania
AM	Armenia
AO	Angola
AQ	Antarctica
AR	Argentina
AS	American Samoa
AT	Austria
RE	Réunion
AU	Australia
AW	Aruba
AX	Åland Islands
AZ	Azerbaijan
RO	Romania
BA	Bosnia & Herzegovina
BB	Barbados
RS	Serbia
BD	Bangladesh
BE	Belgium
RU	Russia
BF	Burkina Faso
BG	Bulgaria
RW	Rwanda
BH	Bahrain
BI	Burundi
BJ	Benin
BL	St. Barthélemy
BM	Bermuda
BN	Brunei
BO	Bolivia
SA	Saudi Arabia
BQ	Caribbean Netherlands
SB	Solomon Islands
BR	Brazil
SC	Seychelles
BS	Bahamas
SD	Sudan
BT	Bhutan
SE	Sweden
BV	Bouvet Island
SG	Singapore
BW	Botswana
SH	St. Helena
SI	Slovenia
BY	Belarus
SJ	Svalbard & Jan Mayen
BZ	Belize
SK	Slovakia
SL	Sierra Leone
SM	San Marino
SN	Senegal
SO	Somalia
CA	Canada
SR	Suriname
CC	Cocos (Keeling) Islands
SS	South Sudan
CD	Congo - Kinshasa
ST	São Tomé & Príncipe
CF	Central African Republic
SV	El Salvador
CG	Congo - Brazzaville
CH	Switzerland
SX	Sint Maarten
CI	Côte d’Ivoire
SY	Syria
SZ	Swaziland
CK	Cook Islands
CL	Chile
CM	Cameroon
CN	China
CO	Colombia
CR	Costa Rica
TC	Turks & Caicos Islands
TD	Chad
CU	Cuba
TF	French Southern Territories
CV	Cape Verde
TG	Togo
CW	Curaçao
TH	Thailand
CX	Christmas Island
CY	Cyprus
TJ	Tajikistan
CZ	Czech Republic
TK	Tokelau
TL	Timor-Leste
TM	Turkmenistan
TN	Tunisia
TO	Tonga
TR	Turkey
TT	Trinidad & Tobago
DE	Germany
TV	Tuvalu
TW	Taiwan
DJ	Djibouti
TZ	Tanzania
DK	Denmark
DM	Dominica
DO	Dominican Republic
UA	Ukraine
UG	Uganda
DZ	Algeria
UK	United Kingdom
UM	U.S. Outlying Islands
EC	Ecuador
US	United States
EE	Estonia
EG	Egypt
EH	Western Sahara
UY	Uruguay
UZ	Uzbekistan
VA	Vatican City
ER	Eritrea
VC	St. Vincent & Grenadines
ES	Spain
ET	Ethiopia
VE	Venezuela
VG	British Virgin Islands
VI	U.S. Virgin Islands
VN	Vietnam
VU	Vanuatu
FI	Finland
FJ	Fiji
FK	Falkland Islands
FM	Micronesia
FO	Faroe Islands
FR	France
WF	Wallis & Futuna
GA	Gabon
WS	Samoa
GD	Grenada
GE	Georgia
GF	French Guiana
GG	Guernsey
GH	Ghana
GI	Gibraltar
GL	Greenland
GM	Gambia
GN	Guinea
GP	Guadeloupe
GQ	Equatorial Guinea
GR	Greece
GS	So. Georgia & So. Sandwich Isl.
GT	Guatemala
GU	Guam
GW	Guinea-Bissau
GY	Guyana
HK	Hong Kong SAR China
HM	Heard & McDonald Islands
HN	Honduras
HR	Croatia
HT	Haiti
YE	Yemen
HU	Hungary
ID	Indonesia
YT	Mayotte
IE	Ireland
IL	Israel
IM	Isle of Man
IN	India
IO	British Indian Ocean Territory
ZA	South Africa
IQ	Iraq
IR	Iran
IS	Iceland
IT	Italy
ZM	Zambia
JE	Jersey
ZW	Zimbabwe
JM	Jamaica
JO	Jordan
JP	Japan
KE	Kenya
KG	Kyrgyzstan
KH	Cambodia
KI	Kiribati
KM	Comoros
KN	St. Kitts & Nevis
KP	North Korea
KR	South Korea
KW	Kuwait
KY	Cayman Islands
KZ	Kazakhstan
LA	Laos
LB	Lebanon
LC	St. Lucia
LI	Liechtenstein
LK	Sri Lanka
OTHERS	others
LR	Liberia
LS	Lesotho
LT	Lithuania
LU	Luxembourg
LV	Latvia
LY	Libya
MA	Morocco
MC	Monaco
MD	Moldova
ME	Montenegro
MF	St. Martin
MG	Madagascar
MH	Marshall Islands
MK	Macedonia
ML	Mali
MM	Myanmar (Burma)
MN	Mongolia
MO	Macau SAR China
MP	Northern Mariana Islands
MQ	Martinique
MR	Mauritania
MS	Montserrat
MT	Malta
MU	Mauritius
MV	Maldives
MW	Malawi
MX	Mexico
MY	Malaysia
MZ	Mozambique
NA	Namibia
NC	New Caledonia
NE	Niger
NF	Norfolk Island
NG	Nigeria
NI	Nicaragua
NL	Netherlands
NO	Norway
NP	Nepal
NR	Nauru
NU	Niue
NZ	New Zealand
OM	Oman
PA	Panama
PE	Peru
PF	French Polynesia
PG	Papua New Guinea
PH	Philippines
PK	Pakistan
PL	Poland
PM	St. Pierre & Miquelon
PN	Pitcairn Islands
GLOBAL	Global