How can get company's us-gaap:CommonStockSharesOutstanding ?

[hwypengsir]

I get the following lines from grok.com.

from edgar import set_identity, Company
set_identity("Your Name your.email@example.com")  # required
ticker = "AAPL"   # change to your ticker
company = Company(ticker)
facts = company.get_facts()
if facts is None:
    print(f"No XBRL facts available for {ticker} via edgartools/SEC company facts API.")
    print("Possible reasons: company doesn't file detailed XBRL, foreign issuer, or data not yet available.")
    # → fallback options below
else:
    print(f"Success: {facts.num_facts()} facts loaded.")
    # Now safe to use
    tag = "us-gaap:CommonStockSharesOutstanding"
    if tag in facts:
        df = facts.to_pandas(tag)
        print(df.tail())          # last few periods
        latest = df.iloc[-1]
        print(f"Latest: {latest['value']:,} shares as of {latest.name}")
    else:
        print(f"Tag '{tag}' not found. Try 'dei:EntityCommonStockSharesOutstanding'")

Run in my pc:

python3
Python 3.11.2 (main, Apr 28 2025, 14:11:48) [GCC 12.2.0] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>> from edgar import set_identity, Company
>>> set_identity("myname.email@example.com") 
>>> ticker = "AAPL"    
>>> company = Company(ticker)
>>> facts = company.get_facts()
Error parsing company facts: 'NoneType' object has no attribute 'get'
>>> company
╭───────────────────────────────────────────────────────────────────────────────────╮
│ Apple Inc.  AAPL                                                                  │
│ 0000320193 • Nasdaq • Large Accelerated Filer                                     │
│                                                                                   │
│   Industry          3571: Electronic Computers                                    │
│   Fiscal Year       Sep 26                                                        │
│   Incorporated      California                                                    │
│   Phone             (408) 996-1010                                                │
│   Address           ONE APPLE PARK WAY, CUPERTINO, CA 95014                       │
╰────────────────────────────────── SEC Entity Data • company.docs for usage guide ─╯
>>> type(company)
<class 'edgar.entity.core.Company'>
>>> type(facts)
<class 'NoneType'>

Why get NoneType in my pc?My edgartools is the latest version.

pip show edgartools |grep -i  version
Version: 5.15.1

[dgunning]

Here is how you can get shares outstanding

company = Company("AAPL")
company.shares_outstanding
>>> 14681140000.0

[hwypengsir]

Why the company facts is Nonetype?

[dgunning]

Thanks for the report. The error 'NoneType' object has no attribute 'get' means the SEC company facts API returned empty/null data instead of the expected JSON.

Most likely cause: A network issue between your machine and the SEC servers. This can happen if:

• A firewall, proxy, or VPN is intercepting or blocking requests to data.sec.gov
• The SEC is rate-limiting your IP address
• A corporate proxy is returning an HTML error page instead of JSON

To debug, try this in Python:

from edgar.httprequests import download_json
data = download_json("https://data.sec.gov/api/xbrl/companyfacts/CIK0000320193.json")
print(type(data))   # Should be <class 'dict'>
print(list(data.keys()))  # Should be ['cik', 'entityName', 'facts']

If this fails or returns unexpected data, the issue is with your network connection to the SEC.

I've also improved the error handling so that instead of the confusing 'NoneType' object has no attribute 'get' message, you'll get a clear NoCompanyFactsFound error when the SEC data can't be fetched. This will be in the next release.

[dgunning]

Added better messages to edgartools 5.15.2 but this issue should be transient. If it persists let me know

[hwypengsir]

I get the desired result ,my ip is not been limited and network is in good work status.

from edgar.httprequests import download_json
data = download_json("https://data.sec.gov/api/xbrl/companyfacts/CIK0000320193.json")
print(list(data.keys())) 
['cik', 'entityName', 'facts']
len(data['facts']['us-gaap'])
503

Check company.get_facts():

from edgar import set_identity, Company
set_identity("myemail@gmail.com")  
ticker = "AAPL"   
company = Company(ticker)
facts = company.get_facts()
type(facts)
<class 'NoneType'>

Issue remains in my edgartools,it is not a network connection ,i am sure!

[dgunning]

Hi @hwypengsir - thank you for the detailed debugging! This helps a lot.

Quick Resolution

This exact issue was fixed in v5.15.2 (released same day as your report). However, I notice your initial report showed you were on v5.15.1.

Please upgrade to the latest version:

pip install --upgrade edgartools

Then verify it's working with this diagnostic:

from edgar import Company
import edgar.__about__

print(f"Version: {edgar.__about__.__version__}")  # Should show 5.16.0

company = Company("AAPL")
facts = company.get_facts()

if facts:
    print(f"✓ Success - {len(facts)} facts loaded")
else:
    print("✗ Still broken")

What Was Fixed

The error 'NoneType' object has no attribute 'get' occurred when the SEC API returned unexpected data. We added:

1. Better error handling - Clear exceptions instead of cryptic NoneType errors
2. User-friendly warnings - Helpful messages about network issues

If Still Failing

If you've upgraded to 5.16.0 and it's still failing, please share:

1. Exact version:

   python3 -c "from edgar import __about__; print(__about__.__version__)"

2. Full error output from the diagnostic script above

3. Python environment:

   python3 --version
   pip show edgartools | grep Version

I'll reopen if there's a regression, but I expect the upgrade will resolve it.

Workaround (While Debugging)

If get_facts() fails, you can access facts through filings:

filing = company.get_filings(form="10-K").latest()
xbrl = filing.xbrl()
# Now use xbrl.facts instead

Let me know how the upgrade goes!