Endpoint Examples

/companies

GET /versions/{version}/companies

Executes a search to the Lightcast Companies database.

Path Parameters

NameTypeDescription
versionstringThe Lightcast Company version

Query Parameters

NameTypeDescription
qstringA query string of whole or partial keywords to search Company Name
fieldsstringComma separated list of fields to return in the results.
limitintegerHow many search results to return. This parameter is optional. Default is 10
offsetintegerStarting index of the results. This parameter is optional. Default is 0

Code Examples

curl --request GET \
     --url /company/versions/3.0.4/companies?q=lightcast&fields=company_id%2Ccompany_name%domain&limit=3&offset=0 \
     --header 'accept: application/json' \
     --header 'authorization: Bearer <Access_Token>' \
     --header 'content-type: application/json' \

Response Examples

{
    "data": [
        {
            "company_id": "0c169bcd-c295-422a-8cbc-e1a441407d82",
            "company_name": "Lightcast",
            "website": "https://lightcast.bio"
        },
        {
            "company_id": "1eef06a0-8c6f-4b09-b5a7-b9b7e0d6737b",
            "company_name": "Lightcast",
            "website": "https://www.lightcast.io/"
        },
        {
            "company_id": "694dc1ac-462a-4108-b7cd-b45ef6d9fd7e",
            "company_name": "Lightcast Church International",
            "website": "www.lightcast.nyc"
        }
    ],
    "limit": 3,
    "offset": 0,
    "count": 3
}

POST /versions/{version}/companies

Executes a search to the Lightcast Companies database

Path Parameters

NameTypeDescription
versionstringThe Lightcast Company version

Body Parameters

{
  "filter": {
    "acme_id": [
      "20",
      "39742874"
    ]
  },
  "fields": [
    "company_id",
    "company_name",
    "domain"
  ],
  "limit": 10,
  "offset": 0
}

Code Examples

curl --request POST \
     --url https://api.lightcast.io/company/versions/3.0.4/companies \
     --header 'accept: application/json' \
     --header 'authorization: Bearer <Access_Token>' \
     --header 'content-type: application/json' \

Response Examples

[
    {
        "company_id": "1eef06a0-8c6f-4b09-b5a7-b9b7e0d6737b",
        "company_name": "Lightcast",
        "domain": "lightcast.io"
    },
    {
        "company_id": "780fb79d-a25e-44bf-9720-91de348c99a7",
        "company_name": "Amazon.com, Inc.",
        "domain": "amazon.com"
    }
]

GET /versions/{version}/companies/{company_id}

Retrieves a specific item from the Lightcast Companies database.

Path Parameters

NameTypeDescription
versionstringThe Lightcast Company version
company_idstringThe Company ID of the Lightcast Company

Code Examples

curl --request GET \
     --url /company/versions/3.0.4/companies/1eef06a0-8c6f-4b09-b5a7-b9b7e0d6737b \
     --header 'accept: application/json' \
     --header 'authorization: Bearer <Access_Token>' \
     --header 'content-type: application/json' \

Response Examples

{
    "acme_id": "39742874",
    "address": "232 n almon st",
    "address_city": "Moscow",
    "address_latitude": 46.7323875,
    "address_longitude": -117.000165,
    "address_postalcode": null,
    "anzsic": "5921",
    "cik_code": null,
    "company_description": "Clear, actionable insight making a job market that works for everyone. Lightcast is the global leader in labor market data for businesses, communities, and education.",
    "company_email": null,
    "company_id": "1eef06a0-8c6f-4b09-b5a7-b9b7e0d6737b",
    "company_keywords": null,
    "company_name": "Lightcast",
    "company_name_alternate": "Economic Mdling Spcialists Int",
    "company_operating_status": "Active",
    "company_phone": "+1 208-883-3500",
    "completeness_score": 0.9333333373069763,
    "created_date": "2026-03-14",
    "cusip": null,
    "domain": "lightcast.io",
    "figi": null,
    "global_headcount": 850,
    "global_headcount_range": "501-1,000",
    "global_revenue": 4405338,
    "global_revenue_range": "$0-5M",
    "holding_id": null,
    "immediate_parent_country": "US",
    "immediate_parent_id": "1eef06a0-8c6f-4b09-b5a7-b9b7e0d6737b",
    "immediate_parent_name": "Lightcast",
    "ipeds_id": null,
    "is_brand": null,
    "is_education": false,
    "is_exporter": null,
    "is_fortune100": false,
    "is_fortune1000": false,
    "is_fortune500": false,
    "is_franchise": null,
    "is_government": false,
    "is_importer": null,
    "is_job_board": false,
    "is_non_profit": false,
    "is_publicly_traded": false,
    "is_staffing": false,
    "laa_admin0_division": "Mountain",
    "laa_admin0_region": "West",
    "laa_admin1_area_code": null,
    "laa_admin_area_1": "US16",
    "laa_admin_area_1_name": "Idaho",
    "laa_admin_area_2": "US16057",
    "laa_admin_area_2_name": "Latah County, ID",
    "laa_country": "US",
    "laa_country_name": "United States",
    "laa_metro_code": "0",
    "laa_metro_name": "Non Metropolitan Area",
    "laa_region_code": "019",
    "laa_region_name": "Americas",
    "laa_subregion_code": "021",
    "laa_subregion_name": "Northern America",
    "last_update_date": "2023-07-18",
    "linkedin_url": "https://www.linkedin.com/company/emsi-international",
    "nace_rev2": "J63.1.1",
    "naics_2": "51",
    "naics_3": "518",
    "naics_6": "518210",
    "naics_6_2017": "518210",
    "naics_6_description": "Computing Infrastructure Providers, Data Processing, Web Hosting, and Related Services",
    "naics_6_secondary": "541910",
    "naics_6_secondary_description": "Marketing Research and Public Opinion Polling",
    "naics_6_tertiary": null,
    "naics_6_tertiary_description": null,
    "national_business_id": null,
    "number_of_offices": 0,
    "previous_name": null,
    "role": "Standalone",
    "sic87_4d": "7375",
    "ssic2015": "63112",
    "ssic2020": "63111",
    "stock_exchange": null,
    "stock_tickers": [],
    "technographics": [],
    "ticker_symbol": null,
    "trade_style": "Lightcast",
    "twitter": "https://twitter.com/LightcastData",
    "uk_sic_1": "M",
    "uk_sic_2": "70",
    "uk_sic_5": "70229",
    "ultimate_parent_country": "US",
    "ultimate_parent_id": "1eef06a0-8c6f-4b09-b5a7-b9b7e0d6737b",
    "ultimate_parent_name": "Lightcast",
    "website": "https://www.lightcast.io/",
    "year_founded": 1996
}