Noxdeveloper Documentation

Nox聚星API介绍

Nox聚星API基于REST进行开发，提供可预测且面向资源的URL，接受JSON编码的请求体，返回JSON编码的响应，并使用标准的HTTP响应代码。

我们提供的强大且灵活的应用程序接口（API），支持开发者获取主流社交媒体的统计数据和分析数据。支持用户定制数据接口和字段。

如需了解更多关于Nox聚星的产品和服务，你可以访问noxinfluencer.com，或者联系我们的客户经理了解。

为什么需要使用Nox聚星API

通过我们的API，开发者可以快速获取对其业务有帮助的高价值数据，与其内部系统或者应用进行数据对接。无需要自行去每个平台中逐一搜集。无论是数据获取还是数据分析，都可以借助我们精心设计的API接口来实现。我们的API提供深入且精确的统计信息与分析结果，可以帮助你更好地理解社交媒体市场的运行状况，根据数据进行有针对性的策略调整。

如何调用Nox聚星API

对于有API数据服务需求的开发者，需要与我们的客户经理对接并明确数据需求，开发者将收到相应的数据方案和报价计划。

双方确认无误后，我们将为您配置专有的Nox Key，并按照以下文档内容，正确使用Nox聚星API接口即可。

Production:

https://service.noxinfluencer.com

数据	格式说明
Timestamps	Date and time with timezone information in yyyy-MM-ddTHH:mm:ss.SSS+0800 format, The time zone is Asia/Shanghai. 时间戳：日期和时间格式以yyyy-MM-ddTHH:mm:ss.SSS+0800展现，如Asia/Shanghai.
Country Codes	Two-letter ISO 3166-2 country code. 国家代码格式以 ISO 3166-2 为准
Language Codes	Two-letter ISO 639-1 language codes. 语言代码以ISO 639-1为准
Currency Codes	Three-letter ISO 4217 currency code. 货币代码以ISO 4217 为准

状态码	提示信息	描述
10000	success	成功
20000	server not available	无服务
20001	insufficient authorization	权限不足
30001	month's channel limit reached	达月度配额上限
40001	missing required parameters	请求参数缺失
40002	invalid parameter	无效参数
40003	invalid noxKey	无效noxKey
40004	source not found	频道不存在
40005	no quota available	配额不足
40007	result exceeds max size	结果超出最大限额
40008	channel requested is not found	频道未收录
50000	business processing failure	业务处理失败
50001	request rate is too fast	请求过快

支持开发者通过YouTube相关接口，获取YouTube网红频道、YouTube网红视频、YouTube视频评论数据。

根据网红链接获取唯一id

Query Parameters

noxKeystring Required

noxKey

urlstring Required

网红链接

Response

200

Object

Response Attributes

codenumber Required

接口返回状态码

msgstring Required

状态码简单描述

pageInfostring

itemsarray Required

Show child attributes

curl --location 'https://service.noxinfluencer.com/nox/v1/youtube/convertChannelUrlToId?noxKey=&url=' \

{
  "code": 10000,
  "msg": "Success",
  "pageInfo": null,
  "items": [
    "UCBR8-60-B28hp2BmDPdntcQ"
  ]
}

获取频道联系方式

Query Parameters

noxKeystring Required

noxKey

channelIdstring Required

频道id

Response

200

Object

Response Attributes

codenumber Required

接口返回状态码

msgstring Required

状态码简单描述

pageInfostring

itemsarray Required

Show child attributes

curl --location 'https://service.noxinfluencer.com/nox/v1/youtube/contactInfos?noxKey=&channelId=' \

{
  "code": 10000,
  "msg": "Success",
  "pageInfo": null,
  "items": [
    {
      "contactInfos": [
        {
          "name": "email",
          "value": "xxx@xxx.xxx"
        }
      ],
      "id": "xxxxxxxxxxxxxxx",
      "platform": 1
    }
  ]
}

频道信息支持通过账号唯一标识id获取其账号的相关信息。

/

Query Parameters

noxKeystring Required

noxKey

channelIdstring Required

账号唯一标识id

Response

200

Object

Response Attributes

codenumber Required

接口返回状态码

