{"id":852,"date":"2019-05-27T16:54:42","date_gmt":"2019-05-27T16:54:42","guid":{"rendered":"https:\/\/eodhd.com\/knowledgebase\/?p=852"},"modified":"2025-10-23T13:03:08","modified_gmt":"2025-10-23T11:03:08","slug":"search-api-for-stocks-etfs-mutual-funds","status":"publish","type":"post","link":"https:\/\/eodhd.com\/financial-apis\/search-api-for-stocks-etfs-mutual-funds","title":{"rendered":"Search API for Stocks, ETFs, Mutual Funds, and Indices"},"content":{"rendered":"\n

The Search API<\/strong> allows you to quickly locate assets such as stocks, ETFs, mutual funds, bonds, and indices by using a flexible query engine. You can search by ticker code, company name, or ISIN. This API is particularly useful for applications requiring user-friendly asset lookups or autocomplete suggestions.<\/p>\n\n\n\n

The engine automatically adjusts search behavior based on the input string and considers asset popularity using metrics like market capitalization and trading volume. Filtering by asset type or exchange is supported.<\/p>\n\n\n\n

In addition, there’s another ID mapping endpoint<\/a> to retrieve common identifiers (CUSIP, ISIN, OpenFigi, LEI, and CIK) for a symbol or by a specific identifier.<\/p>\n\n\n\n\n\n\n\n

API Endpoint<\/h2>\n\n\n\n

To search for financial instruments, use the following endpoint:<\/p>\n\n\n\n

\n

\n
\n
URL<\/div>\n
cURL<\/div>\n
PHP<\/div>\n
Python<\/div>\n
R<\/div>\n
Chat GPT<\/div>\n <\/div>\n
\n
\n
\n \n \n <\/use>\n <\/svg>\n <\/button>\n \n \n <\/use>\n <\/svg>\n <\/button>\n <\/div>\n 
https:\/\/eodhd.com\/api\/search\/{query_string}?api_token={YOUR_API_TOKEN}<\/span>&fmt=json<\/pre>\n                    
\n                        (Sign up<\/a> for free to get an API token)\n                    <\/div>\n                <\/div>\n                                            
\n                    
\n                                                \n                            \n                                <\/use>\n                            <\/svg>\n                        <\/button>\n                    <\/div>\n                    
curl --location \"https:\/\/eodhd.com\/api\/search\/{query_string}?api_token={YOUR_API_TOKEN}<\/span>&fmt=json\"<\/pre>\n                    
\n                        (Sign up<\/a> for free to get an API token)\n                    <\/div>\n                <\/div>\n                                            
\n                    
\n                                                \n                            \n                                <\/use>\n                            <\/svg>\n                        <\/button>\n                    <\/div>\n                    
\n$curl = curl_init();\n\ncurl_setopt_array($curl, array(\n    CURLOPT_URL => 'https:\/\/eodhd.com\/api\/search\/{query_string}?api_token={YOUR_API_TOKEN}<\/span>&fmt=json',\n    CURLOPT_RETURNTRANSFER => true,\n    CURLOPT_ENCODING => '',\n    CURLOPT_MAXREDIRS => 10,\n    CURLOPT_TIMEOUT => 0,\n    CURLOPT_FOLLOWLOCATION => true,\n    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,\n    CURLOPT_CUSTOMREQUEST => 'GET',\n));\n\n$data = curl_exec($curl);\ncurl_close($curl);\n\ntry {\n    $data = json_decode($data, true, 512, JSON_THROW_ON_ERROR);\n    var_dump($data);\n} catch (Exception $e) {\n    echo 'Error. '.$e->getMessage();\n}<\/pre>\n                    
\n                        (Sign up<\/a> for free to get an API token)\n                    <\/div>\n                <\/div>\n                                            
\n                    
\n                                                \n                            \n                                <\/use>\n                            <\/svg>\n                        <\/button>\n                    <\/div>\n                    
\nimport requests\n\nurl = f'https:\/\/eodhd.com\/api\/search\/{query_string}?api_token={YOUR_API_TOKEN}<\/span>&fmt=json'\ndata = requests.get(url).json()\n\nprint(data)<\/pre>\n                    
\n                        (Sign up<\/a> for free to get an API token)\n                    <\/div>\n                <\/div>\n                                            
\n                    
\n                                                \n                            \n                                <\/use>\n                            <\/svg>\n                        <\/button>\n                    <\/div>\n                    
\nlibrary(httr)\nlibrary(jsonlite)\n\nurl <- 'https:\/\/eodhd.com\/api\/search\/{query_string}?api_token={YOUR_API_TOKEN}<\/span>&fmt=json'\nresponse <- GET(url)\n\nif (http_type(response) == \"application\/json\") {\n    content <- content(response, \"text\", encoding = \"UTF-8\")\n    cat(content)\n} else {\n    cat(\"Error while receiving data\\n\")\n}<\/pre>\n                    
\n                        (Sign up<\/a> for free to get an API token)\n                    <\/div>\n                <\/div>\n                        
\n                
\n                    \n                        \n                            <\/use>\n                        <\/svg>\n                    <\/a>\n                <\/div>\n                
\n                    New to coding? Our ChatGPT assistant can generate code in any language tailored to our API.\n                    Simply describe how you want to use our data, and get a working piece of code.\n                    Don\u2019t forget to replace the API token with your own.

\n                    Try it now (it's free)!<\/a>

\n                    \n                        How to use it (YouTube)\n                    <\/a>\n                <\/div>\n            <\/div>\n        <\/div>\n    <\/div>\n\n    

<\/p>\n\n\n\n
Parameters<\/strong><\/h2>\n\n\n\n
Parameter<\/th>Required<\/th>Description<\/th><\/tr><\/thead>
query_string<\/td>Yes<\/td>The search input. Can be a ticker symbol, company name, or ISIN. Example values: AAPL<\/strong>, Apple Inc<\/strong>, US0378331005<\/strong>.<\/td><\/tr>
limit<\/td>No<\/td>Limits the number of results. Default is 15. Maximum value is 500.<\/td><\/tr>
bonds_only<\/td>No<\/td>Set to 1 to include only bonds in the results. Default is 0 (bonds excluded).<\/td><\/tr>
exchange<\/td>No<\/td>Filter results by exchange code (e.g., US, PA, FOREX, NYSE, NASDAQ). List of Exchanges API.<\/a><\/td><\/tr>
type<\/td>No<\/td>Filter results by asset type. Possible values: all<\/strong>, stock<\/strong>, etf<\/strong>, fund<\/strong>, bond<\/strong>, index<\/strong>, crypto<\/strong>. Note: when using “all”, bonds are excluded by default. Use “type=bond” to include bonds.<\/td><\/tr>
api_token<\/td>Yes<\/td>Your personal API key, provided after registration.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n