NoxInfluencer API Document

Get Started

  1. You should log into our website,and buy Professional or Bussiness members, address:noxinfluencer

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

ParameterDescription

channelId

channelId

noxKey

noxKey

  • Response

Fielddescription

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

ParameterDescription

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

Fielddescription

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

ParameterDescription

channelId

channelId

noxKey

noxKey

  • Response

Fielddescription

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

ParameterDescription

channelId

channelId

noxKey

noxKey

  • Response

Fielddescription

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

ParameterDescription

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

Fielddescription

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

ParameterDescription

channelId

channelId

noxKey

noxKey

  • Response

Fielddescription

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

codemessage

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

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

NoxInfluencer团队

欢迎访问NoxInfluencer。商务合作、产品案例、或者有任何建议,可以在这里留言,我们会尽快给您回复。

通过facebook提问
(推荐)