Skip to main content
GET
/
companies
Get Companies
curl --request GET \
  --url https://www.trysignalbase.com/api/v2/companies \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "data": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "name": "NextGen Software",
      "slug": "nextgen-software",
      "description": "Enterprise SaaS platform for workflow automation.",
      "website": "https://www.nextgensoftware.com",
      "linkedinUrl": "https://www.linkedin.com/company/nextgensoftware",
      "twitterUrl": "https://twitter.com/nextgensoftware",
      "logoUrl": "https://media.licdn.com/dms/image/example.png",
      "industry": "Technology",
      "foundedYear": 2018,
      "headquartersCountry": "US",
      "employeeCount": 250,
      "categories": [
        "Software",
        "SaaS",
        "Enterprise"
      ],
      "keywords": [
        "workflow automation",
        "enterprise",
        "AI"
      ],
      "specialties": [
        "process automation",
        "integration"
      ],
      "growthInfo": {
        "growth_1m": 1.2,
        "growth_3m": 3.5,
        "growth_6m": 8.1,
        "growth_9m": 12,
        "growth_12m": 18.5
      },
      "createdAt": "2024-06-15T10:30:00Z",
      "updatedAt": "2024-11-20T14:00:00Z"
    },
    {
      "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "name": "HealthTech Solutions",
      "slug": "healthtech-solutions",
      "description": "AI-powered healthcare diagnostics platform for early disease detection.",
      "website": "https://www.healthtechsolutions.co.uk",
      "linkedinUrl": "https://www.linkedin.com/company/healthtechsolutions",
      "twitterUrl": null,
      "logoUrl": "https://media.licdn.com/dms/image/example2.png",
      "industry": "Healthcare Technology",
      "foundedYear": 2022,
      "headquartersCountry": "GB",
      "employeeCount": 85,
      "categories": [
        "Healthcare",
        "AI"
      ],
      "keywords": [
        "diagnostics",
        "AI",
        "health"
      ],
      "specialties": [
        "disease detection",
        "medical imaging"
      ],
      "growthInfo": null,
      "createdAt": "2024-08-01T09:00:00Z",
      "updatedAt": "2024-11-18T11:30:00Z"
    }
  ],
  "pagination": {
    "currentPage": 1,
    "totalPages": 200,
    "totalCount": 4000,
    "hasNextPage": true,
    "hasPreviousPage": false
  },
  "meta": {
    "endpoint": "companies.list",
    "creditsUsed": 1
  }
}

Authorizations

​
Authorization
string
header
required

API key for Companies API authentication. Include as Bearer token in Authorization header.

Query Parameters

​
page
integer
default:1

Page number for pagination

Required range: x >= 1
​
limit
integer
default:20

Number of results per page (maximum 100)

Required range: 1 <= x <= 100
​
search
string

Free-text search across company name, industry, description, keywords, and specialties

​
countries
string

Comma-separated list of country codes to filter by

​
industry
string

Comma-separated list of industry names to filter by (exact match)

​
employee_count_min
integer

Minimum employee count

Required range: x >= 0
​
employee_count_max
integer

Maximum employee count

Required range: x >= 0
​
founded_year_min
integer

Minimum founded year

Required range: x >= 1800
​
founded_year_max
integer

Maximum founded year

Required range: x >= 1800
​
sort_by
enum<string>
default:name

Field to sort by

Available options:
name,
employee_count,
founded_year,
created_at
​
sort_order
enum<string>
default:desc

Sort direction

Available options:
asc,
desc
​
count
enum<string>

If set to true, returns only the total count without data rows and without deducting credits.

Available options:
true

Response

Successful response with companies

​
success
boolean
required

Indicates if the request was successful

Example:

true

​
data
object[]
required

Array of company records

​
pagination
object
required
​
meta
object
required