Company API

Company List Endpoint

The company list endpoint allows you to fetch the list of all companies stored in Thinknum.

GET /companies/ HTTP/1.1
Authorization: token 01234567890123456789
X-API-Version: 20151130

In response, you will get a JSON formatted block, containing the list of companies. A list of items, each of which has the ticker and its name.

A sample response follows:

{
    "total": 2189321,
    "start": 1,
    "limit": 100000,
    "companies": [
        {
            "ticker": "nasdaq:AABA",
            "name": "Altaba"
        },
        {
            "ticker": "nasdaq:afrm",
            "name": "Affirm"
        },
        {
            "ticker": "nasdaq:afsi",
            "name": "AmTrust Financial Services"
        }
        ...
        ...
    ]
}

The start and limit parameter is supported as parameter for pagination. The default value of start is 1 and limit is 100000.

You can search for companies using domain parameter.

GET /companies/?domain=tesla.com HTTP/1.1
Authorization: token 01234567890123456789
X-API-Version: 20151130

A sample response follows.

{
    "start": 1,
    "total": 1,
    "limit": 100000,
    "companies": [
        {
            "ticker": "nasdaq:tsla",
            "name": "Tesla Motors"
        }
    ]
}

You can also search for companies of particular dataset using dataset_id parameter.

GET /companies/?dataset_id=linkedin_company HTTP/1.1
Authorization: token 01234567890123456789
X-API-Version: 20151130

A sample response follows.

{
    "start": 1,
    "total": 357255,
    "limit": 10,
    "companies": [
        {
            "ticker": "nasdaq:aal",
            "name": "American Airlines"
        },
        {
            "ticker": "nasdaq:aame",
            "name": "Atlantic American"
        },
        {
            "ticker": "nasdaq:aaoi",
            "name": "Applied Optoelectronics"
        },
        {
            "ticker": "nasdaq:aaon",
            "name": "AAON"
        },
        {
            "ticker": "nasdaq:aapl",
            "name": "Apple"
        },
        ...
        ...
    ]
}

Company Metadata Endpoint

To retrieve metadata of particular ticker, you can send GET request like this.

GET /companies/metadata/nasdaq:goog HTTP/1.1
Authorization: token 01234567890123456789
X-API-Version: 20151130

A sample response follows.

{
    "date_updated": "2022-06-21",
    "ticker": "nasdaq:goog",
    "display_name": "Alphabet",
    "market": "Nasdaq",
    "industry": "Interactive Media & Services",
    "sector": "Communication Services",
    "security": [
        {
            "type": "ORD",
            "cusip": "02079K107",
            "isin": "US02079K1079"
        }
    ],
    "category": [
        "Drones",
        "Real Estate",
        "Cyber Security",
        "Internet",
        "Software",
        "Mobile Apps",
        "Video Games"
    ],
    "domain_name": [
        "youtube.com",
        "google.com"
    ],
    "address": [
        {
            "city": "Mountain View",
            "country": "US",
            "coordinates": {
                "latitude": null,
                "longitude": null
            },
            "state": "CA",
            "street": "",
            "postal_code": ""
        },
        {
            "city": "Palo Alto",
            "country": "US",
            "coordinates": {
                "latitude": null,
                "longitude": null
            },
            "state": "CA",
            "street": "",
            "postal_code": ""
        }
    ],
    "contact": [
        {
            "contact_phone": "+1 253-874-8800",
            "contact_name": null,
            "contact_email": null
        }
    ],
    "ceo": [
        {
            "ceo_name": "Sundar Pichai",
            "ceo_headshot_url": "https://s3-us-west-2.amazonaws.com/documents.thinknum.com/glassdoor/ceo_headshot/9079",
            "ceo_headshot_2x_url": "https://s3-us-west-2.amazonaws.com/documents.thinknum.com/glassdoor/ceo_headshot_2x/9079",
            "ceo_email": null,
            "ceo_phone": null
        }
    ],
    "funding": [
        {
            "funding_stage": "Venture Round - Apigee",
            "funding_currency": "USD",
            "funding_amount": 60000000,
            "funding_date": "2014-04-29",
            "funding_investor": null
        },
        {
            "funding_stage": "Series A - Apigee",
            "funding_currency": "USD",
            "funding_amount": 12000000,
            "funding_date": "2005-04-01",
            "funding_investor": null
        }
    ],
    "investor": [
        {
            "investor_name": "INCENSe",
            "investor_total_funding_amount": null,
            "investor_total_funding_amount_currency": null
        }
    ],
    "acquisition": [
        {
            "target_name": "InsightsOne",
            "date": "20140108T050000Z"
        }
    ],
    "datasets": [
        {
            "id": "appstore_ratings",
            "display_name": "Apple Store Ratings",
            "summary": "Track app ratings and review counts daily from the Apple Store.",
            "blog_url": "https://blog.thinknum.com/apple-store-ratings/",
            "total": 78581
        }
    ]
}

Company Metric Endpoint

To retrieve metrics of particular ticker, you can send GET request like this.

GET /companies/metrics/nasdaq:goog HTTP/1.1
Authorization: token 01234567890123456789
X-API-Version: 20151130

A sample response follows.

[
    {
        "metric_id": "datalab::linkedin_company::employees_on_platform::sum",
        "metric_name": "Employee Count",
        "metric_description": "Track the number of employees listed on LinkedIn for companies.",
        "dataset_id": "linkedin_company",
        "dataset_name": "Linkedin Profile",
        "dataset_description": "Track the number of employees listed on LinkedIn for companies.",
        "date_updated": "2022-06-21",
        "metric_value": "413442",
        "metric_format": "number"
    },
    ...
    ...
]