NoxInfluencer API Document

Get Started

  1. You should log into our website, and buy bussiness or enterprise plan, address: NoxInfluencer Login.

  2. Create your noxKey under the Data Service.

  3. Please keep your own key to avoid unnecessary trouble for you after being used by others.

  4. 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.
    keyPic

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

ParameterDescription

channelId

YouTube Channel ID

noxKey

NoxInfluencer Auth Key

  • Response

FieldDescription

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;
  } ]
}
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

ParameterDescription

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

FieldDescription

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

ParameterDescription

channelId

YouTube Channel ID

noxKey

NoxInfluencer Auth Key

  • Response

FieldDescription

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

ParameterDescription

channelId

YouTube Channel ID

noxKey

NoxInfluencer Auth Key

  • Response

FieldDescription

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

ParameterDescription

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

FieldDescription

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"
  } ]
}
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

ParameterDescription

channelId

YouTube Channel ID

noxKey

NoxInfluencer Auth Key

  • Response

FieldDescription

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

CodeMessage

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

CodeCategory

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

CodeCountry

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