--- agentTools: projectIndex: https://docs.thinknum.com/llms.txt --- # Company API [block:api-header] { "title": "Company List Endpoint" } [/block] The company list endpoint allows you to fetch the list of all companies stored in Thinknum. [block:code] { "codes": [ { "code": "GET /companies/ HTTP/1.1\nAuthorization: token 01234567890123456789\nX-API-Version: 20151130", "language": "http" } ] } [/block] 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: [block:code] { "codes": [ { "code": "{\n \"total\": 2189321,\n \"start\": 1,\n \"limit\": 100000,\n \"companies\": [\n {\n \"ticker\": \"nasdaq:AABA\",\n \"name\": \"Altaba\"\n },\n {\n \"ticker\": \"nasdaq:afrm\",\n \"name\": \"Affirm\"\n },\n {\n \"ticker\": \"nasdaq:afsi\",\n \"name\": \"AmTrust Financial Services\"\n }\n ...\n \t...\n ]\n}", "language": "json" } ] } [/block] 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. [block:code] { "codes": [ { "code": "GET /companies/?domain=tesla.com HTTP/1.1\nAuthorization: token 01234567890123456789\nX-API-Version: 20151130", "language": "http" } ] } [/block] A sample response follows. [block:code] { "codes": [ { "code": "{\n \"start\": 1,\n \"total\": 1,\n \"limit\": 100000,\n \"companies\": [\n {\n \"ticker\": \"nasdaq:tsla\",\n \"name\": \"Tesla Motors\"\n }\n ]\n}", "language": "json" } ] } [/block] You can also search for companies of particular dataset using `dataset_id` parameter. [block:code] { "codes": [ { "code": "GET /companies/?dataset_id=linkedin_company HTTP/1.1\nAuthorization: token 01234567890123456789\nX-API-Version: 20151130", "language": "http" } ] } [/block] A sample response follows. [block:code] { "codes": [ { "code": "{\n \"start\": 1,\n \"total\": 357255,\n \"limit\": 10,\n \"companies\": [\n {\n \"ticker\": \"nasdaq:aal\",\n \"name\": \"American Airlines\"\n },\n {\n \"ticker\": \"nasdaq:aame\",\n \"name\": \"Atlantic American\"\n },\n {\n \"ticker\": \"nasdaq:aaoi\",\n \"name\": \"Applied Optoelectronics\"\n },\n {\n \"ticker\": \"nasdaq:aaon\",\n \"name\": \"AAON\"\n },\n {\n \"ticker\": \"nasdaq:aapl\",\n \"name\": \"Apple\"\n },\n ...\n ...\n ]\n}\n", "language": "json" } ] } [/block] [block:api-header] { "title": "Company Metadata Endpoint" } [/block] To retrieve metadata of particular ticker, you can send GET request like this. [block:code] { "codes": [ { "code": "GET /companies/metadata?ticker=nasdaq:goog HTTP/1.1\nAuthorization: token 01234567890123456789\nX-API-Version: 20151130", "language": "http" } ] } [/block] A sample response follows. [block:code] { "codes": [ { "code": "{\n \"date_updated\": \"2022-06-21\",\n \"ticker\": \"nasdaq:goog\",\n \"display_name\": \"Alphabet\",\n \"market\": \"Nasdaq\",\n \"industry\": \"Interactive Media & Services\",\n \"sector\": \"Communication Services\",\n \"security\": [\n {\n \"type\": \"ORD\",\n \"cusip\": \"02079K107\",\n \"isin\": \"US02079K1079\"\n }\n ],\n \"category\": [\n \"Drones\",\n \"Real Estate\",\n \"Cyber Security\",\n \"Internet\",\n \"Software\",\n \"Mobile Apps\",\n \"Video Games\"\n ],\n \"domain_name\": [\n \"youtube.com\",\n \"google.com\"\n ],\n \"address\": [\n {\n \"city\": \"Mountain View\",\n \"country\": \"US\",\n \"coordinates\": {\n \"latitude\": null,\n \"longitude\": null\n },\n \"state\": \"CA\",\n \"street\": \"\",\n \"postal_code\": \"\"\n },\n {\n \"city\": \"Palo Alto\",\n \"country\": \"US\",\n \"coordinates\": {\n \"latitude\": null,\n \"longitude\": null\n },\n \"state\": \"CA\",\n \"street\": \"\",\n \"postal_code\": \"\"\n }\n ],\n \"contact\": [\n {\n \"contact_phone\": \"+1 253-874-8800\",\n \"contact_name\": null,\n \"contact_email\": null\n }\n ],\n \"ceo\": [\n {\n \"ceo_name\": \"Sundar Pichai\",\n \"ceo_headshot_url\": \"https://s3-us-west-2.amazonaws.com/documents.thinknum.com/glassdoor/ceo_headshot/9079\",\n \"ceo_headshot_2x_url\": \"https://s3-us-west-2.amazonaws.com/documents.thinknum.com/glassdoor/ceo_headshot_2x/9079\",\n \"ceo_email\": null,\n \"ceo_phone\": null\n }\n ],\n \"funding\": [\n {\n \"funding_stage\": \"Venture Round - Apigee\",\n \"funding_currency\": \"USD\",\n \"funding_amount\": 60000000,\n \"funding_date\": \"2014-04-29\",\n \"funding_investor\": null\n },\n {\n \"funding_stage\": \"Series A - Apigee\",\n \"funding_currency\": \"USD\",\n \"funding_amount\": 12000000,\n \"funding_date\": \"2005-04-01\",\n \"funding_investor\": null\n }\n ],\n \"investor\": [\n {\n \"investor_name\": \"INCENSe\",\n \"investor_total_funding_amount\": null,\n \"investor_total_funding_amount_currency\": null\n }\n ],\n \"acquisition\": [\n {\n \"target_name\": \"InsightsOne\",\n \"date\": \"20140108T050000Z\"\n }\n ],\n \"datasets\": [\n {\n \"id\": \"appstore_ratings\",\n \"display_name\": \"Apple Store Ratings\",\n \"summary\": \"Track app ratings and review counts daily from the Apple Store.\",\n \"blog_url\": \"https://blog.thinknum.com/apple-store-ratings/\",\n \"total\": 78581\n }\n ]\n}", "language": "json" } ] } [/block] [block:api-header] { "title": "Company Metric Endpoint" } [/block] To retrieve metrics of particular ticker, you can send GET request like this. [block:code] { "codes": [ { "code": "GET /companies/metrics?ticker=nasdaq:goog HTTP/1.1\nAuthorization: token 01234567890123456789\nX-API-Version: 20151130", "language": "http" } ] } [/block] A sample response follows. [block:code] { "codes": [ { "code": "[\n {\n \"metric_id\": \"datalab::linkedin_company::employees_on_platform::sum\",\n \"metric_name\": \"Employee Count\",\n \"metric_description\": \"Track the number of employees listed on LinkedIn for companies.\",\n \"dataset_id\": \"linkedin_company\",\n \"dataset_name\": \"Linkedin Profile\",\n \"dataset_description\": \"Track the number of employees listed on LinkedIn for companies.\",\n \"date_updated\": \"2022-06-21\",\n \"metric_value\": \"413442\",\n \"metric_format\": \"number\"\n },\n ...\n ...\n]", "language": "json" } ] } [/block]