# TheirStack API Reference API

> TheirStack API Reference API on Apizie: 25 endpoints (Get Lists, Create List, Get List, Rename List, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://www.apizie.tech/v1/security:theirstack/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `security:theirstack`
- Category: Security
- Status: byok
- Source: https://theirstack.com
- Page: https://www.apizie.tech/api/security/theirstack
- OpenAPI: https://www.apizie.tech/api/security/theirstack/openapi.json

# Introduction Welcome to TheirStack’s API! You can use this API to access all our API endpoints, such as the [Jobs endpoint](https://api.theirstack.com) to get real-time and historical jobs from more than 100…

## Endpoints

### Get Lists
`GET https://www.apizie.tech/v1/security:theirstack/company-lists-get-all-lists` (byok)

### Create List
`POST https://www.apizie.tech/v1/security:theirstack/company-lists-create-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Get List
`GET https://www.apizie.tech/v1/security:theirstack/company-lists-get-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| list_id | integer | yes |  |

### Rename List
`POST https://www.apizie.tech/v1/security:theirstack/company-lists-rename-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| list_id | integer | yes |  |
| body | object | yes | JSON request body |

### Delete List
`POST https://www.apizie.tech/v1/security:theirstack/company-lists-remove-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| list_id | integer | yes |  |

### Get List Companies
`GET https://www.apizie.tech/v1/security:theirstack/company-lists-get-list-companies` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| list_id | integer | yes |  |
| order_by | string | no | Order by field |
| order_direction | string | no | Order direction |
| company_name_partial | string | no | Pass a partial company name to filter the list of companies |
| page | integer | no |  |
| limit | integer | no |  |

### Add Companies To List
`POST https://www.apizie.tech/v1/security:theirstack/company-lists-add-companies-to-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| list_id | integer | yes |  |
| body | object | no | JSON request body |

### Remove Companies From List
`POST https://www.apizie.tech/v1/security:theirstack/company-lists-remove-companies-from-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| list_id | integer | yes |  |
| body | object | no | JSON request body |

### Add Companies To Multiple Lists
`POST https://www.apizie.tech/v1/security:theirstack/company-lists-add-companies-to-multiple-lists` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Get Saved Searches
`GET https://www.apizie.tech/v1/security:theirstack/saved-searches-get-all` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| user_ids | array | no | Get saved searches from users with these IDs. The IDs must be from people in the current users' team. |
| types | array | no | Filter by type of search. For example, 'jobs' or 'tech_details' |
| order_by | string | no | Order by field |
| order_direction | string | no | Order direction |

### Create Saved Search
`POST https://www.apizie.tech/v1/security:theirstack/saved-searches-create-search` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Upsert Saved Search
`POST https://www.apizie.tech/v1/security:theirstack/saved-searches-upsert-saved-search` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Get Saved Search
`GET https://www.apizie.tech/v1/security:theirstack/saved-searches-get-details` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| search_id | integer | yes |  |

### Update Saved Search
`POST https://www.apizie.tech/v1/security:theirstack/saved-searches-update-search` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| search_id | integer | yes |  |
| body | object | yes | JSON request body |

### Delete Saved Search
`POST https://www.apizie.tech/v1/security:theirstack/saved-searches-delete-search` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| search_id | integer | yes |  |

### Get Technologies
`GET https://www.apizie.tech/v1/security:theirstack/catalog-get-technologies` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| name_pattern | string | no | Regex pattern of a technology name, case-insensitive |
| category_pattern | string | no | Regex pattern of a technology category, case-insensitive. For example, `data/storage/queue` to find data tools. |
| slug | array | no | Slug of one or many technologies |
| slugs | array | no | Slugs of one or many technologies |
| category_slug | string | no | Slug of a technology category |
| page | integer | no |  |
| limit | integer | no |  |

### Get Industries
`GET https://www.apizie.tech/v1/security:theirstack/catalog-get-industries` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| industry | string | no | Name of an industry, case-insensitive. Will return industries that contain the given string either in their name, hierarchy or description |
| page | integer | no |  |
| limit | integer | no |  |

### Get Jobs And Companies Per Job Country Code
`GET https://www.apizie.tech/v1/security:theirstack/catalog-get-jobs-and-companies-per-job-country-code` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| country | string | no | Name of a country. Will return any countries that contain the given string |
| page | integer | no |  |
| limit | integer | no |  |

### Get Companies Per Company Country Code
`GET https://www.apizie.tech/v1/security:theirstack/catalog-get-companies-per-country-code` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| country | string | no | Name of a country. Will return any countries that contain the given string |
| page | integer | no |  |
| limit | integer | no |  |

### Get Technology Categories
`GET https://www.apizie.tech/v1/security:theirstack/catalog-list-technology-categories` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| category_slug | string | no | Category slug |
| num_technologies_per_category | integer | no | Number of technologies per category |

### Search Jobs
`POST https://www.apizie.tech/v1/security:theirstack/jobs-search-by-criteria` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| page | integer | no | Page number. Will only apply when not passed in the body |
| limit | integer | no | Number of results per page. Will only apply when not passed in the body. |
| include_total_results | boolean | no | Whether to include the total number of results in the response. Will only apply when not passed in the body. |
| group_by | array | no | Group results by a given field and get the number of jobs per group. If you pass `company`, you'll get the number of jobs per company. If… |
| format | string | no | Format of the response. One of `json` or `csv`. Defaults to `json`. |
| body | object | yes | JSON request body |

### Search Companies
`POST https://www.apizie.tech/v1/security:theirstack/companies-search-filtered-data` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| format | string | no | Format of the response. One of `json` or `csv`. Defaults to `json`. |
| body | object | yes | JSON request body |

### Tech Details
`POST https://www.apizie.tech/v1/security:theirstack/companies-list-tech-details` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| format | string | no | Format of the response. One of `json` or `csv`. Defaults to `json`. |
| body | object | yes | JSON request body |

### Search Companies By Domain
`GET https://www.apizie.tech/v1/security:theirstack/companies-search-by-domain` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| domains | string | no | Comma-sep rated list of domains. Deprecated - use the `companies_urls` parameter instead. You can pass domains, emails or full URLs to it… |
| emails | string | no | Comma-sep rated list of emails. Deprecated - use the `companies_urls` parameter instead. You can pass domains, emails or full URLs to it… |
| format | string | no | Format of the response. One of `json` or `csv`. Defaults to `json`. |
| companies_urls | array | no | Array or comma-separated string containing domains, emails or full URLs. |

### Search Decision Makers
`GET https://www.apizie.tech/v1/security:theirstack/decision-makers-find-by-criteria` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| technology_pattern | string | no | Regex pattern to match any of the technologies we track, listed on the /technologies endpoint |
| job_title_pattern | string | no | Regex pattern to match job titles |
| country | string | no | Country name of the company to filter by. Case sensitive |
| min_employee_count | integer | no | Minimum number of employees |
| max_employee_count | integer | no | Minimum number of employees |
| description_pattern | string | no | Regex pattern to search in job descriptions. Case insensitive |
| companies_pattern | string | no | Regex pattern to match company names |
| fromage | integer | no | Number of days to look back for jobs |
| format | string | no | Format of the response. One of `json` or `csv`. Defaults to `json`. |
| page | integer | no |  |
| limit | integer | no |  |
| new_companies | string | no | If `true`, only companies that haven't been fetched by the user will be returned. Credits will be consumed. If `false`, only companies… |

## Example
```
curl "https://www.apizie.tech/v1/security:theirstack/company-lists-get-all-lists" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the TheirStack API Reference API?
Create a free Apizie key, then send GET https://www.apizie.tech/v1/security:theirstack/company-lists-get-all-lists with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the TheirStack API Reference API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. TheirStack API Reference itself also needs your own key from api.theirstack.com.

### Can AI agents use the TheirStack API Reference API?
Yes. Add the Apizie MCP server (https://www.apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key security:theirstack.

### What is the status of the TheirStack API Reference API?
Needs your own provider key (bring your own key)