msgstring Required

状态码简单描述

itemsarray Required

Show child attributes

curl --location 'https://service.noxinfluencer.com/nox/v1/youtube/profile?noxKey=&channelId=' \

{
  "code": 10000,
  "msg": "Success",
  "items": [
    {
      "id": "123456",
      "title": "Example Title",
      "url": "https://www.example.com",
      "avatar": "https://www.example.com/avatar.png",
      "introduction": "This is an introduction",
      "socialMediaLink": {
        "platformName": "Twitter",
        "link": "https://www.twitter.com/example"
      },
      "gender": "Male",
      "country": "US",
      "language": "en",
      "noxCategory": "Health",
      "category": "Fitness",
      "tags": [
        {
          "weight": 0.8,
          "tagName": "Exercise"
        }
      ],
      "registerDate": "2023-01-01",
      "subscribers": 10000,
      "noxScore": 4.5,
      "subscriberRanking": 50,
      "subscriberCountryRanking": 10,
      "topCountrySubscriber": "US",
      "topGenderSubscriber": "Male",
      "topAgeSubscriber": "25-34",
      "subscriberAgeDistribution": [
        {
          "value": 0.2,
          "age": "18-24"
        },
        {
          "value": 0.3,
          "age": "25-34"
        }
      ],
      "subscriberGenderDistribution": [
        {
          "gender": "Male",
          "value": 0.6
        },
        {
          "gender": "Female",
          "value": 0.4
        }
      ],
      "subscriberCountryDistribution": [
        {
          "value": 0.5,
          "country": "US"
        },
        {
          "value": 0.3,
          "country": "UK"
        }
      ],
      "subscriberLanguageDistribution": [
        {
          "value": 0.6,
          "language": "en"
        },
        {
          "value": 0.4,
          "language": "es"
        }
      ],
      "subscriberReliability": {
        "usualUser": 74.9,
        "suspicious": 17.05,
        "generator": 4.13,
        "influencer": 3.92
      },
      "videosPerMonth": 20,
      "lastPublishTime": "2023-02-15T12:00:00+08:00",
      "lastPromoteTime": "2023-02-20T10:30:00+08:00",
      "totalVideos": 50,
      "totalViews": 100000,
      "totalComments": 500,
      "totalLikes": 1500,
      "totalAvgViews": 2000,
      "estViews": 500000,
      "estPrice": 10000,
      "countryCpmMin": 5,
      "countryCpmMax": 10,
      "estimatedPriceMin": 5000,
      "estimatedPriceMax": 10000,
      "lastPublishTimeShorts": "2023-02-15T12:00:00+08:00",
      "lastPromoteTimeShorts": "2023-02-20T10:30:00+08:00",
      "estViewsShorts": 250000,
      "estPriceShorts": 5000,
      "totalVideosShorts": 20,
      "totalViewsShorts": 50000,
      "totalAvgViewsShorts": 2500,
      "totalLikesShorts": 750,
      "totalCommentsShorts": 250,
      "lastPublishTimeNormal": "2023-02-15T12:00:00+08:00",
      "lastPromoteTimeNormal": "2023-02-20T10:30:00+08:00",
      "estViewsNormal": 250000,
      "estPriceNormal": 5000,
      "totalVideosNormal": 30,
      "totalViewsNormal": 75000,
      "totalAvgViewsNormal": 5000,
      "totalLikesNormal": 1000,
      "totalCommentsNormal": 300,
      "totalVideosLive": 5,
      "totalViewsLive": 5000,
      "totalAvgViewsLive": 1000,
      "totalLikesLive": 200,
      "totalCommentsLive": 100,
      "last30AvgViews": 3000,
      "last30EngagementRate": 0.15,
      "last30AvgViewsSubscribers": 300,
      "last30AvgLikes": 100,
      "last30AvgComments": 50,
      "last30CommentsViews": 0.02,
      "last30LikesViews": 0.05,
      "last10AvgViews": 3500,
      "last10EngagementRate": 0.2,
      "last10AvgLikes": 150,
      "last10AvgComments": 70,
      "last10CommentsViews": 0.02,
      "last10LikesViews": 0.04,
      "last10ViewsSubscribers": 200,
      "last20AvgViews": 4000,
      "last20EngagementRate": 0.18,
      "last20AvgLikes": 120,
      "last20AvgComments": 60,
      "last20CommentsViews": 0.015,
      "last20LikesViews": 0.04,
      "last20AvgViewsSubscribers": 250,
      "last30DayVideos": 30,
      "last30DaysAvgViews": 2000,
      "last30DaysEngagementRate": 0.12,
      "last30DaysAvgLikes": 80,
      "last30DaysAvgComments": 40,
      "last30DaysCommentsViews": 0.03,
      "last30DaysLikesViews": 0.04,
      "last30DaysAvgViewsSubscribers": 150,
      "last30AvgViewsShorts": 1800,
      "last30EngagementRateShorts": 0.1,
      "last30AvgViewsSubscribersShorts": 150,
      "last30AvgLikesShorts": 50,
      "last30AvgCommentsShorts": 30,
      "last30CommentsViewsShorts": 0.01,
      "last30LikesViewsShorts": 0.03,
      "last10AvgViewsShorts": 2000,
      "last10EngagementRateShorts": 0.15,
      "last10AvgLikesShorts": 100,
      "last10AvgCommentsShorts": 50,
      "last10CommentsViewsShorts": 0.02,
      "last10LikesViewsShorts": 0.05,
      "last10ViewsSubscribersShorts": 100,
      "last20AvgViewsShorts": 2200,
      "last20EngagementRateShorts": 0.12,
      "last20AvgLikesShorts": 90,
      "last20AvgCommentsShorts": 40,
      "last20CommentsViewsShorts": 0.015,
      "last20LikesViewsShorts": 0.04,
      "last20AvgViewsSubscribersShorts": 120,
      "last30DayVideosShorts": 15,
      "last30DaysAvgViewsShorts": 1500,
      "last30DaysEngagementRateShorts": 0.08,
      "last30DaysAvgLikesShorts": 60,
      "last30DaysAvgCommentsShorts": 30,
      "last30DaysCommentsViewsShorts": 0.02,
      "last30DaysLikesViewsShorts": 0.025,
      "last30DaysAvgViewsSubscribersShorts": 100,
      "last30AvgViewsNormal": 2200,
      "last30EngagementRateNormal": 0.1,
      "last30AvgViewsSubscribersNormal": 200,
      "last30AvgLikesNormal": 70,
      "last30AvgCommentsNormal": 35,
      "last30CommentsViewsNormal": 0.02,
      "last30LikesViewsNormal": 0.035,
      "last10AvgViewsNormal": 2500,
      "last10EngagementRateNormal": 0.12,
      "last10AvgLikesNormal": 120,
      "last10AvgCommentsNormal": 60,
      "last10CommentsViewsNormal": 0.018,
      "last10LikesViewsNormal": 0.03,
      "last10ViewsSubscribersNormal": 150,
      "last20AvgViewsNormal": 2700,
      "last20EngagementRateNormal": 0.11,
      "last20AvgLikesNormal": 100,
      "last20AvgCommentsNormal": 50,
      "last20CommentsViewsNormal": 0.015,
      "last20LikesViewsNormal": 0.035,
      "last20AvgViewsSubscribersNormal": 180,
      "last30DayVideosNormal": 20,
      "last30DaysAvgViewsNormal": 1800,
      "last30DaysEngagementRateNormal": 0.09,
      "last30DaysAvgLikesNormal": 90,
      "last30DaysAvgCommentsNormal": 45,
      "last30DaysCommentsViewsNormal": 0.015,
      "last30DaysLikesViewsNormal": 0.03,
      "last30DaysAvgViewsSubscribersNormal": 120
    }
  ]
}

