---
title: "Xiaohongshu Creator Marketplace (Pugongying) Note Details API (V1)"
description: "Retrieves Xiaohongshu Pugongying details for a known note ID. Use it to review an individual note during creator or campaign research."
aiUsagePrompt: true
---

# Xiaohongshu Creator Marketplace \(Pugongying\) Note Details API \(V1\)

<ApiTester
  method="GET"
  :path='JSON.parse("\"/api/xiaohongshu-pgy/api/solar/note/noteId/detail/v1\"")'
  :summary='JSON.parse("\"Note Details (V1)\"")'
  openapiDefinitionUrl="https://docs.justoneapi.com/openapi/xiaohongshu-creator-marketplace-pugongying/note-details-v1-en.json"
  openapiVersion="3.1.0"
  :parameters='JSON.parse("[{\"name\":\"token\",\"in\":\"query\",\"description\":\"User authentication token.\",\"required\":true,\"schema\":{\"type\":\"string\"}},{\"name\":\"noteId\",\"in\":\"query\",\"description\":\"Note&#39;s unique ID.\",\"required\":true,\"schema\":{\"type\":\"string\"}}]")'
  :requestBody='JSON.parse("null")'
  :responses='JSON.parse("{\"200\":{\"description\":\"OK\",\"content\":{\"application/json\":{\"schema\":{\"if\":{\"properties\":{\"code\":{\"const\":0}},\"required\":[\"code\"]},\"then\":{\"properties\":{\"data\":{\"description\":\"The fields returned when the response contains a single Pugongying note object.\",\"properties\":{\"noteId\":{\"type\":\"string\",\"description\":\"The unique Xiaohongshu note ID.\"},\"noteLink\":{\"type\":\"string\",\"description\":\"The Xiaohongshu link to the note, including any platform access parameters returned with it.\"},\"userId\":{\"type\":\"string\",\"description\":\"The Xiaohongshu user ID of the note author.\"},\"headPhoto\":{\"type\":[\"string\",\"null\"],\"description\":\"The note author&#39;s avatar URL, when available.\"},\"name\":{\"type\":[\"string\",\"null\"],\"description\":\"The note author&#39;s display name, when available.\"},\"type\":{\"type\":\"integer\",\"description\":\"The note type code. Observed codes are 1 for image and text and 2 for video.\"},\"title\":{\"type\":\"string\",\"description\":\"The note title, which may be empty.\"},\"content\":{\"type\":\"string\",\"description\":\"The note text, including mentions or topic markup when present.\"},\"imagesList\":{\"type\":\"array\",\"description\":\"Images associated with the note, including a cover image when present.\",\"items\":{\"type\":\"object\",\"description\":\"An image associated with the note.\",\"properties\":{\"fileId\":{\"type\":\"string\",\"description\":\"The platform file ID of this image.\"},\"url\":{\"type\":\"string\",\"description\":\"The image URL returned for display.\"},\"original\":{\"type\":\"string\",\"description\":\"The original image URL provided by the platform.\"},\"width\":{\"type\":\"integer\",\"description\":\"The image width reported by the platform, in pixels.\"},\"height\":{\"type\":\"integer\",\"description\":\"The image height reported by the platform, in pixels.\"},\"traceId\":{\"type\":\"string\",\"description\":\"The platform trace identifier attached to the image.\"},\"imageExtraInfo\":{\"type\":[\"object\",\"null\"],\"description\":\"Additional image metadata, when available.\",\"properties\":{\"imageMetadata\":{\"type\":\"string\",\"description\":\"Image metadata returned by the platform as a string.\"}}}}}},\"videoInfo\":{\"type\":[\"object\",\"null\"],\"description\":\"Video information when available. Image and text notes may return null.\",\"properties\":{\"id\":{\"type\":\"string\",\"description\":\"The ID of the video record.\"},\"videoKey\":{\"type\":\"string\",\"description\":\"The platform storage key for the video.\"},\"originVideoKey\":{\"type\":\"string\",\"description\":\"The platform storage key for the source video.\"},\"meta\":{\"type\":\"object\",\"description\":\"Metadata for the video asset.\",\"properties\":{\"width\":{\"type\":\"integer\",\"description\":\"Video width reported by the platform, in pixels.\"},\"height\":{\"type\":\"integer\",\"description\":\"Video height reported by the platform, in pixels.\"},\"duration\":{\"type\":\"integer\",\"description\":\"The video duration in whole seconds as reported by the platform.\"},\"videoId\":{\"type\":\"string\",\"description\":\"Video identifier in the asset metadata.\"}}},\"gifKey\":{\"type\":\"string\",\"description\":\"The platform storage key for the GIF preview, when available.\"},\"videoUrl\":{\"type\":\"string\",\"description\":\"The video URL supplied by the platform. It can be empty.\"},\"gifUrl\":{\"type\":\"string\",\"description\":\"The URL of the GIF preview, when available.\"},\"videoKeyList\":{\"type\":\"array\",\"description\":\"Additional video asset keys when returned. The array can be empty.\"},\"hasFragments\":{\"type\":\"boolean\",\"description\":\"Whether the platform indicates that the video has fragments.\"},\"thumbnail\":{\"type\":\"string\",\"description\":\"The video thumbnail URL supplied by the platform.\"},\"firstFrame\":{\"type\":[\"string\",\"null\"],\"description\":\"The first-frame image reference, when available.\"},\"volume\":{\"type\":\"number\",\"description\":\"The volume value reported for the video.\"},\"chapters\":{\"type\":[\"array\",\"null\"],\"description\":\"Chapter markers, when available.\",\"items\":{\"type\":\"object\",\"description\":\"A video chapter marker.\",\"properties\":{\"text\":{\"type\":\"string\",\"description\":\"The chapter label.\"},\"time\":{\"type\":\"integer\",\"description\":\"The chapter start offset from the beginning of the video, in milliseconds.\"}}}}}},\"time\":{\"type\":\"object\",\"description\":\"Timestamps associated with the note.\",\"properties\":{\"createTime\":{\"type\":\"integer\",\"description\":\"The note creation time as a Unix timestamp in milliseconds.\"},\"updateTime\":{\"type\":\"integer\",\"description\":\"The note update time as a Unix timestamp in milliseconds.\"},\"userUpdateTime\":{\"type\":\"integer\",\"description\":\"The user update time field supplied with the note, as a Unix timestamp in milliseconds.\"}}},\"createTime\":{\"type\":\"string\",\"description\":\"The note creation time formatted for display in China Standard Time.\"},\"impNum\":{\"type\":\"integer\",\"description\":\"The note impression count reported by Pugongying.\"},\"likeNum\":{\"type\":\"integer\",\"description\":\"The note like count reported by Pugongying.\"},\"favNum\":{\"type\":\"integer\",\"description\":\"The note favorite count reported by Pugongying.\"},\"cmtNum\":{\"type\":\"integer\",\"description\":\"The note comment count reported by Pugongying.\"},\"readNum\":{\"type\":\"integer\",\"description\":\"The note read count reported by Pugongying. Metric availability can vary by note.\"},\"shareNum\":{\"type\":\"integer\",\"description\":\"The note share count reported by Pugongying.\"},\"followCnt\":{\"type\":\"integer\",\"description\":\"The follow count reported alongside the note&#39;s metrics. The attribution window is unspecified.\"},\"userInfo\":{\"type\":\"object\",\"description\":\"Author details from the creator marketplace.\",\"properties\":{\"nickName\":{\"type\":\"string\",\"description\":\"The creator&#39;s display name in the marketplace.\"},\"avatar\":{\"type\":\"string\",\"description\":\"The creator&#39;s avatar URL.\"},\"userId\":{\"type\":\"string\",\"description\":\"The creator&#39;s Xiaohongshu user ID.\"},\"fansNum\":{\"type\":\"integer\",\"description\":\"The creator&#39;s follower count reported by the marketplace.\"},\"cooperType\":{\"type\":\"integer\",\"description\":\"The marketplace cooperation type code for the creator.\"},\"priceState\":{\"type\":[\"integer\",\"null\"],\"description\":\"The marketplace status code for the creator&#39;s pricing, when available.\"},\"pictureState\":{\"type\":[\"integer\",\"null\"],\"description\":\"The marketplace status code for the creator&#39;s image and text offering, when available.\"},\"picturePrice\":{\"type\":[\"number\",\"null\"],\"description\":\"The marketplace quote for the creator&#39;s image and text offering, when available.\"},\"videoState\":{\"type\":[\"integer\",\"null\"],\"description\":\"The marketplace status code for the creator&#39;s video offering, when available.\"},\"videoPrice\":{\"type\":[\"number\",\"null\"],\"description\":\"The marketplace quote for the creator&#39;s video offering, when available.\"},\"userType\":{\"type\":\"integer\",\"description\":\"The creator account type code reported by the marketplace.\"},\"operateState\":{\"type\":[\"integer\",\"null\"],\"description\":\"The creator&#39;s marketplace operating status code, when available.\"},\"currentLevel\":{\"type\":[\"integer\",\"null\"],\"description\":\"The creator level code reported by the marketplace, when available.\"},\"location\":{\"type\":\"string\",\"description\":\"The creator location label shown in the marketplace.\"},\"contentTags\":{\"type\":\"array\",\"description\":\"Content categories assigned to the creator.\",\"items\":{\"type\":\"object\",\"description\":\"A creator content category and its subcategories.\",\"properties\":{\"taxonomy1Tag\":{\"type\":\"string\",\"description\":\"The top-level content category label.\"},\"taxonomy2Tags\":{\"type\":\"array\",\"description\":\"The subcategory labels under the top-level category.\",\"items\":{\"type\":\"string\",\"description\":\"A content subcategory label.\"}}}}},\"featureTags\":{\"type\":[\"array\",\"null\"],\"description\":\"Creator feature tags, when available. The array can be empty.\"},\"personalTags\":{\"type\":[\"array\",\"null\"],\"description\":\"Creator profile tags, when available.\",\"items\":{\"type\":\"string\",\"description\":\"A creator profile tag.\"}},\"gender\":{\"type\":\"string\",\"description\":\"The gender label reported in the creator profile.\"},\"isCollect\":{\"type\":\"boolean\",\"description\":\"Whether Pugongying marks the creator as saved.\"},\"clickMidNum\":{\"type\":\"integer\",\"description\":\"The creator-level click median reported by the marketplace.\"},\"interMidNum\":{\"type\":\"integer\",\"description\":\"The creator-level interaction median reported by the marketplace.\"},\"kolType\":{\"type\":[\"integer\",\"null\"],\"description\":\"The creator category code used by the marketplace, when available.\"},\"mengagementNum\":{\"type\":\"integer\",\"description\":\"A creator engagement metric reported by the marketplace.\"},\"mEngagementNum\":{\"type\":\"integer\",\"description\":\"The creator engagement median reported by the marketplace.\"}}},\"goodCaseCollect\":{\"type\":\"boolean\",\"description\":\"Whether the marketplace marks the note as saved in its example collection.\"}}}}},\"allOf\":[{\"type\":\"object\",\"properties\":{\"code\":{\"type\":\"integer\",\"format\":\"int32\",\"enum\":[0,100,101,202,300,301,302,303,400,404,500,503,600,601,602]},\"message\":{\"type\":[\"string\",\"null\"]},\"data\":{},\"recordTime\":{\"type\":[\"string\",\"null\"]},\"requestId\":{\"type\":\"string\"},\"reason\":{\"type\":\"string\"},\"requestParams\":{\"type\":\"object\",\"properties\":{\"query\":{\"type\":\"object\",\"additionalProperties\":{\"type\":\"object\"}},\"body\":{\"type\":\"object\",\"properties\":{\"empty\":{\"type\":\"boolean\"},\"array\":{\"type\":\"boolean\"},\"null\":{\"type\":\"boolean\"},\"object\":{\"type\":\"boolean\"},\"float\":{\"type\":\"boolean\"},\"container\":{\"type\":\"boolean\"},\"valueNode\":{\"type\":\"boolean\"},\"integralNumber\":{\"type\":\"boolean\"},\"floatingPointNumber\":{\"type\":\"boolean\"},\"missingNode\":{\"type\":\"boolean\"},\"boolean\":{\"type\":\"boolean\"},\"binary\":{\"type\":\"boolean\"},\"nodeType\":{\"type\":\"string\",\"enum\":[\"ARRAY\",\"BINARY\",\"BOOLEAN\",\"MISSING\",\"NULL\",\"NUMBER\",\"OBJECT\",\"POJO\",\"STRING\"]},\"string\":{\"type\":\"boolean\"},\"pojo\":{\"type\":\"boolean\"},\"short\":{\"type\":\"boolean\"},\"int\":{\"type\":\"boolean\"},\"long\":{\"type\":\"boolean\"},\"double\":{\"type\":\"boolean\"},\"bigDecimal\":{\"type\":\"boolean\"},\"bigInteger\":{\"type\":\"boolean\"},\"textual\":{\"type\":\"boolean\",\"deprecated\":true},\"number\":{\"type\":\"boolean\"},\"embeddedValue\":{\"type\":\"boolean\"}}}}}},\"required\":[\"code\",\"data\",\"message\",\"recordTime\"]}]}}}},\"400\":{\"description\":\"Invalid request parameters or body\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"code\":{\"type\":\"integer\",\"format\":\"int32\",\"enum\":[0,100,101,202,300,301,302,303,400,404,500,503,600,601,602]},\"message\":{\"type\":[\"string\",\"null\"]},\"data\":{},\"recordTime\":{\"type\":[\"string\",\"null\"]},\"requestId\":{\"type\":\"string\"},\"reason\":{\"type\":\"string\"},\"requestParams\":{\"type\":\"object\",\"properties\":{\"query\":{\"type\":\"object\",\"additionalProperties\":{\"type\":\"object\"}},\"body\":{\"type\":\"object\",\"properties\":{\"empty\":{\"type\":\"boolean\"},\"array\":{\"type\":\"boolean\"},\"null\":{\"type\":\"boolean\"},\"object\":{\"type\":\"boolean\"},\"float\":{\"type\":\"boolean\"},\"container\":{\"type\":\"boolean\"},\"valueNode\":{\"type\":\"boolean\"},\"integralNumber\":{\"type\":\"boolean\"},\"floatingPointNumber\":{\"type\":\"boolean\"},\"missingNode\":{\"type\":\"boolean\"},\"boolean\":{\"type\":\"boolean\"},\"binary\":{\"type\":\"boolean\"},\"nodeType\":{\"type\":\"string\",\"enum\":[\"ARRAY\",\"BINARY\",\"BOOLEAN\",\"MISSING\",\"NULL\",\"NUMBER\",\"OBJECT\",\"POJO\",\"STRING\"]},\"string\":{\"type\":\"boolean\"},\"pojo\":{\"type\":\"boolean\"},\"short\":{\"type\":\"boolean\"},\"int\":{\"type\":\"boolean\"},\"long\":{\"type\":\"boolean\"},\"double\":{\"type\":\"boolean\"},\"bigDecimal\":{\"type\":\"boolean\"},\"bigInteger\":{\"type\":\"boolean\"},\"textual\":{\"type\":\"boolean\",\"deprecated\":true},\"number\":{\"type\":\"boolean\"},\"embeddedValue\":{\"type\":\"boolean\"}}}}}},\"required\":[\"code\",\"data\",\"message\",\"recordTime\"]}}}},\"401\":{\"description\":\"Invalid or inactive access token\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"code\":{\"type\":\"integer\",\"format\":\"int32\",\"enum\":[0,100,101,202,300,301,302,303,400,404,500,503,600,601,602]},\"message\":{\"type\":[\"string\",\"null\"]},\"data\":{},\"recordTime\":{\"type\":[\"string\",\"null\"]},\"requestId\":{\"type\":\"string\"},\"reason\":{\"type\":\"string\"},\"requestParams\":{\"type\":\"object\",\"properties\":{\"query\":{\"type\":\"object\",\"additionalProperties\":{\"type\":\"object\"}},\"body\":{\"type\":\"object\",\"properties\":{\"empty\":{\"type\":\"boolean\"},\"array\":{\"type\":\"boolean\"},\"null\":{\"type\":\"boolean\"},\"object\":{\"type\":\"boolean\"},\"float\":{\"type\":\"boolean\"},\"container\":{\"type\":\"boolean\"},\"valueNode\":{\"type\":\"boolean\"},\"integralNumber\":{\"type\":\"boolean\"},\"floatingPointNumber\":{\"type\":\"boolean\"},\"missingNode\":{\"type\":\"boolean\"},\"boolean\":{\"type\":\"boolean\"},\"binary\":{\"type\":\"boolean\"},\"nodeType\":{\"type\":\"string\",\"enum\":[\"ARRAY\",\"BINARY\",\"BOOLEAN\",\"MISSING\",\"NULL\",\"NUMBER\",\"OBJECT\",\"POJO\",\"STRING\"]},\"string\":{\"type\":\"boolean\"},\"pojo\":{\"type\":\"boolean\"},\"short\":{\"type\":\"boolean\"},\"int\":{\"type\":\"boolean\"},\"long\":{\"type\":\"boolean\"},\"double\":{\"type\":\"boolean\"},\"bigDecimal\":{\"type\":\"boolean\"},\"bigInteger\":{\"type\":\"boolean\"},\"textual\":{\"type\":\"boolean\",\"deprecated\":true},\"number\":{\"type\":\"boolean\"},\"embeddedValue\":{\"type\":\"boolean\"}}}}}},\"required\":[\"code\",\"data\",\"message\",\"recordTime\"]}}}},\"403\":{\"description\":\"Permission denied\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"code\":{\"type\":\"integer\",\"format\":\"int32\",\"enum\":[0,100,101,202,300,301,302,303,400,404,500,503,600,601,602]},\"message\":{\"type\":[\"string\",\"null\"]},\"data\":{},\"recordTime\":{\"type\":[\"string\",\"null\"]},\"requestId\":{\"type\":\"string\"},\"reason\":{\"type\":\"string\"},\"requestParams\":{\"type\":\"object\",\"properties\":{\"query\":{\"type\":\"object\",\"additionalProperties\":{\"type\":\"object\"}},\"body\":{\"type\":\"object\",\"properties\":{\"empty\":{\"type\":\"boolean\"},\"array\":{\"type\":\"boolean\"},\"null\":{\"type\":\"boolean\"},\"object\":{\"type\":\"boolean\"},\"float\":{\"type\":\"boolean\"},\"container\":{\"type\":\"boolean\"},\"valueNode\":{\"type\":\"boolean\"},\"integralNumber\":{\"type\":\"boolean\"},\"floatingPointNumber\":{\"type\":\"boolean\"},\"missingNode\":{\"type\":\"boolean\"},\"boolean\":{\"type\":\"boolean\"},\"binary\":{\"type\":\"boolean\"},\"nodeType\":{\"type\":\"string\",\"enum\":[\"ARRAY\",\"BINARY\",\"BOOLEAN\",\"MISSING\",\"NULL\",\"NUMBER\",\"OBJECT\",\"POJO\",\"STRING\"]},\"string\":{\"type\":\"boolean\"},\"pojo\":{\"type\":\"boolean\"},\"short\":{\"type\":\"boolean\"},\"int\":{\"type\":\"boolean\"},\"long\":{\"type\":\"boolean\"},\"double\":{\"type\":\"boolean\"},\"bigDecimal\":{\"type\":\"boolean\"},\"bigInteger\":{\"type\":\"boolean\"},\"textual\":{\"type\":\"boolean\",\"deprecated\":true},\"number\":{\"type\":\"boolean\"},\"embeddedValue\":{\"type\":\"boolean\"}}}}}},\"required\":[\"code\",\"data\",\"message\",\"recordTime\"]}}}},\"429\":{\"description\":\"Request rate or daily quota limit exceeded\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"code\":{\"type\":\"integer\",\"format\":\"int32\",\"enum\":[0,100,101,202,300,301,302,303,400,404,500,503,600,601,602]},\"message\":{\"type\":[\"string\",\"null\"]},\"data\":{},\"recordTime\":{\"type\":[\"string\",\"null\"]},\"requestId\":{\"type\":\"string\"},\"reason\":{\"type\":\"string\"},\"requestParams\":{\"type\":\"object\",\"properties\":{\"query\":{\"type\":\"object\",\"additionalProperties\":{\"type\":\"object\"}},\"body\":{\"type\":\"object\",\"properties\":{\"empty\":{\"type\":\"boolean\"},\"array\":{\"type\":\"boolean\"},\"null\":{\"type\":\"boolean\"},\"object\":{\"type\":\"boolean\"},\"float\":{\"type\":\"boolean\"},\"container\":{\"type\":\"boolean\"},\"valueNode\":{\"type\":\"boolean\"},\"integralNumber\":{\"type\":\"boolean\"},\"floatingPointNumber\":{\"type\":\"boolean\"},\"missingNode\":{\"type\":\"boolean\"},\"boolean\":{\"type\":\"boolean\"},\"binary\":{\"type\":\"boolean\"},\"nodeType\":{\"type\":\"string\",\"enum\":[\"ARRAY\",\"BINARY\",\"BOOLEAN\",\"MISSING\",\"NULL\",\"NUMBER\",\"OBJECT\",\"POJO\",\"STRING\"]},\"string\":{\"type\":\"boolean\"},\"pojo\":{\"type\":\"boolean\"},\"short\":{\"type\":\"boolean\"},\"int\":{\"type\":\"boolean\"},\"long\":{\"type\":\"boolean\"},\"double\":{\"type\":\"boolean\"},\"bigDecimal\":{\"type\":\"boolean\"},\"bigInteger\":{\"type\":\"boolean\"},\"textual\":{\"type\":\"boolean\",\"deprecated\":true},\"number\":{\"type\":\"boolean\"},\"embeddedValue\":{\"type\":\"boolean\"}}}}}},\"required\":[\"code\",\"data\",\"message\",\"recordTime\"]}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"code\":{\"type\":\"integer\",\"format\":\"int32\",\"enum\":[0,100,101,202,300,301,302,303,400,404,500,503,600,601,602]},\"message\":{\"type\":[\"string\",\"null\"]},\"data\":{},\"recordTime\":{\"type\":[\"string\",\"null\"]},\"requestId\":{\"type\":\"string\"},\"reason\":{\"type\":\"string\"},\"requestParams\":{\"type\":\"object\",\"properties\":{\"query\":{\"type\":\"object\",\"additionalProperties\":{\"type\":\"object\"}},\"body\":{\"type\":\"object\",\"properties\":{\"empty\":{\"type\":\"boolean\"},\"array\":{\"type\":\"boolean\"},\"null\":{\"type\":\"boolean\"},\"object\":{\"type\":\"boolean\"},\"float\":{\"type\":\"boolean\"},\"container\":{\"type\":\"boolean\"},\"valueNode\":{\"type\":\"boolean\"},\"integralNumber\":{\"type\":\"boolean\"},\"floatingPointNumber\":{\"type\":\"boolean\"},\"missingNode\":{\"type\":\"boolean\"},\"boolean\":{\"type\":\"boolean\"},\"binary\":{\"type\":\"boolean\"},\"nodeType\":{\"type\":\"string\",\"enum\":[\"ARRAY\",\"BINARY\",\"BOOLEAN\",\"MISSING\",\"NULL\",\"NUMBER\",\"OBJECT\",\"POJO\",\"STRING\"]},\"string\":{\"type\":\"boolean\"},\"pojo\":{\"type\":\"boolean\"},\"short\":{\"type\":\"boolean\"},\"int\":{\"type\":\"boolean\"},\"long\":{\"type\":\"boolean\"},\"double\":{\"type\":\"boolean\"},\"bigDecimal\":{\"type\":\"boolean\"},\"bigInteger\":{\"type\":\"boolean\"},\"textual\":{\"type\":\"boolean\",\"deprecated\":true},\"number\":{\"type\":\"boolean\"},\"embeddedValue\":{\"type\":\"boolean\"}}}}}},\"required\":[\"code\",\"data\",\"message\",\"recordTime\"]}}}},\"503\":{\"description\":\"Service temporarily unavailable\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"code\":{\"type\":\"integer\",\"format\":\"int32\",\"enum\":[0,100,101,202,300,301,302,303,400,404,500,503,600,601,602]},\"message\":{\"type\":[\"string\",\"null\"]},\"data\":{},\"recordTime\":{\"type\":[\"string\",\"null\"]},\"requestId\":{\"type\":\"string\"},\"reason\":{\"type\":\"string\"},\"requestParams\":{\"type\":\"object\",\"properties\":{\"query\":{\"type\":\"object\",\"additionalProperties\":{\"type\":\"object\"}},\"body\":{\"type\":\"object\",\"properties\":{\"empty\":{\"type\":\"boolean\"},\"array\":{\"type\":\"boolean\"},\"null\":{\"type\":\"boolean\"},\"object\":{\"type\":\"boolean\"},\"float\":{\"type\":\"boolean\"},\"container\":{\"type\":\"boolean\"},\"valueNode\":{\"type\":\"boolean\"},\"integralNumber\":{\"type\":\"boolean\"},\"floatingPointNumber\":{\"type\":\"boolean\"},\"missingNode\":{\"type\":\"boolean\"},\"boolean\":{\"type\":\"boolean\"},\"binary\":{\"type\":\"boolean\"},\"nodeType\":{\"type\":\"string\",\"enum\":[\"ARRAY\",\"BINARY\",\"BOOLEAN\",\"MISSING\",\"NULL\",\"NUMBER\",\"OBJECT\",\"POJO\",\"STRING\"]},\"string\":{\"type\":\"boolean\"},\"pojo\":{\"type\":\"boolean\"},\"short\":{\"type\":\"boolean\"},\"int\":{\"type\":\"boolean\"},\"long\":{\"type\":\"boolean\"},\"double\":{\"type\":\"boolean\"},\"bigDecimal\":{\"type\":\"boolean\"},\"bigInteger\":{\"type\":\"boolean\"},\"textual\":{\"type\":\"boolean\",\"deprecated\":true},\"number\":{\"type\":\"boolean\"},\"embeddedValue\":{\"type\":\"boolean\"}}}}}},\"required\":[\"code\",\"data\",\"message\",\"recordTime\"]}}}}}")'
  :servers='JSON.parse("[{\"url\":\"https://api.justoneapi.com\",\"description\":\"Global production API (default)\"}]")'
  :security='JSON.parse("[]")'
  :securitySchemes='JSON.parse("{}")'
  :schemas='JSON.parse("{}")'
