API 요청
/rest/url_similarity요청 파라미터 2개 · 필수 2
url1- 예시
https://apick.app
url2- 예시
https://example.com
응답 필드 11개
datadata.styledata.structuraldata.totaldata.successdata.errorapiapi.successapi.costapi.msapi.pl_id입력한 두 사이트의 유사 여부를 판단합니다.
https://apick.app/rest/url_similarity왜 URL 유사도 비교인가
공식 사이트를 베낀 피싱 페이지는 눈으로 보면 구분이 어렵습니다. 두 URL을 넣으면 사이트가 서로 유사한지 판단해 사칭 페이지를 빠르게 가려냅니다.
두 웹 페이지 주소를 보내면 두 페이지의 디자인(스타일)과 HTML 구조가 얼마나 닮았는지 0~1 점수로 돌려줍니다. 공식 사이트를 흉내 낸 피싱 사이트 탐지, 복제 사이트 확인, 같은 템플릿을 쓰는 사이트 묶기에 씁니다.
비교에 성공하면 한 건당 5P가 차감됩니다. 두 페이지 중 하나라도 열지 못하거나 시간이 초과되면 data.error로 응답하며 과금되지 않습니다.
http·https로 시작하는 공개 인터넷 주소만 받습니다. 응답까지 길면 30초 이상 걸리므로 클라이언트 대기 시간은 60초 이상으로 두세요.
/rest/url_similarityurl1https://apick.appurl2https://example.comdatadata.styledata.structuraldata.totaldata.successdata.errorapiapi.successapi.costapi.msapi.pl_idPOST https://apick.app/rest/url_similarityAuthorization: Bearer — 내 계정의 API 인증키multipart/form-data상황별로 보내는 값과 응답에서 확인할 값을 모았습니다. 언어 탭에서 그대로 복사해 쓸 수 있습니다.
공식 사이트와 의심 사이트가 얼마나 닮았는지 확인합니다.
/rest/url_similaritycurl --fail-with-body --request POST 'https://apick.app/rest/url_similarity' \
--header "Authorization: Bearer $APICK_API_KEY" \
--form-string 'url1=https://apick.app' \
--form-string 'url2=https://example.com'const form = new FormData();
form.append("url1", "https://apick.app");
form.append("url2", "https://example.com");
const response = await fetch("https://apick.app/rest/url_similarity", {
method: "POST",
headers: { Authorization: "Bearer " + process.env.APICK_API_KEY },
body: form,
signal: AbortSignal.timeout(120_000),
});
if (!response.ok) throw new Error(`HTTP ${response.status}: ${await response.text()}`);
const result = await response.json();
console.log(result);import os
import requests
parts = [
("url1", (None, "https://apick.app")),
("url2", (None, "https://example.com")),
]
response = requests.request("POST", "https://apick.app/rest/url_similarity",
headers={"Authorization": "Bearer " + os.environ["APICK_API_KEY"]},
files=parts,
timeout=(10, 120))
response.raise_for_status()
result = response.json()
print(result)<?php
$headers = ["Authorization: Bearer " . getenv("APICK_API_KEY")];
$form = [
'url1' => 'https://apick.app',
'url2' => 'https://example.com',
];
$curl = curl_init('https://apick.app/rest/url_similarity');
curl_setopt_array($curl, [
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_HTTPHEADER => $headers,
CURLOPT_POSTFIELDS => $form,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CONNECTTIMEOUT => 10, CURLOPT_TIMEOUT => 120,
]);
$body = curl_exec($curl);
if ($body === false) { throw new RuntimeException(curl_error($curl)); }
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);
if ($status >= 400) { throw new RuntimeException($body); }
$result = json_decode($body, true, 512, JSON_THROW_ON_ERROR);
print_r($result);data.total이 서비스에서 정한 기준값(예: 0.8) 이상이면 복제·피싱 후보로 표시합니다.style은 디자인, structural은 HTML 구조의 유사도입니다.두 쇼핑몰이 같은 템플릿을 쓰는지 확인합니다.
/rest/url_similaritycurl --fail-with-body --request POST 'https://apick.app/rest/url_similarity' \
--header "Authorization: Bearer $APICK_API_KEY" \
--form-string 'url1=https://shop.example.com' \
--form-string 'url2=https://store.example.org'const form = new FormData();
form.append("url1", "https://shop.example.com");
form.append("url2", "https://store.example.org");
const response = await fetch("https://apick.app/rest/url_similarity", {
method: "POST",
headers: { Authorization: "Bearer " + process.env.APICK_API_KEY },
body: form,
signal: AbortSignal.timeout(120_000),
});
if (!response.ok) throw new Error(`HTTP ${response.status}: ${await response.text()}`);
const result = await response.json();
console.log(result);import os
import requests
parts = [
("url1", (None, "https://shop.example.com")),
("url2", (None, "https://store.example.org")),
]
response = requests.request("POST", "https://apick.app/rest/url_similarity",
headers={"Authorization": "Bearer " + os.environ["APICK_API_KEY"]},
files=parts,
timeout=(10, 120))
response.raise_for_status()
result = response.json()
print(result)<?php
$headers = ["Authorization: Bearer " . getenv("APICK_API_KEY")];
$form = [
'url1' => 'https://shop.example.com',
'url2' => 'https://store.example.org',
];
$curl = curl_init('https://apick.app/rest/url_similarity');
curl_setopt_array($curl, [
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_HTTPHEADER => $headers,
CURLOPT_POSTFIELDS => $form,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CONNECTTIMEOUT => 10, CURLOPT_TIMEOUT => 120,
]);
$body = curl_exec($curl);
if ($body === false) { throw new RuntimeException(curl_error($curl)); }
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);
if ($status >= 400) { throw new RuntimeException($body); }
$result = json_decode($body, true, 512, JSON_THROW_ON_ERROR);
print_r($result);structural이 높고 style이 낮으면 같은 틀에 디자인만 바꾼 사이트일 가능성이 큽니다.data.error로 실패하며 과금되지 않습니다.HTTP 성공과 업무 결과를 구분하세요. 경로별 응답 필드와 예시는 위 요청과 응답에 함께 있습니다.
{
"data": {
"style": 0,
"structural": 0.1896551724137931,
"total": 0.09482758620689655,
"success": 1
},
"api": { "success": true, "cost": 5, "ms": 4125, "pl_id": 99911 }
}
판단은 total로 하되, 서비스에 맞는 기준값은 직접 정하세요. 예를 들어 공식 사이트와 의심 사이트를 비교해 total이 0.8 이상이면 복제·피싱 후보로 표시하고 사람이 확인하는 식입니다. 디자인만 베낀 사이트는 style이, 템플릿을 그대로 쓴 사이트는 structural이 특히 높게 나옵니다.
응답을 아래 순서로 확인하세요. 결과 유무와 과금 여부는 서로 다릅니다.
data.error(사유 문구)와 data.success=0을 돌려줍니다. HTTP 상태는 사유에 따라 400·404·408·424 중 하나입니다.api.cost는 0이며 과금되지 않습니다. data.error 문구를 그대로 기록하고 사용자에게 보여 주세요.{
"data": {
"error": "입력값을 확인해 주세요.",
"success": 0
},
"api": {
"success": true,
"cost": 0,
"ms": 5
}
}url1과 url2를 모두 채워 다시 요청합니다.http·https 공개 주소가 아니거나 페이지가 열리지 않았습니다. 브라우저에서 두 주소가 열리는지 확인합니다.data.success가 3입니다. 잠시 뒤 다시 요청합니다.오류 응답은 모두 api.cost가 0이며 과금되지 않습니다.
FORM_DATA_INVALIDFORM_DATA_FIELD_CONFLICTMULTIPART_LIMIT_OR_PARSE_ERROR실제 차감 금액은 응답의 api.cost로 확인하세요. 상세 요금은 요금정책에서 볼 수 있습니다.