支持通过网红频道ID获取账号所发布的视频相关数据。

Query Parameters

noxKeystring

noxKey

channelIdstring

账号唯一标识id

pageNuminteger

页码

Minimum

1

Default value

1

pageSizeinteger

每页条数

Default value

10

startDatestring

视频发布开始时间（yyyy-MM-dd）

endDatestring

视频发布结束时间（yyyy-MM-dd）

videoIdstring

视频ID

Response

200

Object

Response Attributes

codenumber Required

接口返回状态码

msgstring Required

状态码简单描述

pageInfoobject Required

Show child attributes

itemsarray Required

Show child attributes

curl --location 'https://service.noxinfluencer.com/nox/v1/youtube/video' \

{
  "code": 10000,
  "msg": "Success",
  "pageInfo": {
    "totalResults": 205,
    "resultsPerPage": 30,
    "currentPage": 1
  },
  "items": [
    {
      "id": "001",
      "url": "https://example.com",
      "title": "Example Title",
      "description": "This is an example description",
      "thumbnail": "https://example.com/thumbnail.jpg",
      "publishTime": "2022-03-01T08:00:00+08:00",
      "updateTime": "2022-03-01T10:00:00+08:00",
      "duration": 10,
      "likes": 50000,
      "comments": 1000,
      "views": 1000000,
      "videoType": "0",
      "likesRate": 0.05,
      "viewsSubscriberRate": 5,
      "engagementRate": 0.01,
      "language": "EN",
      "country": "US",
      "category": "Education",
      "tags": [
        "tag1",
        "tag2",
        "tag3"
      ],
      "tagWeights": [
        {
          "weight": 0.8,
          "tagName": "tag1"
        },
        {
          "weight": 0.6,
          "tagName": "tag2"
        },
        {
          "weight": 0.4,
          "tagName": "tag3"
        }
      ],
      "brandInfo": {
        "type": "Sponsorship",
        "sourceLink": "https://example.com/sponsorship",
        "link": "https://example.com/brand",
        "name": "Example Brand",
        "id": "123456"
      },
      "estPrice": 5000,
      "authorName": "Author Name",
      "authorUrl": "https://example.com/author",
      "authorSubscribers": 10000
    }
  ]
}

