# FindEntity

### Function specification

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

###

### Parameters

| Parameter    | Type                                  | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| ------------ | ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| entity\_type | string                                | 검색 대상이 되는 entity 의 타입을 명시합니다. 현재는 "Financial" 만 지원합니다.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| pattern      | <p>string or</p><p>list of string</p> | 검색 하고자 하는 패턴을 지정합니다. 와일드카드 (\*) 사용이 가능합니다.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| count        | integer                               | 검색 결과에 포함되는 기업의 갯수를 제한합니다. 0 일 경우 전체 목록을 리턴합니다.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| fields       | list of string                        | <p>검색 대상이 되는 항목을 명시합니다. 아래 항목 등 기업 개요에 나오는 전체 정보를 사용할 수 있습니다. ( 전체 기업 개요는 <a href="https://help.deepsearch.com/dp/deepsearch/api/2.1./company/getcompanysummary">여기</a>를 참고하세요 )<br></p><ul><li>기업 코드: symbol</li><li>기업 이름: name\_ko, name\_en, name\_short</li><li>사업자 등록번호: business\_rid</li><li>법인 등록번호: company\_rid</li><li>산업 분류코드: industry\_id</li><li>주소: land\_lot\_en, land\_lot\_ko, road\_name\_en, road\_name\_ko</li><li>전화번호: tel, fax</li><li>기업형태 : company\_type\_l1 (01=주식, 02=합자, 03=합명, 04=유한, 05=조합, 06=정부투자기관,07=개인, 08=학교, 09=병원, 10=단체/협회, 15=유한책임회사,51=협동조합, 94=합자조합, 99=기타) </li><li>기업상세코드 : company\_type\_l2</li><li>기업규모 : company\_type\_size (1=대기업, 2=중소기업, 3=중견기업, 0=기타)</li></ul><p>비어있을 경우 \["symbol", "name\_ko", "name\_en"] 을 기본 값으로 사용합니다.</p> |

###

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.deepsearch.com/dp/api/func/company/company-search/findentity.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