/>

<ApiHealthSection :api='JSON.parse("\"/api/xiaohongshu-pgy/api/solar/note/noteId/detail/v1\"")' />

<p>Retrieves Xiaohongshu Pugongying details for a known note ID. Use it to review an individual note during creator or campaign research.</p>

## Highlights

::: tip Capability
<p>This endpoint can retrieve note view counts.</p>
:::

::: tip Condition
<p>Engagement metrics may be unavailable for some notes.</p>
:::

## Parameters

<div class="api-doc-table api-doc-table--params">

| Name | In | Type | Required | Default | Description |
| --- | --- | --- | --- | --- | --- |
| <code>token</code> | query | <code>string</code> | Yes | - | User authentication token. |
| <code>noteId</code> | query | <code>string</code> | Yes | - | Note's unique ID. |

</div>

## Code Samples

::: code-group

```bash [🐚 cURL]
curl --max-time 120 -X GET 'https://api.justoneapi.com/api/xiaohongshu-pgy/api/solar/note/noteId/detail/v1?token=YOUR_API_KEY&noteId=VALUE'
```

```text [🤖 AI Prompt]
I want to use the "Note Details (V1)" API from JustOneAPI.
Base URL: https://api.justoneapi.com.
API Path: /api/xiaohongshu-pgy/api/solar/note/noteId/detail/v1?token=YOUR_API_KEY&noteId=VALUE
API Endpoint: BASE_URL + /api/xiaohongshu-pgy/api/solar/note/noteId/detail/v1?token=YOUR_API_KEY&noteId=VALUE
HTTP Method: GET
Authentication: Append the "token" query parameter to the URL.
OpenAPI Definition: https://docs.justoneapi.com/openapi/xiaohongshu-creator-marketplace-pugongying/note-details-v1-en.json

Parameters:
- token (query): User authentication token. (Required)
- noteId (query): Note's unique ID. (Required)

Return format: safely handle JSON or text according to the actual Content-Type.

Response Handling & Error Codes:
1. Business results should be determined by the "code" field in the response body (code 0 means success).
2. Timeout Recommendation: Set the request timeout to 120 seconds. If 120 seconds is too long for your use case, use at least 60 seconds, but a small number of requests may time out before receiving a result.
3. Business Code Reference:
   - 0: Success
   - 100: Invalid or Inactive Token
   - 301: Collection Failed. Please Retry.
   - 302: Rate Limit Exceeded
   - 303: Daily Quota Exceeded
   - 400: Invalid Parameters
   - 500: Internal Server Error
   - 600: Permission Denied
   - 601: Insufficient Balance
   - 602: Token Budget Exceeded
4. Code 601 means the shared account balance is insufficient. Code 602 means the current API token's own cumulative budget limit has been reached. Token budget limits do not transfer funds out of the shared account balance.

Please help me write a script in my preferred programming language to call this API and handle the response.
```