通过关键词hashtag或者关键文本进行视频搜索

Query Parameters

noxKeystring Required

startDatestring

开始时间

endDatestring

结束时间

tagsstring

关键词，支持#hashtag和普通词

countrystring

地区

languagestring

语言

matchFieldsAndOrstring

matchFields两个值都匹配and，默认or

deepSearchLevelstring

1：精确匹配，0：模糊匹配，默认0

nextPageTokenstring

下一页数据标识

matchFieldsstring

匹配的字段。默认title,tags

Response

200

Object

Response Attributes

codenumber

msgstring

pageInfoobject

Show child attributes

itemsarray

Show child attributes

curl --location 'https://service.noxinfluencer.com/nox/v1/tiktok/searchVideo?noxKey=' \

{
  "code": 10000,
  "msg": "Success",
  "pageInfo": {
    "totalResults": 1029,
    "resultsPerPage": 10,
    "currentPage": null,
    "nextPageToken": "RFByb1EzZjFNeTdLZE5KZzRhS29DVW9ZRnZNa2FpZEVKWk1VOEZ6cnl0YnNnTHNnWjZ4Y3pLMDFUQnp1QW1LL01ENHF5bGt5b1pGNWtOQWNKL0ZhWnc9PQ"
  },
  "items": [
    {
      "duration": 6935,
      "publishTime": "2025-03-31T01:10:51.000+0800",
      "comments": null,
      "videoType": null,
      "id": "XphSB63Tsl4",
      "title": "Saturday Night is Live! wanna talk 214-564-6443 YouTube‘s only call in show ☎️",
      "authorId": "UCWRFMiJoQQrsdpiA_3-qnNw",
      "views": 354,
      "url": "https://www.youtube.com/watch?v=XphSB63Tsl4",
      "tags": [
        "Podcast entertainment",
        "podcast",
        "Podcast entertainment videos",
        "Keenan Ann Kell",
        "podcasting",
        "comedian",
        "standup",
        "stand up",
        "Kenan and Kel",
        "kenan",
        "kenan thompson",
        "comedy",
        "funny",
        "live",
        "fun",
        "funn",
        "wtf",
        "club random",
        "Fatman Beyond",
        "its always sunny",
        "hiking with kevin",
        "laughs",
        "90s",
        "mtv",
        "movies",
        "television",
        "saturday night live",
        "SNL",
        "snl",
        "adamsandler",
        "adam sandler",
        "Adam Sandler",
        "fly on the wall",
        "chrisfarley",
        "Chris Farley",
        "chris farley",
        "chris fatley",
        "adan dandler"
      ],
      "likes": 9,
      "interactionsViews": 0.0254
    }
  ]
}

