Introduction - Signalbase Documentation

Welcome to the Companies API

The Companies API lets you browse and search our company database independently of any signal data. Query companies by name, industry, country, employee count, founded year, and more — with full pagination and sorting support.

Companies Endpoint

View the complete OpenAPI specification

Count Mode

You can get the total number of results matching any filter combination without consuming credits by adding count=true to your request. This returns an empty data array with full pagination metadata, including totalCount.

curl -X GET "https://www.trysignalbase.com/api/v2/companies?count=true&countries=US&industry=Software" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response:

{
  "success": true,
  "data": [],
  "pagination": {
    "currentPage": 1,
    "totalPages": 40,
    "totalCount": 792,
    "hasNextPage": true,
    "hasPreviousPage": false
  },
  "meta": {
    "endpoint": "companies.list",
    "creditsUsed": 0
  }
}

Use count mode to preview how many results match your filters before fetching actual data. This is useful for building filter UIs, showing result counts, or validating queries — all at zero credit cost.

Identifier Lookup

Beyond browsing, you can resolve a specific company by its canonical identifier (exact match, not fuzzy search). Accepted URL variants — scheme, www., port, path and trailing slash — are normalized before matching:

Parameter	Description
`domain`	Company website domain (e.g. `novartis.com`)
`linkedin_url`	Company LinkedIn URL (e.g. `linkedin.com/company/novartis`)

Invalid identifier syntax returns 400. A valid identifier that resolves to nothing returns an empty data set with a 200. Identifiers AND with any other filters, so a conflicting domain + linkedin_url returns empty rather than merging.

curl -X GET "https://www.trysignalbase.com/api/v2/companies?domain=novartis.com" \
  -H "Authorization: Bearer YOUR_API_KEY"

Key Features

Independent Querying: Browse companies without needing signal data
Full-text Search: Search across company name, industry, description, keywords, and specialties
Geographic Filtering: Filter by headquarters country
Industry Filtering: Filter by exact industry names
Numeric Range Filters: Filter by employee count and founded year ranges
Growth Data: Access headcount growth metrics (1m, 3m, 6m, 9m, 12m)
Flexible Sorting: Sort by name, employee count, founded year, or creation date
Pagination Support: Efficiently retrieve large datasets with up to 100 results per page
Credit-based Usage: Transparent credit consumption per API call

Service Level

Rate Limit: Based on your subscription tier
Uptime: 99% guaranteed uptime
Data Freshness: Company profiles are continuously updated
Maximum Results: Up to 100 results per page

Authentication

All API endpoints require a Bearer token in the Authorization header.

curl -X GET "https://www.trysignalbase.com/api/v2/companies?page=1&limit=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

Query Parameters

Pagination

Parameter	Type	Default	Description
`page`	integer	1	Page number
`limit`	integer	20	Results per page (max: 100)

Text Search

Parameter	Type	Description
`search`	string	Free-text search across company name, industry, description, keywords, and specialties

Identifier Lookup

Resolve a specific company by its canonical identifier — see Identifier Lookup.

Parameter	Type	Description
`domain`	string	Company website domain — exact match (e.g. `novartis.com`)
`linkedin_url`	string	Company LinkedIn URL — exact match (e.g. `linkedin.com/company/novartis`)

Filters

Parameter	Type	Description
`countries`	string	Comma-separated country codes (e.g., `US,GB,DE`). Allowlist
`exclude_countries`	string	Comma-separated country names or codes to exclude (denylist, e.g. `China` or `CN`). Complements `countries`; companies with an unknown HQ country are kept
`industry`	string	Comma-separated industry names — exact match (e.g., `Software,Technology`)
`categories`	string	Pipe-separated industry categories (e.g., `Technology\|Software`)
`subcategories`	string	Comma-separated subcategory IDs (e.g., `ai,fintech,saas`). See Subcategories

Numeric Range Filters

Parameter	Type	Description
`employee_count_min`	integer	Minimum employee count
`employee_count_max`	integer	Maximum employee count
`founded_year_min`	integer	Minimum founded year
`founded_year_max`	integer	Maximum founded year

