Get custom attributes

Article summary

Did you find this summary helpful?

Thank you for your feedback

Available in Classic and VPC

Get the profile details of created custom attributes.

You can check the progress of the profile you requested to create, the attribute keywords, the feature to be profiled, and the Object Storage bucket where the execution result file will be stored.

Request

This section describes the request format. The method and URI are as follows:

Method	URI
GET	/api/v1/profile/custom-attributes/{profile_id}

Request headers

For information about the headers common to all NCLUE APIs, see Common NCLUE headers.

Request path parameters

You can use the following path parameters with your request:

Field	Type	Required	Description
`profile_id`	String	Required	Profile ID Can be checked from the response body of Get custom attributes list

Request example

The request example is as follows:

curl --location --request GET 'https://nclue.apigw.ntruss.com/api/v1/profile/custom-attributes/{profile_id}' \
--header 'X-NCP-APIGW-TIMESTAMP: {Timestamp}' \
--header 'X-NCP-IAM-ACCESS-KEY: {Access Key}' \
--header 'X-NCP-APIGW-SIGNATURE-V2: {API Gateway Signature}'

Response

This section describes the response format.

Response body

The response body includes the following data:

Field	Type	Required	Description
`profile_id`	String	-	Profile ID
`profile_name`	String	-	Profile name of the custom attributes entered by the user
`feature_id`	String	-	Feature ID to be profiled, enter when creating custom attributes
`feature_name`	String	-	Feature name to profile
`keyword_set`	String	-	A list of attribute keywords entered by the user (keywords to check similarity with the target user)
`status`	String	-	Creation type `registered` \| `pending` \| `in_progress` \| `completed` \| `failed` `registered`: registered `pending`: pending `in_progress`: creating `completed`: available `failed`: failed
`created_at`	String	-	Custom attributes creation request date (ISO 8601 format)
`completed_at`	String	-	Custom attributes creation job completion date (ISO 8601 format)
`result_bucket`	String	-	Name of the Object Storage bucket to store custom attributes job results
`result_file_path`	String	-	File path to save the results in the result_bucket bucket
`line_count`	Integer	-	Number of lines of the feature used to create custom attributes
`fail_message`	String	-	Message upon creation failure. See Troubleshooting NCLUE

Response example

The response example is as follows:

Succeeded

The following is a sample response upon a successful call.

{
    "profile_id":"efc3f714-d267-44e2-a574-75497cc7712c",
    "profile_name":"Running profiling",
    "feature_id":"79eb85b5-8ec5-4e1a-8617-64a1977c8062",
    "feature_name":"Shopping behavior sequence - 2024",
    "keyword_set":"Running, run, marathon, jogging, running shoes, running socks, running app",
    "status":"completed",
    "created_at":"2024-11-05T11:42:53",
    "completed_at":"2024-11-05T11:43:41",
    "result_bucket":"your.bucket.name",
    "result_file_path":"running_profiling",
    "line_count": 1209478,
    "fail_message":null
}

Failure

For examples of responses in the event of a failed call, see Response status codes.

Was this article helpful?

What's Next

Get custom attributes list

Table of contents

Request
Response