Get Cycle Scores
curl --request GET \
--url https://dcinside-rtb-api.stg.kr.ask.surf/v1/scores/{cycle_id} \
--header 'Authorization: <api-key>'import requests
url = "https://dcinside-rtb-api.stg.kr.ask.surf/v1/scores/{cycle_id}"
headers = {"Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://dcinside-rtb-api.stg.kr.ask.surf/v1/scores/{cycle_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://dcinside-rtb-api.stg.kr.ask.surf/v1/scores/{cycle_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://dcinside-rtb-api.stg.kr.ask.surf/v1/scores/{cycle_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://dcinside-rtb-api.stg.kr.ask.surf/v1/scores/{cycle_id}")
.header("Authorization", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://dcinside-rtb-api.stg.kr.ask.surf/v1/scores/{cycle_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"cycle_id": "20260929T0205",
"cycle_time": "2026-09-29T02:05:00+09:00",
"received_at": "2026-09-29T02:05:03+09:00",
"scored_at": "2026-09-29T02:05:09+09:00",
"model_version": "m0924-weight0",
"weights_version": "w-1",
"counts": {
"candidates": 1,
"engagement": 2,
"candidate_scores": 1,
"removals": 1,
"scored_now": 2,
"waiting": 0,
"not_scored": 0,
"results": 2
},
"missing_feature_share": 0.11,
"warnings": [],
"results": [
{
"gall_id": "example_gallery",
"post_no": 31899120,
"status": "scored",
"score": 0.62,
"scored_at_cycle": "2026-09-29T02:05:00+09:00"
},
{
"gall_id": "example_gallery",
"post_no": 31900001,
"status": "scored",
"score": 0.51,
"scored_at_cycle": "2026-09-29T02:05:00+09:00"
}
]
}{
"error": {
"code": "unauthorized",
"message": "API key missing or unknown"
}
}{
"error": {
"code": "not_found",
"message": "no cycle 20260929T0205"
}
}{
"error": {
"code": "server_error",
"message": "internal error"
}
}Scoring API
Retrieve Cycle Scores
Recover the stored response for a specific cycle without scoring again
GET
/
v1
/
scores
/
{cycle_id}
Get Cycle Scores
curl --request GET \
--url https://dcinside-rtb-api.stg.kr.ask.surf/v1/scores/{cycle_id} \
--header 'Authorization: <api-key>'import requests
url = "https://dcinside-rtb-api.stg.kr.ask.surf/v1/scores/{cycle_id}"
headers = {"Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://dcinside-rtb-api.stg.kr.ask.surf/v1/scores/{cycle_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://dcinside-rtb-api.stg.kr.ask.surf/v1/scores/{cycle_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://dcinside-rtb-api.stg.kr.ask.surf/v1/scores/{cycle_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://dcinside-rtb-api.stg.kr.ask.surf/v1/scores/{cycle_id}")
.header("Authorization", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://dcinside-rtb-api.stg.kr.ask.surf/v1/scores/{cycle_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"cycle_id": "20260929T0205",
"cycle_time": "2026-09-29T02:05:00+09:00",
"received_at": "2026-09-29T02:05:03+09:00",
"scored_at": "2026-09-29T02:05:09+09:00",
"model_version": "m0924-weight0",
"weights_version": "w-1",
"counts": {
"candidates": 1,
"engagement": 2,
"candidate_scores": 1,
"removals": 1,
"scored_now": 2,
"waiting": 0,
"not_scored": 0,
"results": 2
},
"missing_feature_share": 0.11,
"warnings": [],
"results": [
{
"gall_id": "example_gallery",
"post_no": 31899120,
"status": "scored",
"score": 0.62,
"scored_at_cycle": "2026-09-29T02:05:00+09:00"
},
{
"gall_id": "example_gallery",
"post_no": 31900001,
"status": "scored",
"score": 0.51,
"scored_at_cycle": "2026-09-29T02:05:00+09:00"
}
]
}{
"error": {
"code": "unauthorized",
"message": "API key missing or unknown"
}
}{
"error": {
"code": "not_found",
"message": "no cycle 20260929T0205"
}
}{
"error": {
"code": "server_error",
"message": "internal error"
}
}Use this route after a lost response or to reconcile a cycle. It returns the stored result for that cycle and does not trigger scoring or an LLM call. The original deduplication report is returned unchanged, even if its status was
partial or unavailable and background checks have since completed. New verdicts can appear in a new cycle’s response; this route does not poll for updated deduplication results. Cycles completed before this extension may omit deduplication.
A historical response stays unchanged even if a later cycle refreshes the same post’s score or removes that post. Check cycle identity and scoring time before using any result. A successful retrieval does not make a late or stale response eligible for the current decision cycle.
A 404 means the requested final result is not available. The durable store preserves completed responses across process restarts. A request can have a recorded receipt or durable prepared scores while it is still waiting or after interruption, so a 404 is not proof that it was never received. Replay the unchanged request to complete it; an existing preparation is resumed without repeating ingestion or scoring. GET does not expose an unfinished preparation. Verify volume recovery before rehearsal. Keep unacknowledged data until it is reconciled.
The response example is the same proposed cycle result documented under Score a Cycle.Authorizations
Proposed API key sent as the whole Authorization header value. One long-lived key, handed privately to the partner contact and rotated on either side's request. Per-endpoint scopes are not currently enforced.
Path Parameters
The cycle id sent in the original call.
Pattern:
^\d{8}T\d{4}$Example:
"20260929T0205"
Response
The response stored for this cycle.
Echoed from the request.
Pattern:
^\d{8}T\d{4}$Example:
"20260929T0205"
Echoed from the request.
Pattern:
^\d{4}-\d{2}-\d{2}[Tt]\d{2}:\d{2}:\d{2}(?:\.\d+)?(?:[Zz]|[+-]\d{2}:\d{2})$Example:
"2026-09-29T02:05:00+09:00"
First valid receipt of this cycle ID, preserved across failed inference retries and completed replays.
Pattern:
^\d{4}-\d{2}-\d{2}[Tt]\d{2}:\d{2}:\d{2}(?:\.\d+)?(?:[Zz]|[+-]\d{2}:\d{2})$Example:
"2026-09-29T02:05:03+09:00"
Actual scoring completion time sampled after the full inference batch. Measure client receipt time separately.
Pattern:
^\d{4}-\d{2}-\d{2}[Tt]\d{2}:\d{2}:\d{2}(?:\.\d+)?(?:[Zz]|[+-]\d{2}:\d{2})$Example:
"2026-09-29T02:05:09+09:00"
Version reported by the actual loaded Model 0924 adapter and configured down-vote coefficient. No environment-only label override or proxy scorer is used.
Example:
"model0924-downvote0"
Weights that actually produced this cycle's scores. Verify that refreshed scores and their version match; do not relabel cached scores.
Example:
"w0924-downvote0"
Row counts for this cycle.
Show child attributes
Show child attributes
Fraction of missing request counter fields. This does not count missing values across the model feature set and is not a rehearsal acceptance metric.
Required range:
0 <= x <= 1Example:
0.11
Implementation warnings. Unknown fields are not guaranteed to be listed. An empty list does not prove model or data readiness.
Example:
[]
One result per pending candidate under the proposed refresh policy. Scores may change across new cycles; replay of a completed cycle is unchanged. Removed posts are absent from subsequent cycles.
Show child attributes
Show child attributes
Persisted LLM same-event rankings and honest unchecked coverage for main/light. Every raw score remains in results. Omitted for legacy completed cycles. Partial/unavailable completed reports remain immutable on POST replay and GET.
Show child attributes
Show child attributes