```python [🐍 Python]
import requests

BASE_URL = "https://api.justoneapi.com"  # Provided by OpenAPI servers

url = BASE_URL + "/api/xiaohongshu-pgy/api/solar/note/noteId/detail/v1?token=YOUR_API_KEY&noteId=VALUE"
response = requests.get(url, timeout=120)
print(response.status_code)
if response.content:
    content_type = response.headers.get("content-type", "").lower()
    if "json" in content_type:
        try:
            print(response.json())
        except ValueError:
            print(response.text)
    elif content_type.startswith("text/") or "xml" in content_type or content_type.split(";", 1)[0].strip() in {"application/javascript", "application/x-www-form-urlencoded", "application/graphql"}:
        print(response.text)
    else:
        with open("response.bin", "wb") as output:
            output.write(response.content)
        print(f"Saved {len(response.content)} bytes to response.bin")
```

```js [🌐 JavaScript]
const BASE_URL = "https://api.justoneapi.com"; // Provided by OpenAPI servers
const url = BASE_URL + "/api/xiaohongshu-pgy/api/solar/note/noteId/detail/v1?token=YOUR_API_KEY&noteId=VALUE";

const response = await fetch(url, {
  method: "GET",
  signal: AbortSignal.timeout(120000)
});
console.log(response.status);
const responseBytes = await response.arrayBuffer();
if (responseBytes.byteLength) {
  const contentType = (response.headers.get("content-type") || "").toLowerCase();
  const mediaType = contentType.split(";", 1)[0].trim();
  const textual = contentType.startsWith("text/") || contentType.includes("json") || contentType.includes("xml") || ["application/javascript", "application/x-www-form-urlencoded", "application/graphql"].includes(mediaType);
  if (textual) {
    const responseText = new TextDecoder().decode(responseBytes);
    let data = responseText;
    if (contentType.includes("json")) {
      try { data = JSON.parse(responseText); } catch { /* Keep the raw body. */ }
    }
    console.log(data);
  } else {
    console.log(`Received ${responseBytes.byteLength} binary bytes`);
  }
}
```