根据视频id获取对应视频的评论信息。

Query Parameters

noxKeystring

noxKey

videoIdstring

视频id

pageNuminteger

页码

Minimum

1

Default value

1

Empty value:

True

pageSizeinteger

每页条数

Minimum

1

Default value

30

Empty value:

True

Response

200

Object

Response Attributes

codenumber Required

接口返回状态码

msgstring

状态码简单描述

pageInfoobject Required

Show child attributes

itemsarray Required

Show child attributes

curl --location 'https://service.noxinfluencer.com/nox/v1/youtube/comments' \

{
  "code": 10000,
  "msg": "Success",
  "pageInfo": {
    "totalResults": 0,
    "resultsPerPage": 30,
    "currentPage": 1
  },
  "items": [
    {
      "id": "001",
      "videoUrl": "https://example.com/video",
      "publishTime": "2022-03-01T08:00:00+08:00",
      "comment": "comment content",
      "likes": 1000,
      "replayCount": 500,
      "authorName": "Author Name",
      "authorUrl": "https://example.com/author",
      "authorAvatar": "https://example.com/avatar.jpg"
    }
  ]
}

网红搜索接口。

Query Parameters

noxKeystring

noxKey

pageNuminteger

页码

Minimum

1

Default value

1

pageSizeinteger

每页条数

Default value

10

titlesarray

网红名称，多个用“,”分割

keywordsarray

搜索词，多个用“,”分割

countriesarray

地区，多个地区简码用“,”分割

subscribersMininteger

粉丝量范围最小值

Empty value:

True

subscribersMaxinteger

粉丝量范围最大值

Empty value:

True

last10AvgViewsMininteger

最近10个平均观看量最小值

Empty value:

True

last10AvgViewsMaxinteger

最近10个平均观看量最大值

Empty value:

True

last10EngagementRateMinnumber

最近10个平均互动率最小值

Empty value:

True

last10EngagementRateMaxnumber

最近10个平均互动率最大值

Empty value:

True

lastPublishDatestring (date)

最后活跃时间

Empty value:

True

hasEmailboolean

是否有邮箱

Empty value:

True

Response

200

Object

Response Attributes

codenumber Required

接口返回状态码

msgstring Required

状态码简单描述

pageInfoobject Required

Show child attributes

itemsarray Required

Show child attributes

curl --location 'https://service.noxinfluencer.com/nox/v1/youtube/search' \

{
  "code": 10000,
  "msg": "Success",
  "pageInfo": {
    "totalResults": 35380,
    "resultsPerPage": 10,
    "currentPage": 1
  },
  "items": [
    {
      "country": "US",
      "gender": "male",
      "subscribers": 1900000,
      "subscriberAgeDistribution": [
        {
          "age": "18-24",
          "value": 39.56
        },
        {
          "age": "25-34",
          "value": 27.87
        },
        {
          "age": "13-17",
          "value": 12.64
        },
        {
          "age": "35-44",
          "value": 10.79
        },
        {
          "age": "45-54",
          "value": 5.32
        },
        {
          "age": "55-64",
          "value": 2.33
        },
        {
          "age": "65+",
          "value": 1.49
        }
      ],
      "topCountrySubscriber": "US",
      "last10AvgEngagementRate": 0.0454,
      "avatar": "https://res-kol.noxgroup.com/noxinfluencer/youtube/avatar/8447d02ad515e888a6d8d7a6e501154a.png",
      "title": "Cool Kicks",
      "url": "https://www.youtube.com/channel/UCSqLdMz1g0rTbr-OExFExYg",
      "subscriberCountryDistribution": [
        {
          "country": "US",
          "value": 66.55
        },
        {
          "country": "UK",
          "value": 10.92
        },
        {
          "country": "IN",
          "value": 9.84
        },
        {
          "country": "OTHERS",
          "value": 6.18
        },
        {
          "country": "AU",
          "value": 4.71
        },
        {
          "country": "CA",
          "value": 1.8
        }
      ],
      "last10AvgViews": 96934,
      "totalVideos": 1018,
      "lastPublishTime": "2024-07-20T03:00:27.000+0800",
      "id": "UCSqLdMz1g0rTbr-OExFExYg",
      "noxCategory": "fashion",
      "subscriberReliability": {
        "usualUser": 78.06,
        "suspicious": 13.53,
        "generator": 4.68,
        "influencer": 3.73
      },
      "subscriberGenderDistribution": [
        {
          "gender": "female",
          "value": 59.08
        },
        {
          "gender": "male",
          "value": 40.92
        }
      ]
    }
  ]
}

