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 |
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 |