```java [☕ Java]
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.time.Duration;
import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.nio.file.Path;

public class Main {
    public static void main(String[] args) throws Exception {
        final String BASE_URL = "https://api.justoneapi.com"; // Provided by OpenAPI servers
        final String url = BASE_URL + "/api/xiaohongshu-pgy/api/solar/note/noteId/detail/v1?token=YOUR_API_KEY&noteId=VALUE";

        HttpClient client = HttpClient.newBuilder().connectTimeout(Duration.ofSeconds(120)).build();
        HttpRequest.Builder builder = HttpRequest.newBuilder()
            .uri(URI.create(url))
            .timeout(Duration.ofSeconds(120))
            .method("GET", HttpRequest.BodyPublishers.noBody());

        HttpRequest request = builder.build();

        HttpResponse<byte[]> response = client.send(request, HttpResponse.BodyHandlers.ofByteArray());
        System.out.println(response.statusCode());
        String contentType = response.headers().firstValue("content-type").orElse("").toLowerCase();
        String mediaType = contentType.split(";", 2)[0].trim();
        if (contentType.startsWith("text/") || contentType.contains("json") || contentType.contains("xml") || mediaType.equals("application/javascript") || mediaType.equals("application/x-www-form-urlencoded") || mediaType.equals("application/graphql")) {
            System.out.println(new String(response.body(), StandardCharsets.UTF_8));
        } else {
            Files.write(Path.of("response.bin"), response.body());
            System.out.println("Saved " + response.body().length + " bytes to response.bin");
        }
    }
}
```