支持开发者通过TikTok相关接口，获取TikTok网红频道、视频及视频评论数据。

支持开发者通过Instagram相关接口，获取Instagram网红账号、视频及视频评论数据。

支持开发者通过Facebook相关接口，获取Facebook网红频道、视频及视频评论数据。

支持开发者通过Twitter相关接口，获取Twitter网红频道、视频及视频评论数据。

undefined

为保证服务稳定性，单个Nox Key的请求速率限制为60次/分钟。

API测试方法

开放者可以在右上角点击“API测试”，或者在每个接口中点击“Try in API explorer”
您可以使用以下列出的demo noxKey和channelId进行测试。

Nox key

NOXKOLdZ1mACJlFeskFxJqeR2LjxCXYp6R

YouTube channel id

UCq-Fj5jknLsUf-MWSy4_brA

UCX6OQ3DkcsbYNE6H8uQQuVA

UC3IZKseVpdzPSBaWxBxundA

UCOmHUn--16B90oW2L6FRR3A

UC-lHJZR3Gqxm24_Vd_AJ5Yw

Instagram channel id

25025320

173560420

427553890

460563723

12281817

TikTok channel id

127905465618821121

5831967

6748458643983238149

6614519312189947909

107955

2023-12-19

Twitter增加Convert URL接口

2023-11-23

YouTube视频数据请求参数，每页返回结果数量从30调整至10

Instagram视频数据请求参数，每页返回结果数量从30调整至10

TikTok视频数据请求参数，每页返回结果数量从30调整至10

Facebook视频数据请求参数，每页返回结果数量从30调整至10

Twitter视频数据请求参数，每页返回结果数量从30调整至10

Sections

Nox聚星API指引

Nox聚星API介绍

为什么需要使用Nox聚星API

如何调用Nox聚星API

What made this section unhelpful for you?

Language Box

cURL

Ruby

Python

PHP

Java

Node.js

Go

.NET

What made this section unhelpful for you?

Data format-数据格式

What made this section unhelpful for you?

Code message-状态码提示

What made this section unhelpful for you?

YouTube

What made this section unhelpful for you?

Convert URL

Query Parameters

ResponseExpand all

Response Attributes

What made this section unhelpful for you?

Response

What made this section unhelpful for you?

Contact information

Query Parameters

ResponseExpand all

Response Attributes

What made this section unhelpful for you?

Response

What made this section unhelpful for you?

Channel data

Query Parameters

ResponseExpand all

Response Attributes

What made this section unhelpful for you?

Response

What made this section unhelpful for you?

Video data

Query Parameters

ResponseExpand all

Response Attributes

What made this section unhelpful for you?

Response

What made this section unhelpful for you?

Video search data

Query Parameters

ResponseExpand all

Response Attributes

What made this section unhelpful for you?

Response

What made this section unhelpful for you?

Comment data

Query Parameters

ResponseExpand all

Response Attributes

What made this section unhelpful for you?

Response

What made this section unhelpful for you?

Channel search

Query Parameters

ResponseExpand all

Response Attributes

What made this section unhelpful for you?

Response

What made this section unhelpful for you?

TikTok

Instagram

Facebook

Twitter

NaverBlog

Rate limit-速率限制

What made this section unhelpful for you?

API测试样例

API测试方法

Response

Response

Response

Response

Response

Response

Response