FindEntity

기업명, 주소, 사업자 등록 번호 등을 조건으로 주고 이에 해당하는 기업들의 목록을 검색할 수 있습니다.

Function specification

FindEntity(entity_type, pattern, count=0, fields=None)

Parameters

Parameter

Type

Description

entity_type

string

검색 대상이 되는 entity 의 타입을 명시합니다. 현재는 "Financial" 만 지원합니다.

pattern

string or

list of string

검색 하고자 하는 패턴을 지정합니다. 와일드카드 (*) 사용이 가능합니다.

count

integer

검색 결과에 포함되는 기업의 갯수를 제한합니다. 0 일 경우 전체 목록을 리턴합니다.

fields

list of string

  • 기업 코드: symbol

  • 기업 이름: name_ko, name_en, name_short

  • 사업자 등록번호: business_rid

  • 법인 등록번호: company_rid

  • 산업 분류코드: industry_id

  • 주소: land_lot_en, land_lot_ko, road_name_en, road_name_ko

  • 전화번호: tel, fax

  • 기업형태 : company_type_l1 (01=주식, 02=합자, 03=합명, 04=유한, 05=조합, 06=정부투자기관,07=개인, 08=학교, 09=병원, 10=단체/협회, 15=유한책임회사,51=협동조합, 94=합자조합, 99=기타)

  • 기업상세코드 : company_type_l2

  • 기업규모 : company_type_size (1=대기업, 2=중소기업, 3=중견기업, 0=기타)

비어있을 경우 ["symbol", "name_ko", "name_en"] 을 기본 값으로 사용합니다.

Examples

1. 이름으로 검색

> FindEntity("Financial", "삼성*")

...

            entity_name
symbol                 
KRX:000810         삼성화재
KRX:001360         삼성제약
KRX:005930         삼성전자
KRX:006400        삼성SDI
KRX:006660         삼성공조
...                 ...
NICE:527988        삼성금속
NICE:528387       삼성고주파
NICE:528418      삼성화물운수
NICE:528557    삼성전자벧엘상사
NICE:529440          삼성

2. 사업자 등록 번호로 검색

> FindEntity("Financial", ["1248100998", "1268103725"], fields=["business_rid"])

...

           entity_name
symbol                
KRX:000660      SK하이닉스
KRX:005930        삼성전자

Note: 사업자 등록 번호 또는 법인 등록 번호를 이용해 기업을 검색할 땐 dash (-) 구분자 없이 숫자만 입력해야 합니다.

3. 주소로 검색

> FindEntity("Financial", "*울산*", fields=["road_name_ko", "land_lot_ko"])

...

            entity_name
symbol                 
KRX:001390        KG케미칼
KRX:004000       롯데정밀화학
KRX:004430         송원산업
KRX:007340     디티알오토모티브
KRX:009580        무림P&P
...                 ...
NICE:160779        레베산업
NICE:161033      금용종합건설
NICE:161235         엠알시
NICE:161472        갑부건설
NICE:161672          삼종

4. 전화번호로 검색

> FindEntity("Financial", "02-2005-1114", fields=["tel"])

...

            entity_name
symbol                 
KRX:007070        GS리테일
NICE:352705      지에스칼텍스
NICE:380679      LG정보통신
Previous기업 검색NextGetEntitySummary

Last updated

Was this helpful?