Overview
Looks up an exchange and symbol based on company name and security type.
Description

This API returns a list of securities of a specified type (e.g., equity stock) based on a full or partial match of any part of the company name. For instance, a search for "jones" returns a list of securities associated with "Jones Soda Co", "Stella Jones Inc", and many others. The list contains the company name, the exchange that lists the security, the security type, and the symbol, for as many matches as are found.

The result may include some unexpected matches, because the search includes more than just the display version of the company name. For instance, searching on "etrade" returns securities for "E TRADE" - notice the space in the name.

This API is for searching on the company name, not a security symbol. It's commonly used to look up a symbol based on the company name, e.g., "What is the symbol for Google stock?". To look up company information based on a symbol, or to find detailed information on a security, use the quote API.

URL
https://etws.etrade.com/market/rest/productlookup
HTTP Method: GET
Request Parameters
Parameter Type Required? Description
company string required Full or partial name of the company. Note that the system extensively abbreviates common words such as "company", "industries", and "systems", and generally skips punctuation (periods, commas, apostrophes, etc.) .
type enum required The type of security. Possible values are: EQ (equity) or MF (mutual fund).
Response Properties
Property Type Description
companyName string The name of the company
exchange string The exchange that lists the company
securityType string The type of security. Possible values are EQ (equity) and MF (mutual fund).
symbol string The market symbol for this security
Sample Request
GET https://etws.etrade.com/market/rest/productlookup?company=cisco&type=EQ
Sample Response - XML
<productLookupResponse>
  <productList>
    <companyName>CISCO SYS INC COM</companyName>
    <exchange>NASDAQ NM</exchange>
    <securityType>EQ</securityType>
    <symbol>CSCO</symbol>
  </productList>
  <productList>
    <companyName>FRANCISCO INDS INC COM</companyName>
    <exchange>OTC</exchange>
    <securityType>EQ</securityType>
    <symbol>FRAN</symbol>
  </productList>
  <productList>
    <companyName>SAN FRANCISCO CO</companyName>
    <exchange>OTC</exchange>
    <securityType>EQ</securityType>
    <symbol>SFHC</symbol>
  </productList>
</productLookupResponse>
Sample response - JSON
{
  "productLookupResponse":{
    "productList":[
      {
        "companyName":"CISCO SYS INC COM",
        "exchange":"NASDAQ NM",
        "securityType":"EQ",
        "symbol":"CSCO"
      },
      {
        "companyName":"FRANCISCO INDS INC COM",
        "exchange":"OTC",
        "securityType":"EQ",
        "symbol":"FRAN"
      },
      {
        "companyName":"SAN FRANCISCO CO",
        "exchange":"OTC",
        "securityType":"EQ",
        "symbol":"SFHC"
      }
    ]
  }
}
Sample use cases
Some possible use-cases and workflows are described below.
Purpose Workflow Related APIs
Product lookup Based on user input, display a list of matching company names, security types, and market symbols. User can select a desired symbol to retrieve, for instance, a current market value, fundamental display, and streaming updates. Look Up Product, Get Quote, Streaming API
Sandbox Samples
Request
GET https://etwssandbox.etrade.com/market/sandbox/rest/productlookup?company=fi&type=EQ
Response
<ProductLookupResponse>
  <Product>
    <companyName>E TRADE FINANCIAL CORP COM</companyName>
    <exchange>NASDAQ NM</exchange>
    <securityType>EQ</securityType>
    <symbol>ETFC</symbol>
  </Product>
  <Product>
    <companyName>FT UT 1888DFIETFCM</companyName>
    <exchange>OTCBB</exchange>
    <securityType>EQ</securityType>
    <symbol>FDFXNX</symbol>
  </Product>
</ProductLookupResponse>
Related APIs
PLEASE READ THE IMPORTANT DISCLOSURES BELOW

By using E*TRADE API ("API") and accepting the terms of the Application Programming Interface License Agreement and the Application Programming Interface User Agreement, you agree that API may employ security policies, procedures and systems of Third Party providers which may or may not be less stringent and secure than the policies, procedures and systems of E*TRADE Securities LLC ("E*TRADE") or its affiliates. Material provided on API may have been produced by independent third parties not affiliated or endorsed by E*TRADE or its affiliates ("Third Party"). To the extent that API or Third Party providers express opinions or make recommendations, you understand that such opinions or recommendations are expressed by the Third Party provider and are not the opinions or recommendations of E*TRADE or its affiliates. E*TRADE is not responsible for the accuracy of market data displayed on API or made available by Third Party providers. There may be latency between the time an order (or other information) is submitted from API and the time the order is received by E*TRADE. The E*TRADE Two Second Execution Guarantee or any similar guarantee does not apply for orders placed through API and Third Party provider web sites. The E*TRADE CompleteTM Protection Guarantee does not apply. Orders created and submitted through API are not vetted until they are received by E*TRADE. It is possible that E*TRADE may reject an order placed through API. Please see the Application Programming Interface License Agreement and the Application Programming Interface User Agreement for more information.


The E*TRADE family of companies provides financial services including trading, investing, and related banking products and services to retail investors.


Securities products and services offered by E*TRADE Securities LLC, Member FINRA/SIPC.


System response and account access times may vary due to a variety of factors, including trading volumes, market conditions, system performance, and other factors.