NoxInfluencer API Document

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`	channelId
`noxKey`	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
`pageNum`	current page
`pageSize`	result count per page
`keywords`	search keywords
`categories`	youtube category for id 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`	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`	channelId
`noxKey`	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`	channelId
`noxKey`	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`	noxKey
`country`	country code
`category`	youtube category id
`pageSize`	total size for page
`pageNum`	current pageNum
`rankType`	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`	channelId
`noxKey`	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