Sorting

Parameter	Type	Default	Description
`sort_by`	string	`name`	Sort field: `name`, `employee_count`, `founded_year`, `created_at`
`sort_order`	string	`desc`	Sort direction: `asc` or `desc`

Response Structure

All successful responses follow this structure:

{
  "success": true,
  "data": [
    {
      "id": "uuid-here",
      "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",
      "logoUrl": "https://media.licdn.com/dms/image/example.png",
      "industry": "Technology",
      "foundedYear": 2018,
      "headquartersCountry": "US",
      "employeeCount": 250,
      "categories": ["Software", "SaaS"],
      "keywords": ["workflow automation", "enterprise"],
      "specialties": ["process automation"],
      "growthInfo": {
        "growth_1m": 1.2,
        "growth_3m": 3.5,
        "growth_6m": 8.1,
        "growth_9m": 12.0,
        "growth_12m": 18.5
      }
    }
  ],
  "pagination": {
    "currentPage": 1,
    "totalPages": 200,
    "totalCount": 4000,
    "hasNextPage": true,
    "hasPreviousPage": false
  },
  "meta": {
    "endpoint": "companies.list",
    "creditsUsed": 1
  }
}

Error Handling

The API returns standard HTTP status codes:

200: Success
400: Bad request — invalid domain or linkedin_url identifier syntax. Note: a valid identifier that resolves to no company returns 200 with an empty data set, not 400
401: Unauthorized - Invalid or missing API key
429: Rate limit exceeded
500: Internal server error

Error responses include:

{
  "success": false,
  "error": "Error message description"
}

Example Usage

Look up a company by domain

curl -X GET "https://www.trysignalbase.com/api/v2/companies?domain=novartis.com" \
  -H "Authorization: Bearer YOUR_API_KEY"

Look up a company by LinkedIn URL

curl -X GET "https://www.trysignalbase.com/api/v2/companies?linkedin_url=https://www.linkedin.com/company/novartis" \
  -H "Authorization: Bearer YOUR_API_KEY"

Search by Keyword and Country

curl -X GET "https://www.trysignalbase.com/api/v2/companies?search=AI&countries=US" \
  -H "Authorization: Bearer YOUR_API_KEY"

Filter by Industry and Employee Count

curl -X GET "https://www.trysignalbase.com/api/v2/companies?industry=Software&employee_count_min=50&employee_count_max=1000" \
  -H "Authorization: Bearer YOUR_API_KEY"

Filter by Founded Year with Sorting

curl -X GET "https://www.trysignalbase.com/api/v2/companies?founded_year_min=2020&sort_by=employee_count&sort_order=desc" \
  -H "Authorization: Bearer YOUR_API_KEY"

Combined Filters

curl -X GET "https://www.trysignalbase.com/api/v2/companies?search=cloud&countries=US,GB&employee_count_min=10&founded_year_min=2015&sort_by=name&sort_order=asc&limit=50" \
  -H "Authorization: Bearer YOUR_API_KEY"

​Welcome to the Companies API

Companies Endpoint

​Count Mode

​Identifier Lookup

​Key Features

​Service Level

​Authentication

​Query Parameters

​Pagination

​Text Search

​Identifier Lookup

​Filters

​Numeric Range Filters

​Sorting

​Response Structure

​Error Handling

​Example Usage

​Look up a company by domain

​Look up a company by LinkedIn URL

​Search by Keyword and Country

​Filter by Industry and Employee Count

​Filter by Founded Year with Sorting

​Combined Filters

Welcome to the Companies API

Count Mode

Identifier Lookup

Key Features

Service Level

Authentication

Query Parameters

Pagination

Text Search

Identifier Lookup

Filters

Numeric Range Filters

Sorting

Response Structure

Error Handling

Example Usage

Look up a company by domain

Look up a company by LinkedIn URL

Search by Keyword and Country

Filter by Industry and Employee Count

Filter by Founded Year with Sorting

Combined Filters