```go [🐹 Go]
package main

import (
	"fmt"
	"io"
	"os"
	"strings"
	"net/http"
	"time"
)

const BASE_URL = "https://api.justoneapi.com" // Provided by OpenAPI servers

func main() {
	client := &http.Client{Timeout: 120 * time.Second}
	url := BASE_URL + "/api/xiaohongshu-pgy/api/solar/note/noteId/detail/v1?token=YOUR_API_KEY&noteId=VALUE"
	req, _ := http.NewRequest("GET", url, nil)
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	fmt.Println(resp.StatusCode)
	bodyBytes, _ := io.ReadAll(resp.Body)
	contentType := strings.ToLower(resp.Header.Get("Content-Type"))
	mediaType := strings.TrimSpace(strings.SplitN(contentType, ";", 2)[0])
	if strings.HasPrefix(contentType, "text/") || strings.Contains(contentType, "json") || strings.Contains(contentType, "xml") || mediaType == "application/javascript" || mediaType == "application/x-www-form-urlencoded" || mediaType == "application/graphql" {
		fmt.Println(string(bodyBytes))
	} else {
		os.WriteFile("response.bin", bodyBytes, 0600)
		fmt.Printf("Saved %d bytes to response.bin\n", len(bodyBytes))
	}
}
```

```php [🐘 PHP]
<?php
$BASE_URL = 'https://api.justoneapi.com'; // Provided by OpenAPI servers
$url = $BASE_URL . '/api/xiaohongshu-pgy/api/solar/note/noteId/detail/v1?token=YOUR_API_KEY&noteId=VALUE';

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 120);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
$contentType = strtolower((string) curl_getinfo($ch, CURLINFO_CONTENT_TYPE));
curl_close($ch);
echo $status . PHP_EOL;
$mediaType = trim(explode(';', $contentType, 2)[0]);
if (str_starts_with($contentType, 'text/') || str_contains($contentType, 'json') || str_contains($contentType, 'xml') || in_array($mediaType, ['application/javascript', 'application/x-www-form-urlencoded', 'application/graphql'], true)) {
    echo $response;
} else {
    file_put_contents('response.bin', $response);
    echo 'Saved ' . strlen($response) . ' bytes to response.bin' . PHP_EOL;
}
```

