플레이스 순위 조회

⚡Request 정보

MethodPOST

ParameterJSON

전문형태JSON / String

리턴값JSON

POST https://api.adlog.kr/api/getKeywordListDetail.php

🔑Header

Field	설명	타입	Len	필수	예시	비고
authorization	API Key	String	-	필수	-	API를 사용하기 위한 고유 Key 값

📥Input Parameters

Field	설명	타입	Len	필수	예시	비고
user_id	아이디	String	-	필수	-	회원 아이디
api_menu	구분값	Int	4	필수	1064	메뉴 정보 참고 →
api_no	고유번호	Int	-	필수	-
page	페이지	Int	-	선택	-	1페이지 30개 기준 (최대 5페이지)

💻Request Sample

# 플레이스 순위 조회 API 호출
curl -X POST https://api.adlog.kr/api/getKeywordListDetail.php \
  -H "authorization: Bearer YOUR-SECRET-KEY" \
  -H "content-Type: application/json" \
  -d '{
    "user_id": "adlog",
    "api_menu": "1064",
    "api_no": 1
  }'

<?php
  // 플레이스 순위 조회 API 호출
  $url = "https://api.adlog.kr/api/getKeywordListDetail.php";

  $headers = array(
    "authorization: Bearer YOUR-SECRET-KEY",
    "content-Type: application/json"
  );

  $postData = array(
    'user_id'     => 'adlog',
    'api_menu'    => '1064',
    'api_no'      => 1
  );

  $ch = curl_init();

  curl_setopt($ch, CURLOPT_URL, $url);
  curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
  curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
  curl_setopt($ch, CURLOPT_POST, true);
  curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($postData));

  $response = curl_exec($ch);

  curl_close($ch);

  print $response;
?>

📤Output Parameters

Field	설명
code	처리 결과 (0000 : 성공, 이외는 실패)
msg	응답 메시지
api_no	키워드 고유번호
total_count	조회된 총 수량
page	요청페이지 번호
items	키워드별 순위 정보
rank_date	순위 체크일
rank_num	순위
blog_review_count	블로그 리뷰 수
visit_review_count	방문자 리뷰 수
save_count	저장 수
newopen	신규 오픈 여부 (1: 신규 오픈)
pc_month_count	월 PC 검색수
mo_month_count	월 모바일 검색수
total_month_count	월간 총 검색수
place_count	플레이스 업체 수
place_n1	플레이스 지수 N1
place_n2	플레이스 지수 N2
place_n3	플레이스 지수 N3

💻Response Sample

{
  "code": "0000",
  "msg": "키워드 순위 조회 성공",
  "items": [
    {
      "api_no": 1,
      "rank_date": "2024-12-26",
      "rank_num": 36,
      "blog_review_count": 8654,
      "visit_review_count": 2093,
      "save_count": "318,000+",
      "newopen": 0,
      "pc_month_count": 21400,
      "mo_month_count": 177200,
      "total_month_count": 198600,
      "place_count": 8560,
      "place_n1": 0.000000,
      "place_n2": 0.000000,
      "place_n3": 0.000000
    }
  ]
}

{
  "code": "9999", // 에러 코드 메뉴 참조
  "msg": "키워드 순위 조회 실패"
}

ADLOG API

플레이스 순위 조회