API 문서

검색 결과에 담기는 필드입니다. 사업자등록번호는 기본정보부터 나옵니다.

목록 조회 5개 필드에 아래 4개가 더해집니다.

기본정보 9개 필드에 아래 필드가 더해집니다.

요청

curl -G https://gongsinara.com/api/v1/businesses \
  --data-urlencode "q=공시나라" \
  --data-urlencode "status=정상" \
  -H "X-API-Key: gsn_live_xxxxxxxx"

응답

{
  "data": [
    {
      "business_id": 100234,
      "company_name": "공시나라",
      "company_status": "정상",
      "main_industry_name": "응용 소프트웨어 개발 및 공급업",
      "region": "서울특별시 강남구"
    }
  ],
  "page": {
    "next_cursor": "eyJhZnRlciI6MTAwMjM0fQ",
    "has_more": true,
    "limit": 20
  }
}

다음 페이지는 next_cursor를 cursor 파라미터에 넣어 요청합니다. null이면 마지막 페이지입니다.

사업자등록번호마다 matches 배열이 옵니다. 못 찾은 번호는 빈 배열입니다.

요청

curl https://gongsinara.com/api/v1/businesses/resolve \
  -H "X-API-Key: gsn_live_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"business_numbers": ["1234567890", "0000000000"]}'

응답

{
  "data": [
    {
      "business_number": "1234567890",
      "matches": [
        {
          "business_id": 100234,
          "company_name": "공시나라",
          "company_status": "정상",
          "main_industry_name": "응용 소프트웨어 개발 및 공급업",
          "region": "서울특별시 강남구"
        }
      ]
    },
    {
      "business_number": "0000000000",
      "matches": []
    }
  ]
}

요청

curl https://gongsinara.com/api/v1/businesses/100234 \
  -H "X-API-Key: gsn_live_xxxxxxxx"

응답

{
  "data": {
    "business_id": 100234,
    "company_name": "공시나라",
    "company_status": "정상",
    "main_industry_name": "응용 소프트웨어 개발 및 공급업",
    "region": "서울특별시 강남구",
    "business_number": "1234567890",
    "founding_year": 2019,
    "company_type": "법인",
    "tax_type": "일반과세자"
  }
}

요청

curl https://gongsinara.com/api/v1/businesses/100234/detail \
  -H "X-API-Key: gsn_live_xxxxxxxx"

응답

{
  "data": {
    "business_id": 100234,
    "company_name": "공시나라",
    "business_number": "1234567890",
    "founding_year": 2019,
    "company_type": "법인",
    "road_address": "서울특별시 강남구 테헤란로 …",
    "founder_name": "홍길동",
    "phone_number": "02-0000-0000",
    "employee_count": 25,
    "average_salary": 48000000
  }
}

일부만 표시했습니다. 상세정보는 기본정보를 포함하며, 전체 필드는 위 응답 필드 표를 참고하세요.

level은 basic 또는 detail입니다. 못 찾은 id는 missing에 담기고 차감하지 않습니다.

요청

curl https://gongsinara.com/api/v1/businesses/bulk \
  -H "X-API-Key: gsn_live_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"ids": [100234, 999999], "level": "basic"}'

응답

{
  "data": [
    {
      "business_id": 100234,
      "company_name": "공시나라",
      "company_status": "정상",
      "main_industry_name": "응용 소프트웨어 개발 및 공급업",
      "region": "서울특별시 강남구",
      "business_number": "1234567890",
      "founding_year": 2019,
      "company_type": "법인",
      "tax_type": "일반과세자"
    }
  ],
  "missing": [999999]
}

요청

curl https://gongsinara.com/api/v1/me \
  -H "X-API-Key: gsn_live_xxxxxxxx"

응답

{
  "data": {
    "key_prefix": "gsn_live_a1b2c3d4",
    "plan": "premium",
    "points": {
      "included_limit": 300000,
      "included_used": 51500,
      "included_remaining": 248500,
      "credit_balance": 10000,
      "total_remaining": 258500,
      "period": "202609",
      "reset_at": "2026-10-01T00:00:00+00:00"
    },
    "rates": { "list_per_result": 5, "basic": 50, "detail": 100 }
  }
}

요청

curl https://gongsinara.com/api/v1/version

응답

{
  "data": { "api_version": "v1", "prefix": "/api/v1" }
}