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정보통신