{"openapi":"3.1.0","info":{"title":"Company Data Guys API","version":"2026-05-16","description":"Fetch live or recently stored company data for LinkedIn company, school, and showcase URLs."},"servers":[{"url":"https://companydataguys.com","description":"Production"}],"tags":[{"name":"Company Data","description":"Company enrichment endpoints."}],"paths":{"/v1/linkedin/company-data":{"post":{"tags":["Company Data"],"operationId":"getLinkedInCompanyData","summary":"Get company data","description":"Send up to 200 LinkedIn company, school, or showcase URLs. Use maxAgeHours: 0 for a live refresh, or a freshness window up to 24 hours to allow stored results.","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyDataRequest"},"examples":{"liveSingleCompany":{"summary":"Live single-company request","value":{"liUrls":["https://www.linkedin.com/company/apple/"],"maxAgeHours":0}},"storedBatch":{"summary":"Stored batch request","value":{"liUrls":["https://www.linkedin.com/company/apple/","https://www.linkedin.com/company/microsoft/"],"maxAgeHours":24}}}}}},"responses":{"200":{"description":"Company data response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyDataResponse"},"examples":{"success":{"value":{"message":"Success","status_code":200,"results":[{"company_name":"Apple","domain":"apple.com","final_li_url":"https://www.linkedin.com/company/apple/","original_li_url":"https://www.linkedin.com/company/apple/","company_id":162479,"company_size":"10,001+ employees","employee_count_on_li":181922,"follower_count":18213841,"industries":"Computers and Electronics Manufacturing","type":"Public Company","founded":1976,"website":"https://www.apple.com/careers","logo":"https://media.licdn.com/...","headquarters":{"fullAddress":"1 Apple Park Way, Cupertino, California, 95014, US","street":"1 Apple Park Way","locality":"Cupertino","region":"California","postalCode":"95014","country":"US"},"funding_info":{"number_of_funding_rounds":9,"last_round":{"type":"Post IPO debt","date":"Jun 5, 2025","money_raised":"$ 4.5B","money_raised_usd":4500000000,"money_raised_usd_qualifier":"exact"}},"products":[{"name":"iPhone","description":"Smartphone"}],"similar_pages":[],"affiliated_pages":[]}]}}}}}},"400":{"description":"Invalid request body or unsupported URL.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"Insufficient credits.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Request body exceeds the 100 KB limit.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"504":{"description":"Live lookup timed out.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"Company Data Guys API key"}},"schemas":{"CompanyDataRequest":{"type":"object","required":["liUrls"],"additionalProperties":false,"properties":{"liUrls":{"type":"array","minItems":1,"maxItems":200,"items":{"type":"string","format":"uri","pattern":"^https://([a-z0-9-]+\\.)?linkedin\\.com/(company|school|showcase)/.+"}},"maxAgeHours":{"type":"number","minimum":0,"maximum":24,"default":0,"description":"Freshness window in hours. 0 requests live data. Non-zero values allow stored results."},"maxAgeSeconds":{"type":"number","minimum":0,"maximum":86400,"description":"Freshness window in seconds. Takes precedence over maxAgeHours."}}},"CompanyDataResponse":{"type":"object","required":["message","status_code","results"],"properties":{"message":{"type":"string","example":"Success"},"status_code":{"type":"integer","example":200},"results":{"type":"array","items":{"$ref":"#/components/schemas/CompanyResult"}}}},"CompanyResult":{"type":"object","additionalProperties":true,"description":"Company result object. Missing values are omitted instead of returned as undefined.","properties":{"company_name":{"type":"string"},"company_id":{"type":"integer"},"final_li_url":{"type":"string","format":"uri"},"original_li_url":{"type":"string","format":"uri"},"domain":{"type":"string"},"website":{"type":"string"},"logo":{"type":"string"},"banner_img":{"type":"string"},"description":{"type":"string"},"slogan":{"type":"string"},"industries":{"type":"string"},"type":{"type":"string"},"founded":{"type":"integer"},"company_size":{"type":"string"},"employee_count_on_li":{"type":"integer"},"follower_count":{"type":"integer"},"job_count":{"type":"integer"},"specialties":{"type":"array","items":{"type":"string"}},"headquarters":{"type":"object","additionalProperties":true},"locations":{"type":"array","items":{"type":"object","additionalProperties":true}},"funding_info":{"type":"object","additionalProperties":true},"products":{"type":"array","items":{"type":"object","additionalProperties":true}},"updates":{"type":"array","items":{"type":"object","additionalProperties":true}},"similar_pages":{"type":"array","items":{"type":"object","additionalProperties":true}},"affiliated_pages":{"type":"array","items":{"type":"object","additionalProperties":true}},"employees_on_li":{"type":"array","items":{"type":"object","additionalProperties":true}}}},"ErrorResponse":{"type":"object","required":["error","message","status_code"],"properties":{"error":{"type":"string"},"message":{"type":"string"},"status_code":{"type":"integer"}}}}}}