> For the complete documentation index, see [llms.txt](https://help.deepsearch.com/dp/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.deepsearch.com/dp/api/func/company/company-search/findentity.md).
# 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정보통신
```