Get Started
You should log into our website,and buy Professional or Bussiness members, address:noxinfluencer
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 interface request 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 quota per request
Request
GET nox/youtube/v1/channel/profile?noxKey={API Key}&channelId=UC-lHJZR3Gqxm24_Vd_AJ5Yw HTTP/1.1 Content-Type: application/json Host: service.noxinfluencer.com
Parameters
Parameter | Description |
---|---|
| channelId |
| noxKey |
Response
Field | description |
---|---|
averageViews | Average views of the last 30 videos |
categories | Youtube category |
countryCode | Country code |
estPartnerEarning | Est. Partner Earning(Monthly) |
estPotentialEarning | Est. Potential Earnings(each video) |
lastThirtyVideoDisLikes | Total dislikes of the last 30 videos |
lastThirtyVideoLikes | Total likes of the last 30 videos |
lastThirtyVideoViews | Total views of the last 30 videos |
noxScore | NoxScore |
subscribers | Subscriber count |
title | Channel title |
totalVideos | Channel video count |
totalViews | Channel views count |
{
"code" : 10000,
"msg" : "Success",
"items" : [ {
"id" : "UC-lHJZR3Gqxm24_Vd_AJ5Yw",
"title" : "PewDiePie",
"subscribers" : 103000000,
"totalViews" : 24850982304,
"averageViews" : 7582510,
"totalVideos" : 4085,
"categories" : [ 24 ],
"countryCode" : "US",
"noxScore" : 4.66,
"lastThirtyVideoViews" : 6656827,
"lastThirtyVideoLikes" : 17668284,
"lastThirtyVideoDisLikes" : 237500,
"estMonthEarning" : 741391.5,
"estMonthCPM" : 3.44,
"estOneVideoEarning" : 186310.21,
"estOneVideoCPM" : 27,
"languages" : "en",
"socialContacts" : [ "https://www.youtube.com/channel/UC-lHJZR3Gqxm24_Vd_AJ5Yw", "https://instagram.com/pewdiepie", "https://twitter.com/pewdiepie" ]
} ]
}
Search
Description: By using the "Search", you can get the search results that match your request
Quota Spend
20 quota per request
Request
GET 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 HTTP/1.1 Host: service.noxinfluencer.com
Parameters
Parameter | Description |
---|---|
| current page |
| result count per page |
| search keywords |
| youtube category for id one or more |
| subscribers lower limit |
| subscribers upper limit |
| noxScore lower limit |
| noxScore upper limit |
| country code for one or more |
| language code for one or more |
| Est.Exposure lower limit |
| Est.Exposure upper limit |
| noxKey |
Response
Field | description |
---|---|
id | youtube channel id |
title | Channel title |
subscribers | Subscriber count |
totalViews | Channel views count |
noxScore | NoxScore |
countryCode | Country code |
categories | Youtube category |
interactionRate | cross power |
{
"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 quota per request
Request
GET nox/youtube/v1/channel/subscribersDataPortrait?noxKey={API Key}&channelId=UC-lHJZR3Gqxm24_Vd_AJ5Yw HTTP/1.1 Content-Type: application/json Host: service.noxinfluencer.com
Parameters
Parameter | Description |
---|---|
| channelId |
| noxKey |
Response
Field | description |
---|---|
ageAndGenderWithViewPercent | age and gender distribution percent |
viewPercentWithCountry | viewer country distribution percent |
weekActive | How many fans are active each week |
hourTimeActive | 24-hour activity |
activeObserver | Active viewers |
activeObserver.commentDetails | comment content |
activeObserver.comments | comment count |
activeObserver.channelId | comment youtuber id |
activeObserver.totalVideos | comment by videos count |
commonSubscriberChannel | overlap audience channels |
commonSubscriberChannel.channelId | 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 quota per request
Request
GET nox/youtube/v1/channel/video?noxKey={API Key}&channelId=UC-lHJZR3Gqxm24_Vd_AJ5Yw HTTP/1.1 Content-Type: application/json Host: service.noxinfluencer.com
Parameters
Parameter | Description |
---|---|
| channelId |
| noxKey |
Response
Field | description |
---|---|
id | video id |
title | video title |
publishDate | publish date |
views | views |
likes | likes |
comments | comments |
dislikes | dislikes |
channelId | channel id |
estOneVideoEarning | Estimated value of a single video |
tags | keywords |
description | 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 quota per request
Request
GET nox/youtube/v1/channel/ranking?noxKey={API Key}&country=US&category=20&rankSize=100&rankType=2 HTTP/1.1 Content-Type: application/json Host: service.noxinfluencer.com
Parameters
Parameter | Description |
---|---|
| noxKey |
| country code |
| youtube category id |
| total size for page |
| current pageNum |
| 1:noxScore rank 2:subscribers rank 3:avgViews rank 4:subs growth rank 5:unsubscribed rank 6:monthViews rank |
Response
Field | description |
---|---|
ranking | Rankings |
id | 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 of the specific YouTube channel, like the subscribers and views.
Quota Spend
20 quota per request
Request
GET nox/youtube/v1/channel/subscribersAndViewsTrend?noxKey={API Key}&channelId=UC-lHJZR3Gqxm24_Vd_AJ5Yw HTTP/1.1 Content-Type: application/json Host: service.noxinfluencer.com
Parameters
Parameter | Description |
---|---|
| channelId |
| noxKey |
Response
Field | description |
---|---|
recentYearsSubscribers | Subscribers in the past year |
recentYearsSubscribersIncrement | Daily subscriber growth in the last year |
recentYearsViews | Channel views in the past year |
recentYearsViewsIncrement | Daily increase in channel views in the past year |
futureMonthSubscribersPredicted | Monthly forecast of future subscriber numbers |
futureMonthViewsPredicted | Monthly Forecast of Future Views |
last30DaysEstimatedIncome | Estimated income in the last 30 days |
last30DaysPerDayVideoPublishCount | Video distribution in the last 30 days |
{
"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"
} ],
"last30DaysEstimatedIncome" : [ {
"dataX" : "2020-02-10",
"dataY" : "11670.19"
}..., {
"dataX" : "2020-03-09",
"dataY" : "34138.65"
}, {
"dataX" : "2020-03-10",
"dataY" : "0.0"
} ],
"last30DaysPerDayVideoPublishCount" : [ {
"dataX" : "2020-02-11",
"dataY" : "0"
}..., {
"dataX" : "2020-03-09",
"dataY" : "1"
}, {
"dataX" : "2020-03-10",
"dataY" : "0"
}, {
"dataX" : "2020-03-11",
"dataY" : "0"
} ]
} ]
}
References
Response codes
code | message |
---|---|
10000 | Success |
20000 | Server not available |
20001 | Insufficient authorization |
30001 | this month more than max limit channels |
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 |