> 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/economy/economy-search/findentity.md).

# FindEntity

### Function specification

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

###

### Parameters

| Parameter                | Type                                  | Description                                                                                                                                                                                                                                                                   |
| ------------------------ | ------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| entity\_type             | string                                | 검색 대상이 되는 entity 의 타입을 명시합니다. 경제 지표 검색을 위해선 "DataSeries" 를 파라미터로 넘겨주어야 합니다.                                                                                                                                                                                                   |
| pattern                  | <p>string or</p><p>list of string</p> | 검색 하고자 하는 패턴을 지정합니다. 여러 단어를 입력할 때는 중간에 공백을 넣으면 됩니다.                                                                                                                                                                                                                           |
| count                    | integer                               | 검색 결과에 포함되는 기업의 갯수를 제한합니다. 0 일 경우 전체 목록을 리턴합니다.                                                                                                                                                                                                                               |
| fields                   | list of string                        | 경제 지표는 지표 이름과 symbol 만을 검색 대상으로 이용합니다. 따로 지정되지 않을 경우, 기본 값은 \["symbol", "name\_ko", "name\_en"] 입니다.                                                                                                                                                                          |
| score\_type              | string                                | <p>중요도를 계산하는 스코어 방식을 선택할 수 있습니다. 따로 지정하지 않을 경우 경제 지표 이름 전체 길이에서 패턴과 매치된 부분의 상대적인 비율을 사용합니다. "tf-idf" 라는 파라미터를 주면 tf-idf 방식에 의해서 스코어를 계산합니다.</p><p></p><p>위 두 가지 방법 중 하나로 스코어를 계산하고 나면, 여기에 각 경제 지표의 인기도 (popularity) 와 조합하여 보정 한 후 최종 스코어를 계산합니다. 스코어가 높은 지표를 우선해서 보여줍니다.</p> |
| include\_matched\_fields | boolean                               | 매치된 필드를 결과값에 별도 컬럼으로 포함시킵니다.                                                                                                                                                                                                                                                  |

###

### Examples

```
> FindEntity("DataSeries", "unemployment urban")

...

                            entity_type                   matched   score
symbol              field
FRED:UNRATE         name_en        FRED         Unemployment Rate  0.8067
FRED:UNRATENSA      name_en        FRED         Unemployment Rate  0.7059
FRED:LNU03000000    name_en        FRED        Unemployment Level  1.3333
FRED:UNEMPLOY       name_en        FRED        Unemployment Level  0.6667
FRED:LNS14000001    name_en        FRED   Unemployment Rate - Men  0.5217
...                                 ...                       ...     ...
FRED:SLUEM1524ZSARE name_en        FRED  Youth Unemployment Ra...  0.2308
FRED:SLUEM1524ZSSYR name_en        FRED  Youth Unemployment Ra...  0.2308
FRED:TNCCLAIMS      name_en        FRED  Continued Claims (Ins...  0.2308
FRED:VABEDF5URN     name_en        FRED  Unemployment Rate in ...  0.2308
FRED:WICCLAIMS      name_en        FRED  Continued Claims (Ins...  0.2308
```