:::

<div style="text-align: right; margin-top: -20px; margin-bottom: 20px;">
<a href="/openapi/xiaohongshu-creator-marketplace-pugongying/note-details-v1-en.json" target="_blank" style="font-size: 12px; color: var(--vp-c-text-3); text-decoration: none; opacity: 0.8;">[OpenAPI Definition (JSON)]</a>
</div>

## Response Fields

Key fields in a successful response (`code = 0`).

<div class="api-doc-table api-doc-table--response">

| Field path | Type | Description |
| --- | --- | --- |
| <code>data</code> | - | The fields returned when the response contains a single Pugongying note object. |
| <code>data.noteId</code> | <code>string</code> | The unique Xiaohongshu note ID. |
| <code>data.noteLink</code> | <code>string</code> | The Xiaohongshu link to the note, including any platform access parameters returned with it. |
| <code>data.userId</code> | <code>string</code> | The Xiaohongshu user ID of the note author. |
| <code>data.headPhoto</code> | <code>string &#124; null</code> | The note author's avatar URL, when available. |
| <code>data.name</code> | <code>string &#124; null</code> | The note author's display name, when available. |
| <code>data.type</code> | <code>integer</code> | The note type code. Observed codes are 1 for image and text and 2 for video. |
| <code>data.title</code> | <code>string</code> | The note title, which may be empty. |
| <code>data.content</code> | <code>string</code> | The note text, including mentions or topic markup when present. |
| <code>data.imagesList</code> | <code>array</code> | Images associated with the note, including a cover image when present. |
| <code>data.imagesList[]</code> | <code>object</code> | An image associated with the note. |
| <code>data.imagesList[].fileId</code> | <code>string</code> | The platform file ID of this image. |
| <code>data.imagesList[].url</code> | <code>string</code> | The image URL returned for display. |
| <code>data.imagesList[].original</code> | <code>string</code> | The original image URL provided by the platform. |
| <code>data.imagesList[].width</code> | <code>integer</code> | The image width reported by the platform, in pixels. |
| <code>data.imagesList[].height</code> | <code>integer</code> | The image height reported by the platform, in pixels. |
| <code>data.imagesList[].traceId</code> | <code>string</code> | The platform trace identifier attached to the image. |
| <code>data.imagesList[].imageExtraInfo</code> | <code>object &#124; null</code> | Additional image metadata, when available. |
| <code>data.imagesList[].imageExtraInfo.imageMetadata</code> | <code>string</code> | Image metadata returned by the platform as a string. |
| <code>data.videoInfo</code> | <code>object &#124; null</code> | Video information when available. Image and text notes may return null. |
| <code>data.videoInfo.id</code> | <code>string</code> | The ID of the video record. |
| <code>data.videoInfo.videoKey</code> | <code>string</code> | The platform storage key for the video. |
| <code>data.videoInfo.originVideoKey</code> | <code>string</code> | The platform storage key for the source video. |
| <code>data.videoInfo.meta</code> | <code>object</code> | Metadata for the video asset. |
| <code>data.videoInfo.meta.width</code> | <code>integer</code> | Video width reported by the platform, in pixels. |
| <code>data.videoInfo.meta.height</code> | <code>integer</code> | Video height reported by the platform, in pixels. |
| <code>data.videoInfo.meta.duration</code> | <code>integer</code> | The video duration in whole seconds as reported by the platform. |
| <code>data.videoInfo.meta.videoId</code> | <code>string</code> | Video identifier in the asset metadata. |
| <code>data.videoInfo.gifKey</code> | <code>string</code> | The platform storage key for the GIF preview, when available. |
| <code>data.videoInfo.videoUrl</code> | <code>string</code> | The video URL supplied by the platform. It can be empty. |
| <code>data.videoInfo.gifUrl</code> | <code>string</code> | The URL of the GIF preview, when available. |
| <code>data.videoInfo.videoKeyList</code> | <code>array</code> | Additional video asset keys when returned. The array can be empty. |
| <code>data.videoInfo.hasFragments</code> | <code>boolean</code> | Whether the platform indicates that the video has fragments. |
| <code>data.videoInfo.thumbnail</code> | <code>string</code> | The video thumbnail URL supplied by the platform. |
| <code>data.videoInfo.firstFrame</code> | <code>string &#124; null</code> | The first-frame image reference, when available. |
| <code>data.videoInfo.volume</code> | <code>number</code> | The volume value reported for the video. |
| <code>data.videoInfo.chapters</code> | <code>array &#124; null</code> | Chapter markers, when available. |
| <code>data.videoInfo.chapters[]</code> | <code>object</code> | A video chapter marker. |
| <code>data.videoInfo.chapters[].text</code> | <code>string</code> | The chapter label. |
| <code>data.videoInfo.chapters[].time</code> | <code>integer</code> | The chapter start offset from the beginning of the video, in milliseconds. |
| <code>data.time</code> | <code>object</code> | Timestamps associated with the note. |
| <code>data.time.createTime</code> | <code>integer</code> | The note creation time as a Unix timestamp in milliseconds. |
| <code>data.time.updateTime</code> | <code>integer</code> | The note update time as a Unix timestamp in milliseconds. |
| <code>data.time.userUpdateTime</code> | <code>integer</code> | The user update time field supplied with the note, as a Unix timestamp in milliseconds. |
| <code>data.createTime</code> | <code>string</code> | The note creation time formatted for display in China Standard Time. |
| <code>data.impNum</code> | <code>integer</code> | The note impression count reported by Pugongying. |
| <code>data.likeNum</code> | <code>integer</code> | The note like count reported by Pugongying. |
| <code>data.favNum</code> | <code>integer</code> | The note favorite count reported by Pugongying. |
| <code>data.cmtNum</code> | <code>integer</code> | The note comment count reported by Pugongying. |
| <code>data.readNum</code> | <code>integer</code> | The note read count reported by Pugongying. Metric availability can vary by note. |
| <code>data.shareNum</code> | <code>integer</code> | The note share count reported by Pugongying. |
| <code>data.followCnt</code> | <code>integer</code> | The follow count reported alongside the note's metrics. The attribution window is unspecified. |
| <code>data.userInfo</code> | <code>object</code> | Author details from the creator marketplace. |
| <code>data.userInfo.nickName</code> | <code>string</code> | The creator's display name in the marketplace. |
| <code>data.userInfo.avatar</code> | <code>string</code> | The creator's avatar URL. |
| <code>data.userInfo.userId</code> | <code>string</code> | The creator's Xiaohongshu user ID. |
| <code>data.userInfo.fansNum</code> | <code>integer</code> | The creator's follower count reported by the marketplace. |
| <code>data.userInfo.cooperType</code> | <code>integer</code> | The marketplace cooperation type code for the creator. |
| <code>data.userInfo.priceState</code> | <code>integer &#124; null</code> | The marketplace status code for the creator's pricing, when available. |
| <code>data.userInfo.pictureState</code> | <code>integer &#124; null</code> | The marketplace status code for the creator's image and text offering, when available. |
| <code>data.userInfo.picturePrice</code> | <code>number &#124; null</code> | The marketplace quote for the creator's image and text offering, when available. |
| <code>data.userInfo.videoState</code> | <code>integer &#124; null</code> | The marketplace status code for the creator's video offering, when available. |
| <code>data.userInfo.videoPrice</code> | <code>number &#124; null</code> | The marketplace quote for the creator's video offering, when available. |
| <code>data.userInfo.userType</code> | <code>integer</code> | The creator account type code reported by the marketplace. |
| <code>data.userInfo.operateState</code> | <code>integer &#124; null</code> | The creator's marketplace operating status code, when available. |
| <code>data.userInfo.currentLevel</code> | <code>integer &#124; null</code> | The creator level code reported by the marketplace, when available. |
| <code>data.userInfo.location</code> | <code>string</code> | The creator location label shown in the marketplace. |
| <code>data.userInfo.contentTags</code> | <code>array</code> | Content categories assigned to the creator. |
| <code>data.userInfo.contentTags[]</code> | <code>object</code> | A creator content category and its subcategories. |
| <code>data.userInfo.contentTags[].taxonomy1Tag</code> | <code>string</code> | The top-level content category label. |
| <code>data.userInfo.contentTags[].taxonomy2Tags</code> | <code>array</code> | The subcategory labels under the top-level category. |
| <code>data.userInfo.contentTags[].taxonomy2Tags[]</code> | <code>string</code> | A content subcategory label. |
| <code>data.userInfo.featureTags</code> | <code>array &#124; null</code> | Creator feature tags, when available. The array can be empty. |
| <code>data.userInfo.personalTags</code> | <code>array &#124; null</code> | Creator profile tags, when available. |
| <code>data.userInfo.personalTags[]</code> | <code>string</code> | A creator profile tag. |
| <code>data.userInfo.gender</code> | <code>string</code> | The gender label reported in the creator profile. |
| <code>data.userInfo.isCollect</code> | <code>boolean</code> | Whether Pugongying marks the creator as saved. |
| <code>data.userInfo.clickMidNum</code> | <code>integer</code> | The creator-level click median reported by the marketplace. |
| <code>data.userInfo.interMidNum</code> | <code>integer</code> | The creator-level interaction median reported by the marketplace. |
| <code>data.userInfo.kolType</code> | <code>integer &#124; null</code> | The creator category code used by the marketplace, when available. |
| <code>data.userInfo.mengagementNum</code> | <code>integer</code> | A creator engagement metric reported by the marketplace. |
| <code>data.userInfo.mEngagementNum</code> | <code>integer</code> | The creator engagement median reported by the marketplace. |
| <code>data.goodCaseCollect</code> | <code>boolean</code> | Whether the marketplace marks the note as saved in its example collection. |

</div>

## Response Example

<ApiExampleSection :api='JSON.parse("\"/api/xiaohongshu-pgy/api/solar/note/noteId/detail/v1\"")' />

