v10

latestOpenAPI 3.1.02026-08-0452108384.4 KB

Company Lists

Get Companies From List

get/v0/company_lists/{list_id}/companies

Path parameters

list_idinteger required

Query parameters

order_by'revealed_at' | 'name'

Order by field

order_direction'asc' | 'desc'

Order direction

company_name_partialstring

Pass a partial company name to filter the list of companies

limitinteger

Number of results per page

pageinteger

Page number. Required when using page-based pagination.

offsetinteger

Number of results to skip. Required for offset-based pagination.

Response

Successful Response

company_namestring required

added_atstring date-time required

Date when the company was added to the list.

revealed_atstring date-time required

Date when the company was revealed.

Example response

[
  {
    "company_object": {
      "id": "google",
      "name": "Google",
      "domain": "google.com",
      "industry": "internet",
      "country": "United States",
      "employee_count": 7543,
      "logo": "https://example.com/logo.png",
      "num_jobs": 746,
      "num_technologies": 746,
      "url": "google.com",
      "linkedin_url": "http://www.linkedin.com/company/google",
      "num_jobs_last_30_days": 34,
      "num_jobs_found": 23,
      "yc_batch": "W21",
      "apollo_id": "5b839bd0324d4445051f9a5a",
      "founded_year": 2019,
      "annual_revenue_usd": 189000000,
      "annual_revenue_usd_readable": "189M",
      "total_funding_usd": 500000,
      "last_funding_round_date": "2020-01-01",
      "last_funding_round_amount_readable": "$1.2M",
      "employee_count_range": "1001-5000",
      "long_description": "Google is a California-based multinational technology company that offers internet-related services such as a search engine, online advertising and cloud computing.",
      "city": "Mountain View",
      "postal_code": "28040",
      "alexa_ranking": 1,
      "publicly_traded_symbol": "GOOG",
      "publicly_traded_exchange": "NASDAQ",
      "keyword_slugs": [
        "kafka",
        "elasticsearch",
        "lead-generation"
      ],
      "technology_slugs": [
        "kafka",
        "elasticsearch"
      ],
      "technology_names": [
        "Kafka",
        "Elasticsearch"
      ]
    }
  }
]