{"openapi":"3.1.0","info":{"title":"TheirStack API Reference","description":"\n\n# Introduction\n\nWelcome to the TheirStack API - the largest database of jobs and technographics.\n<br>\n\nYou can use this API to access all our API endpoints, such as the [Jobs endpoint](#tag/jobs/POST/v1/jobs/search) to get real-time and historical jobs from more than 100 countries, the [Companies endpoint](#tag/companies/POST/v1/companies/search) to get a list of companies by the technology they use or by the roles they are hiring for, or \nthe [Technographics endpoint](#tag/companies/POST/v1/companies/technologies) to get a list of technologies used by a company.\n\nThe API is organized around [REST](https://en.wikipedia.org/wiki/REST). All requests should be made over SSL. All request and response bodies, including errors, are encoded in JSON.\n\nA Swagger UI of these docs is also available at [/openapi](/openapi).\n\n---\n\n# Authentication\n\nAuthentication is done via the API key which you can find in [your account settings](https://app.theirstack.com/settings/api).\nWhen making a call, you'll have to specify this API key with the Authorization header. Here's an example:\n\n```sh\nAuthorization: Bearer <token>\n```\n\n---\n\n# Pagination\n\nResponses that return a list of items are paginated. We offer two different pagination strategies:\n\n- **Page-based**: This method allows you to navigate through paginated data by specifying the `page` and `limit` parameters.  The `page` parameter indicates the page number you wish to retrieve, while the `limit` parameter specifies the maximum number of items to return per page. For POST requests, include these parameters in the request body. For GET requests, use them as query parameters.\n- **Offset-based**: This method allows you to navigate through paginated data by specifying the `offset` and `limit` parameters. The `offset` parameter indicates the starting point within the collection of results, while the `limit` parameter specifies the maximum number of items to return. For POST requests, include these parameters in the request body. For GET requests, use them as query parameters.\nSome of these endpoints also support the `include_total_results` body or query parameter. If you set it to `false`, the responses will be faster, and the field `total_results` of the response will be `null`.\n\n---\n\n# Rate Limit\n\nAll API endpoints are rate limited to ensure reliability and fair usage. When a limit is exceeded, the API returns **HTTP 429 Too Many Requests**. Limits are applied **per user** (or per API key) with sliding windows; multiple windows may apply simultaneously.\n\n## Tiered endpoints and limits\n\nEndpoints covered by tier-based limits:\n\n* POST `/v1/jobs/search` (Jobs Search)\n* POST `/v1/companies/search` (Companies Search)\n* POST `/v1/companies/technologies` (Technographics)\n\nShared limits across all three endpoints:\n\n| Tier | API limits                            |\n| ---- | ------------------------------------- |\n| Free | 4/second, 10/minute, 50/hour, 400/day |\n| Paid | 4/second                              |\n\n- **Paid tier** applies to users who have made at least one payment. \n- **Free tier** applies to all other users (users who have never paid or users without any payments done).\n\nMultiple limits are applied simultaneously. A request is rejected if it exceeds **any** active window.\n\n## Rate limit headers\n\nThe API returns rate limit information in every response. We follow the **IETF HTTPAPI draft** for RateLimit headers: [RateLimit header fields for HTTP](https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/). When multiple rate limits apply, header items are comma-separated and ordered consistently across headers.\n\n### IETF compliant headers\n\n- `RateLimit`: Current quota status per policy. Format: `\"<policy-name>\"; r=<remaining-requests>; t=<time-until-reset>; pk=<partition-key>`.\n- `RateLimit-Policy`: Applied policy definition. Format: `\"<policy-name>\"; q=<limit>; w=<window-seconds>`.\n\n### Other headers\n\nThese are included for client convenience:\n\n- `RateLimit-Limit`: Total allowed requests for each window\n- `RateLimit-Remaining`: Requests remaining in each window\n- `RateLimit-Reset`: Seconds until the current window resets\n\nThe order of values in legacy headers **matches the order of `RateLimit` items**.\n\nExample response headers:\n```\nRateLimit: \"per-second\";r=3;t=1;pk=\"dXNlcjoxMjM0\", \"per-minute\";r=9;t=60;pk=\"dXNlcjoxMjM0\", \"per-hour\";r=49;t=3600;pk=\"dXNlcjoxMjM0\", \"per-day\";r=399;t=86400;pk=\"dXNlcjoxMjM0\"\nRateLimit-Policy: \"per-second\";q=4;w=1, \"per-minute\";q=10;w=60, \"per-hour\";q=50;w=3600, \"per-day\";q=400;w=86400\nRateLimit-Limit: 4, 10, 50, 400\nRateLimit-Remaining: 3, 9, 49, 399\nRateLimit-Reset: 1, 60, 3600, 86400\n```\n\n## Exceeding limits and best practices\n\n* Retry with **exponential backoff** on HTTP 429 responses.\n* Monitor `RateLimit` or `RateLimit-Remaining` and `RateLimit-Reset` to avoid hitting limits.\n* Prefer batching and caching to reduce request counts.\n* Avoid concurrent bursts that violate per-second limits.\n\n---\n\n","version":"1.0.0"},"servers":[{"url":"https://api.theirstack.com","description":"Production"}],"paths":{"/v0/email-preferences":{"get":{"tags":["Email Preferences"],"summary":"Get Email Preferences","operationId":"get_email_preferences_v0","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailPreferencesResponseV0"}}}}},"security":[{"Bearer":[]}]},"put":{"tags":["Email Preferences"],"summary":"Update Email Preferences","operationId":"put_email_preferences_v0","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Body"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailPreferencesResponseV0"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"Bearer":[]}]}},"/v0/email-preferences/unsubscribe/{preference_key}":{"get":{"tags":["Email Preferences"],"summary":"Unsubscribe From Email","operationId":"unsubscribe_email_v0","parameters":[{"name":"preference_key","in":"path","required":true,"schema":{"type":"string","title":"Preference Key"}},{"name":"token","in":"query","required":true,"schema":{"type":"string","title":"Token"}}],"responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["Email Preferences"],"summary":"One-Click Unsubscribe (Rfc 8058)","operationId":"unsubscribe_email_one_click_v0","parameters":[{"name":"preference_key","in":"path","required":true,"schema":{"type":"string","title":"Preference Key"}},{"name":"token","in":"query","required":true,"schema":{"type":"string","title":"Token"}}],"requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Body_unsubscribe_email_one_click_v0"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v0/teams/credits_consumption":{"get":{"tags":["Credit Consumption"],"summary":"Get Credits Consumption","description":"Retrieve daily credit consumption data for your team showing the number of API records returned per day. Use this endpoint to monitor usage trends, track spending, and optimize your API integration.","operationId":"get_teams_credits_consumption_v0","security":[{"Bearer":[]}],"parameters":[{"name":"start_datetime","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"Start datetime in ISO format (e.g., 2023-01-01T00:00:00)","title":"Start Datetime"},"description":"Start datetime in ISO format (e.g., 2023-01-01T00:00:00)"},{"name":"end_datetime","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"End datetime in ISO format (e.g., 2023-01-01T23:59:59)","title":"End Datetime"},"description":"End datetime in ISO format (e.g., 2023-01-01T23:59:59)"},{"name":"timezone","in":"query","required":false,"schema":{"type":"string","description":"IANA timezone string (e.g., 'Europe/Madrid', 'America/New_York')","default":"UTC","title":"Timezone"},"description":"IANA timezone string (e.g., 'Europe/Madrid', 'America/New_York')"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CreditsConsumption"},"title":"Response Get Teams Credits Consumption V0"}}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Internal Server Error"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Bad Request"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Payment Required"}}}},"/v0/company_lists":{"get":{"tags":["Company Lists"],"summary":"List All Lists","description":"Retrieve all company lists for the current team including list name, company count, and creation date. Use company lists to organize and segment companies for targeted outreach and analysis.","operationId":"get_company_lists_v0","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/CompanyList"},"type":"array","title":"Response Get Company Lists V0"}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"Bearer":[]}]},"post":{"tags":["Company Lists"],"summary":"Create Company List","operationId":"post_company_lists_v0","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyListCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyList"}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"Bearer":[]}]}},"/v0/company_lists/{list_id}":{"get":{"tags":["Company Lists"],"summary":"Get List","operationId":"get_company_lists_by_id_v0","security":[{"Bearer":[]}],"parameters":[{"name":"list_id","in":"path","required":true,"schema":{"type":"integer","title":"List Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyList"}}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Internal Server Error"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Bad Request"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Payment Required"}}},"patch":{"tags":["Company Lists"],"summary":"Rename Company List","operationId":"patch_company_lists_by_id_v0","security":[{"Bearer":[]}],"parameters":[{"name":"list_id","in":"path","required":true,"schema":{"type":"integer","title":"List Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyListRename"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyList"}}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Internal Server Error"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Bad Request"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Payment Required"}}},"delete":{"tags":["Company Lists"],"summary":"Delete Company List","operationId":"delete_company_lists_by_id_v0","security":[{"Bearer":[]}],"parameters":[{"name":"list_id","in":"path","required":true,"schema":{"type":"integer","title":"List Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Internal Server Error"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Bad Request"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Payment Required"}}}},"/v0/company_lists/{list_id}/companies":{"get":{"tags":["Company Lists"],"summary":"Get Companies From List","operationId":"get_company_lists_companies_v0","security":[{"Bearer":[]}],"parameters":[{"name":"list_id","in":"path","required":true,"schema":{"type":"integer","title":"List Id"}},{"name":"order_by","in":"query","required":false,"schema":{"enum":["revealed_at","name"],"type":"string","description":"Order by field","default":"revealed_at","title":"Order By"},"description":"Order by field"},{"name":"order_direction","in":"query","required":false,"schema":{"enum":["asc","desc"],"type":"string","description":"Order direction","default":"desc","title":"Order Direction"},"description":"Order direction"},{"name":"company_name_partial","in":"query","required":false,"schema":{"type":"string","description":"Pass a partial company name to filter the list of companies","title":"Company Name Partial"},"description":"Pass a partial company name to filter the list of companies"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Number of results per page","default":25,"title":"Limit"},"description":"Number of results per page"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Page number. Required when using [page-based pagination](https://theirstack.com/en/docs/api-reference/pagination).","default":0,"title":"Page"},"description":"Page number. Required when using [page-based pagination](https://theirstack.com/en/docs/api-reference/pagination)."},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Number of results to skip. Required for [offset-based pagination](https://theirstack.com/en/docs/api-reference/pagination).","default":0,"title":"Offset"},"description":"Number of results to skip. Required for [offset-based pagination](https://theirstack.com/en/docs/api-reference/pagination)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CompanyListItem"},"title":"Response Get Company Lists Companies V0"}}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Internal Server Error"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Bad Request"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Payment Required"}}}},"/v0/company_lists/{list_id}/add_companies":{"post":{"tags":["Company Lists"],"summary":"Add Companies To List","operationId":"post_company_lists_add_companies_v0","security":[{"Bearer":[]}],"parameters":[{"name":"list_id","in":"path","required":true,"schema":{"type":"integer","title":"List Id"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body_post_company_lists_add_companies_v0"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyList"}}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Internal Server Error"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Bad Request"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Payment Required"}}}},"/v0/company_lists/{list_id}/duplicate":{"post":{"tags":["Company Lists"],"summary":"Duplicate List","operationId":"post_company_lists_duplicate_v0","security":[{"Bearer":[]}],"parameters":[{"name":"list_id","in":"path","required":true,"schema":{"type":"integer","title":"List Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyList"}}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Internal Server Error"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Bad Request"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Payment Required"}}}},"/v0/company_lists/{list_id}/remove_companies":{"post":{"tags":["Company Lists"],"summary":"Remove Companies From List","operationId":"post_company_lists_remove_companies_v0","security":[{"Bearer":[]}],"parameters":[{"name":"list_id","in":"path","required":true,"schema":{"type":"integer","title":"List Id"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body_post_company_lists_remove_companies_v0"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyList"}}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Internal Server Error"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Bad Request"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Payment Required"}}}},"/v0/company_lists/add_companies":{"post":{"tags":["Company Lists"],"summary":"Add Companies To Multiple Lists","operationId":"post_company_lists_add_companies_multiple_v0","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body_post_company_lists_add_companies_multiple_v0"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"Bearer":[]}]}},"/v0/company_lists/{list_id}/companies/export":{"get":{"tags":["Company Lists"],"summary":"Export Companies From List","description":"Export companies from a saved list to a downloadable CSV or XLSX file. The export includes company details such as domain, industry, size, location, funding, and revenue data for offline analysis.","operationId":"get_company_lists_companies_export_v0","deprecated":true,"security":[{"Bearer":[]}],"parameters":[{"name":"list_id","in":"path","required":true,"schema":{"type":"integer","title":"List Id"}},{"name":"file_format","in":"query","required":false,"schema":{"enum":["csv","xlsx"],"type":"string","description":"Export format","default":"csv","title":"File Format"},"description":"Export format"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Number of results per page","default":25,"title":"Limit"},"description":"Number of results per page"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Page number. Required when using [page-based pagination](https://theirstack.com/en/docs/api-reference/pagination).","default":0,"title":"Page"},"description":"Page number. Required when using [page-based pagination](https://theirstack.com/en/docs/api-reference/pagination)."},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Number of results to skip. Required for [offset-based pagination](https://theirstack.com/en/docs/api-reference/pagination).","default":0,"title":"Offset"},"description":"Number of results to skip. Required for [offset-based pagination](https://theirstack.com/en/docs/api-reference/pagination)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyListExportResponse"}}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Internal Server Error"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Bad Request"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Payment Required"}}}},"/v0/saved_searches":{"post":{"tags":["Saved Searches"],"summary":"Create Saved Search","operationId":"post_saved_searches_v0","security":[{"Bearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SavedSearchCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SavedSearch"}}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Internal Server Error"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Bad Request"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Payment Required"}}},"get":{"tags":["Saved Searches"],"summary":"List All Saved Searches","description":"Retrieve all active saved searches for the current user including search filters, type, and creation date. Archived saved searches are excluded. Filter by user IDs or search type and sort by name, created, or updated date.","operationId":"get_saved_searches_v0","security":[{"Bearer":[]}],"parameters":[{"name":"user_ids","in":"query","required":false,"schema":{"type":"array","items":{"type":"integer"},"description":"Get saved searches from users with these IDs. The IDs must be from people in the current users' team.","default":[],"title":"User Ids"},"description":"Get saved searches from users with these IDs. The IDs must be from people in the current users' team."},{"name":"types","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/SavedSearchType"}},{"type":"null"}],"description":"Filter by type of search","title":"Types"},"description":"Filter by type of search"},{"name":"order_by","in":"query","required":false,"schema":{"enum":["name","created_at","updated_at"],"type":"string","description":"Order by field","default":"updated_at","title":"Order By"},"description":"Order by field"},{"name":"order_direction","in":"query","required":false,"schema":{"enum":["asc","desc"],"type":"string","description":"Order direction","default":"desc","title":"Order Direction"},"description":"Order direction"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SavedSearchResponseV0"},"title":"Response Get Saved Searches V0"}}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Internal Server Error"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Bad Request"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Payment Required"}}}},"/v0/saved_searches/{search_id}":{"get":{"tags":["Saved Searches"],"summary":"Get Saved Search","operationId":"get_saved_searches_by_id_v0","security":[{"Bearer":[]}],"parameters":[{"name":"search_id","in":"path","required":true,"schema":{"type":"integer","description":"The ID of the saved search","title":"Search Id"},"description":"The ID of the saved search"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SavedSearchResponseV0"}}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Internal Server Error"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Bad Request"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Payment Required"}}},"patch":{"tags":["Saved Searches"],"summary":"Update Saved Search","operationId":"patch_saved_searches_by_id_v0","security":[{"Bearer":[]}],"parameters":[{"name":"search_id","in":"path","required":true,"schema":{"type":"integer","description":"The ID of the saved search","title":"Search Id"},"description":"The ID of the saved search"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SavedSearchUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SavedSearch"}}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Internal Server Error"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Bad Request"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Payment Required"}}}},"/v0/saved_searches/{search_id}/archive":{"patch":{"tags":["Saved Searches"],"summary":"Archive Saved Search","description":"Archive a saved search by its ID to remove it from the active list. Archived searches are hidden from the default listing but can still be referenced. Associated webhooks will stop triggering for archived searches.","operationId":"patch_saved_searches_archive_v0","security":[{"Bearer":[]}],"parameters":[{"name":"search_id","in":"path","required":true,"schema":{"type":"integer","description":"The ID of the saved search","title":"Search Id"},"description":"The ID of the saved search"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"string"},"title":"Response Patch Saved Searches Archive V0"}}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Internal Server Error"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Bad Request"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Payment Required"}}}},"/v0/requests/count":{"get":{"tags":["Requests"],"summary":"Get Request Count","description":"Retrieve the daily count of API requests made by your team within a specified date range. Use this endpoint to monitor API usage patterns, identify peak activity periods, and plan capacity.","operationId":"get_requests_count_v0","security":[{"Bearer":[]}],"parameters":[{"name":"start_datetime","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"Start datetime in ISO format (e.g., 2023-01-01T00:00:00)","title":"Start Datetime"},"description":"Start datetime in ISO format (e.g., 2023-01-01T00:00:00)"},{"name":"end_datetime","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"End datetime in ISO format (e.g., 2023-01-01T23:59:59)","title":"End Datetime"},"description":"End datetime in ISO format (e.g., 2023-01-01T23:59:59)"},{"name":"timezone","in":"query","required":false,"schema":{"type":"string","description":"IANA timezone string (e.g., 'Europe/Madrid', 'America/New_York')","default":"UTC","title":"Timezone"},"description":"IANA timezone string (e.g., 'Europe/Madrid', 'America/New_York')"},{"name":"is_origin_app","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Filter by origin app or api","title":"Is Origin App"},"description":"Filter by origin app or api"},{"name":"api_key_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Filter by API key id","title":"Api Key Id"},"description":"Filter by API key id"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/RequestCount"},"title":"Response Get Requests Count V0"}}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Internal Server Error"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Bad Request"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Payment Required"}}}},"/v1/datasets":{"get":{"tags":["Datasets"],"summary":"List Datasets","description":"Retrieve all datasets available for your team including jobs, companies, and technographics. Datasets are updated daily in Parquet format. Use this endpoint to get the latest download URLs for bulk data access.","operationId":"get_datasets_v1","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/DatasetGroup"},"type":"array","title":"Response Get Datasets V1"}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"Bearer":[]}]}},"/v1/datasets/credentials":{"post":{"tags":["Datasets"],"summary":"Generate Dataset Credentials","description":"Generate temporary S3 credentials to directly access and download dataset files from cloud storage. Credentials are valid for 7 days by default and provide read-only access to your team's available datasets.","operationId":"post_datasets_credentials_v1","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BucketCredentials"}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"Bearer":[]}]}},"/v0/catalog/keywords":{"get":{"tags":["Catalog"],"summary":"Get Technologies And Buying Intents","description":"List all keywords tracked by TheirStack, including both technologies and buying intent topics. Search for any keyword and filter by one or more categories.\n\nCalls to this endpoint don't cost you credits.\n\n- To get technologies only: filter with `keyword_type=technology`\n- To get only buying intent topics: filter with `keyword_type_not=technology`\n- By default this endpoint returns 25 keywords. To get all keywords, set `limit=100000`.\n\nResponse always includes `data` (array of keywords) and `metadata` (total_results, page, limit).","operationId":"get_catalog_keywords_v0","parameters":[{"name":"keyword_type","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/KeywordType"},{"type":"null"}],"description":"Keyword type to filter by","title":"Keyword Type"},"description":"Keyword type to filter by"},{"name":"keyword_type_not","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/KeywordType"}},{"type":"null"}],"description":"Exclude keywords of these types","title":"Keyword Type Not"},"description":"Exclude keywords of these types"},{"name":"name_pattern","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Case-insensitive text to search for in the keyword name","title":"Name Pattern"},"description":"Case-insensitive text to search for in the keyword name"},{"name":"slug","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"Keyword slug of a single keyword","deprecated":true,"title":"Slug"},"description":"Keyword slug of a single keyword","deprecated":true},{"name":"slugs","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"Keyword slugs of one or many keywords","title":"Slugs"},"description":"Keyword slugs of one or many keywords"},{"name":"category_pattern","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Case-insensitive text to search for in the keyword category. For example, `data` to find 'data tools'.","title":"Category Pattern"},"description":"Case-insensitive text to search for in the keyword category. For example, `data` to find 'data tools'."},{"name":"category_slug","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Keyword category slug","title":"Category Slug"},"description":"Keyword category slug"},{"name":"parent_category_slug","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Keyword parent category slug","title":"Parent Category Slug"},"description":"Keyword parent category slug"},{"name":"parent_category_pattern","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Case-insensitive text to search for in the keyword parent category name","title":"Parent Category Pattern"},"description":"Case-insensitive text to search for in the keyword parent category name"},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"General search query. Searches across keyword name, keyword type, category, and parent category (case-insensitive). Results where the keyword name starts with the query are ranked first.","title":"Q"},"description":"General search query. Searches across keyword name, keyword type, category, and parent category (case-insensitive). Results where the keyword name starts with the query are ranked first."},{"name":"starts_with","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter keywords whose name starts with this string (e.g. 'A' for glossary). Special value '__other__' selects keywords whose name does not start with letters A-Z.","title":"Starts With"},"description":"Filter keywords whose name starts with this string (e.g. 'A' for glossary). Special value '__other__' selects keywords whose name does not start with letters A-Z."},{"name":"include_metadata","in":"query","required":false,"schema":{"type":"boolean","description":"Deprecated, metadata is always included now","deprecated":true,"default":false,"title":"Include Metadata"},"description":"Deprecated, metadata is always included now","deprecated":true},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Page number.","default":0,"title":"Page"},"description":"Page number."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Number of results per page","default":25,"title":"Limit"},"description":"Number of results per page"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CatalogKeywordsResponse"}}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Internal Server Error"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Bad Request"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Payment Required"}}}},"/v0/catalog/jobs_companies_per_job_country_code":{"get":{"tags":["Catalog"],"summary":"Get Jobs And Companies Per Job Country Code","description":"This endpoint will return all the country codes and the number of jobs whose location's country code is the given one, and the number of companies with jobs in that country.\n\nCalls to this endpoint don't cost you credits.","operationId":"get_catalog_jobs_companies_per_job_country_code_v0","parameters":[{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Name of a country. Will return the country matching their name in English","title":"Country"},"description":"Name of a country. Will return the country matching their name in English"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Page number.","default":0,"title":"Page"},"description":"Page number."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Number of results per page","default":25,"title":"Limit"},"description":"Number of results per page"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobsCompaniesPerJobCountryCodeResponse"}}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Internal Server Error"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Bad Request"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Payment Required"}}}},"/v0/catalog/companies_per_company_country_code":{"get":{"tags":["Catalog"],"summary":"Get Companies Per Company Country Code","description":"Retrieve all ISO country codes with the number of companies headquartered in each country. Use this endpoint for geographic distribution analysis. Calls to this endpoint are free and do not consume any API credits.","operationId":"get_catalog_companies_per_company_country_code_v0","parameters":[{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Name of a country. Will return the country matching their name in English","title":"Country"},"description":"Name of a country. Will return the country matching their name in English"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Page number.","default":0,"title":"Page"},"description":"Page number."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Number of results per page","default":25,"title":"Limit"},"description":"Number of results per page"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompaniesPerCountryCodeResponse"}}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Internal Server Error"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Bad Request"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Payment Required"}}}},"/v0/catalog/locations":{"get":{"tags":["Catalog"],"summary":"Get Geographic Locations","description":"Search for geographic locations by name or ID to retrieve standardized location data including city, region, and country. Use location IDs with job_location_or and job_location_not filters for precise geographic targeting in job searches.","operationId":"get_catalog_locations_v0","security":[{"Bearer":[]}],"parameters":[{"name":"id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"array","items":{"type":"integer"}},{"type":"null"}],"description":"The ids of the locations","examples":[1,[2,3]],"title":"Id"},"description":"The ids of the locations"},{"name":"name","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Search value for the location, this will be used to filter the locations by name","examples":["Paris"],"title":"Name"},"description":"Search value for the location, this will be used to filter the locations by name"},{"name":"country_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The country code of the location, all the returned locations will be filtered by this country code","examples":["FR"],"title":"Country Code"},"description":"The country code of the location, all the returned locations will be filtered by this country code"},{"name":"feature_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"GeoNames feature code(s) to filter by location type (e.g. PPL=populated place, ADM1=first-order admin division). See https://www.geonames.org/export/codes.html","examples":["PPL",["PPL","PPLA"],"ADM1"],"title":"Feature Code"},"description":"GeoNames feature code(s) to filter by location type (e.g. PPL=populated place, ADM1=first-order admin division). See https://www.geonames.org/export/codes.html"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"The offset of the results","examples":[0,10],"default":0,"title":"Offset"},"description":"The offset of the results"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100000,"minimum":1,"description":"The limit of the results","examples":[10,5],"default":5,"title":"Limit"},"description":"The limit of the results"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/GeonameCatalogResponse"},"title":"Response Get Catalog Locations V0"}}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Internal Server Error"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Bad Request"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Payment Required"}}}},"/v0/catalog/industries":{"get":{"tags":["Catalog"],"summary":"Get Industries","description":"This endpoint lets you list all the industries and their codes, see how many jobs and companies we have per industry and search for an industry.\n\nCalls to this endpoint don't cost you credits.\n\nOur industries catalogue comes from [LinkedIn Industry Codes V2](https://learn.microsoft.com/en-us/linkedin/shared/references/reference-tables/industry-codes-v2)","operationId":"get_catalog_industries_v0","parameters":[{"name":"industry","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Name of an industry, case-insensitive. Will return industries that contain the given string either in their name, hierarchy or description","default":"","title":"Industry"},"description":"Name of an industry, case-insensitive. Will return industries that contain the given string either in their name, hierarchy or description"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Page number.","default":0,"title":"Page"},"description":"Page number."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Number of results per page","default":25,"title":"Limit"},"description":"Number of results per page"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IndustryStatsResponseV0"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v0/webhooks":{"get":{"tags":["Webhooks"],"summary":"List All Webhooks","description":"Retrieve all active webhooks configured for your team including their status, target URL, event type, and linked saved search. Archived webhooks are excluded from the response. Use this to monitor your webhook integrations.","operationId":"get_webhooks_v0","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/Webhook"},"type":"array","title":"Response Get Webhooks V0"}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"Bearer":[]}]},"post":{"tags":["Webhooks"],"summary":"Create New Webhook","description":"Create a new webhook that listens for events from a saved search and sends real-time HTTP POST notifications to your specified URL. Configure event types, filters, and delivery settings for automated data pipelines.","operationId":"post_webhooks_v0","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Webhook"}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"Bearer":[]}]}},"/v0/webhooks/test":{"post":{"tags":["Webhooks"],"summary":"Test Webhook Url","description":"Send a test event to verify connectivity and payload handling. Either provide a webhook_id to test an existing webhook (with optional url/secret overrides), or provide url and event_type directly to test before creating a webhook.","operationId":"post_webhooks_test_v0","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookTest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookTestResponse"}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"Bearer":[]}]}},"/v0/webhooks/{webhook_id}":{"get":{"tags":["Webhooks"],"summary":"Get Webhook By Id","description":"Retrieve the full details of a specific webhook by its ID including configuration, status, target URL, event type, linked saved search, and creation timestamp. Use this to inspect or debug a webhook setup.","operationId":"get_webhooks_by_id_v0","security":[{"Bearer":[]}],"parameters":[{"name":"webhook_id","in":"path","required":true,"schema":{"type":"integer","description":"ID of the webhook","examples":[123],"title":"Webhook Id"},"description":"ID of the webhook"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Webhook"}}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Internal Server Error"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Bad Request"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Payment Required"}}},"patch":{"tags":["Webhooks"],"summary":"Update Webhook","operationId":"patch_webhooks_by_id_v0","security":[{"Bearer":[]}],"parameters":[{"name":"webhook_id","in":"path","required":true,"schema":{"type":"integer","description":"ID of the webhook","examples":[123],"title":"Webhook Id"},"description":"ID of the webhook"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Webhook"}}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Internal Server Error"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Bad Request"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Payment Required"}}}},"/v0/webhooks/{webhook_id}/status":{"patch":{"tags":["Webhooks"],"summary":"Enable/Disable A Webhook","description":"By disabling a webhook, it will stop listening to events. When you enable a webhook, it will process all the events that have not been processed yet since you disabled it.","operationId":"patch_webhooks_status_v0","security":[{"Bearer":[]}],"parameters":[{"name":"webhook_id","in":"path","required":true,"schema":{"type":"integer","description":"ID of the webhook","examples":[123],"title":"Webhook Id"},"description":"ID of the webhook"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookStatusUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Webhook"}}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Internal Server Error"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Bad Request"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Payment Required"}}}},"/v0/webhooks/{webhook_id}/archive":{"patch":{"tags":["Webhooks"],"summary":"Archive Webhook","description":"Archive a webhook by its ID to permanently stop event delivery and remove it from the active webhook list. Archived webhooks and their event history are retained for reference but will no longer trigger notifications.","operationId":"patch_webhooks_archive_v0","security":[{"Bearer":[]}],"parameters":[{"name":"webhook_id","in":"path","required":true,"schema":{"type":"integer","description":"ID of the webhook","examples":[123],"title":"Webhook Id"},"description":"ID of the webhook"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Webhook"}}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Internal Server Error"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Bad Request"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Payment Required"}}}},"/v0/webhooks/{webhook_id}/events":{"get":{"tags":["Webhooks"],"summary":"List Webhook Events","description":"Retrieve a paginated list of all events triggered for a specific webhook including delivery status, payload, and timestamps. Filter by event status to find failed deliveries that may need to be retried.","operationId":"get_webhooks_events_v0","security":[{"Bearer":[]}],"parameters":[{"name":"webhook_id","in":"path","required":true,"schema":{"type":"integer","description":"ID of the webhook","examples":[123],"title":"Webhook Id"},"description":"ID of the webhook"},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/WebhookEventStatus"},{"type":"null"}],"description":"Status of the webhook events to filter by","title":"Status"},"description":"Status of the webhook events to filter by"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Number of results to skip","default":0,"title":"Offset"},"description":"Number of results to skip"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"description":"Number of results per page","default":25,"title":"Limit"},"description":"Number of results per page"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/WebhookEvent"},"title":"Response Get Webhooks Events V0"}}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Internal Server Error"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Bad Request"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Payment Required"}}}},"/v0/webhooks/{webhook_id}/events/count":{"get":{"tags":["Webhooks"],"summary":"Get Webhook Event Count","description":"Get the total count of events triggered for a specific webhook. Use this endpoint to quickly check webhook activity volume without fetching the full event list, useful for monitoring dashboards and usage tracking.","operationId":"get_webhooks_events_count_v0","security":[{"Bearer":[]}],"parameters":[{"name":"webhook_id","in":"path","required":true,"schema":{"type":"integer","description":"ID of the webhook","examples":[123],"title":"Webhook Id"},"description":"ID of the webhook"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"integer","title":"Response Get Webhooks Events Count V0"}}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Internal Server Error"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Bad Request"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Payment Required"}}}},"/v0/webhooks/events/count":{"get":{"tags":["Webhooks"],"summary":"Get Aggregated Webhook Event Count","description":"Retrieve webhook event counts aggregated by day within a date range, with options to group by delivery status or webhook ID. Use this endpoint to build time-series charts for monitoring webhook performance and reliability.","operationId":"get_webhooks_events_count_aggregated_v0","security":[{"Bearer":[]}],"parameters":[{"name":"start_datetime","in":"query","required":false,"schema":{"type":"string","format":"date-time","description":"Start datetime in ISO format (e.g., 2023-01-01T00:00:00)","default":"2026-04-10T12:52:51.519716Z","title":"Start Datetime"},"description":"Start datetime in ISO format (e.g., 2023-01-01T00:00:00)"},{"name":"end_datetime","in":"query","required":false,"schema":{"type":"string","format":"date-time","description":"End datetime in ISO format (e.g., 2023-01-01T23:59:59)","default":"2026-05-10T12:52:51.519725Z","title":"End Datetime"},"description":"End datetime in ISO format (e.g., 2023-01-01T23:59:59)"},{"name":"timezone","in":"query","required":false,"schema":{"type":"string","description":"IANA timezone string (e.g., 'Europe/Madrid', 'America/New_York')","default":"UTC","title":"Timezone"},"description":"IANA timezone string (e.g., 'Europe/Madrid', 'America/New_York')"},{"name":"webhook_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Webhook ID","title":"Webhook Id"},"description":"Webhook ID"},{"name":"group_by","in":"query","required":false,"schema":{"$ref":"#/components/schemas/WebhookGroupBy","description":"How to group the results: by status or webhook_id","default":"status"},"description":"How to group the results: by status or webhook_id"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/WebhookEventCount"},"title":"Response Get Webhooks Events Count Aggregated V0"}}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Internal Server Error"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Bad Request"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Payment Required"}}}},"/v0/webhooks/events/retry":{"post":{"tags":["Webhooks"],"summary":"Retry Webhook Events","description":"Retry delivery of failed webhook events by providing their event IDs. Use this endpoint to recover from transient failures such as network timeouts or temporary server errors on your receiving endpoint.","operationId":"post_webhooks_events_retry_v0","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEventRetryRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"Bearer":[]}]}},"/v1/catalog/keywords/categories":{"get":{"tags":["Catalog"],"summary":"Get Keyword Categories","description":"Returns a list of main keyword categories (technologies and buying intents) with the number of keywords and companies in each. Optionally filters to return a specific category if category_slug is provided.","operationId":"list_keyword_categories_v1","parameters":[{"name":"category_slug","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional category slug to filter and return only a specific category","examples":["finance-and-accounting"],"title":"Category Slug"},"description":"Optional category slug to filter and return only a specific category"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KeywordParentCategoryResponse"}}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Internal Server Error"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Bad Request"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Payment Required"}}}},"/v1/catalog/keywords/subcategories":{"get":{"tags":["Catalog"],"summary":"Get Keyword Subcategories","description":"Returns a list of keyword subcategories with their keywords. Behavior: returns all subcategories if no parameters are provided; returns all subcategories for a specific parent category if only category_slug is provided; returns a specific subcategory if both category_slug and subcategory_slug are provided.","operationId":"list_keyword_subcategories_v1","parameters":[{"name":"subcategory_slug","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Subcategory slug to filter by a specific subcategory. Must be used together with category_slug.","examples":["account-reconciliation"],"title":"Subcategory Slug"},"description":"Subcategory slug to filter by a specific subcategory. Must be used together with category_slug."},{"name":"category_slug","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Parent category slug to filter subcategories. If provided with subcategory_slug, returns only that specific subcategory. If provided alone, returns all subcategories for that parent category.","examples":["finance-and-accounting"],"title":"Category Slug"},"description":"Parent category slug to filter subcategories. If provided with subcategory_slug, returns only that specific subcategory. If provided alone, returns all subcategories for that parent category."},{"name":"num_technologies_per_category","in":"query","required":false,"schema":{"type":"integer","description":"Number of keywords per category to include in the response","default":5,"title":"Num Technologies Per Category"},"description":"Number of keywords per category to include in the response"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KeywordCategoryResponse"}}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Internal Server Error"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Bad Request"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Payment Required"}}}},"/v1/jobs/search":{"post":{"tags":["Jobs"],"summary":"Job Search","description":"This endpoint lets you search for jobs posted on thousands of websites and filter by multiple filters, such as job titles, companies, locations, company attributes, dates and many more.\n\nIt consumes **1 API credit** for each job returned in the response.\n\nYou must specify at least one of the following filters, or otherwise your request will fail: `posted_at_max_age_days`, `posted_at_gte`, `posted_at_lte`, `company_domain_or`, `company_linkedin_url_or`, `company_name_or`. This is for performance reasons.\n\nTo retrieve jobs from a specific company or a list of companies, you can apply any of the following filters: `company_domain_or`, `company_linkedin_url_or`, `company_name_or`, `company_name_case_insensitive_or`. When using multiple company identifier filters, the endpoint will return jobs from companies that match any of the specified identifiers. Therefore, it is advisable to create a separate request for each company if you intend to use more than one identifier.\n\nThis endpoint is used by job seekers and sales/marketing teams to search for jobs filtered by country, job title, technologies, job description, company name, company domain, or date range—see the payload examples below for specific use cases.\n\nUseful resources: [Avoiding getting the same job twice](https://theirstack.com/en/docs/api/avoid-getting-same-jobs-twice), [Fetching jobs periodically](https://theirstack.com/en/docs/guides/fetch-jobs-periodically), [Preview data mode](https://theirstack.com/en/docs/api/preview-data-mode), [Free count mode](https://theirstack.com/en/docs/api/free-count)","operationId":"search_jobs_v1","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobSearchFilters-Input"},"examples":{"country_us_last_7_days":{"summary":"Jobs posted in the US in the last 7 days","value":{"page":0,"limit":25,"job_country_code_or":["US"],"posted_at_max_age_days":7}},"country_us_last_7_days_with_total_results":{"summary":"Jobs posted in the US in the last 7 days, including total results (will be slower)","value":{"page":0,"limit":25,"job_country_code_or":["US"],"posted_at_max_age_days":7,"include_total_results":true}},"software_engineer_last_7_days":{"summary":"Jobs posted in the last 7 days from UK companies with 'software engineer' in the title","value":{"page":0,"limit":25,"job_title_or":["Software engineer"],"posted_at_max_age_days":7,"company_country_code_or":["GB"]}},"analytics_jobs_last_30_days":{"summary":"Jobs posted in the last 30 days with 'analytics' in the description","value":{"page":0,"limit":25,"posted_at_max_age_days":30,"job_description_pattern_or":["analytics"]}},"postgres_jobs_current_month":{"summary":"Jobs posted in the current month that mention Postgres or MySQL","value":{"page":0,"limit":25,"posted_at_gte":"2026-05-01","posted_at_lte":"2026-05-10","company_technology_slug_or":[]}},"jobs_from_google_apple_tesla_nvidia_last_60_days":{"summary":"Jobs from Google, Apple, Tesla, or NVIDIA posted in the last 60 days","value":{"page":0,"limit":25,"posted_at_max_age_days":60,"company_name_or":["Google","Apple","Tesla","NVIDIA"]}},"jobs_from_google_apple_tesla_nvidia_last_60_days_by_domain":{"summary":"Jobs from Google, Apple, Tesla, or Nvidia posted in the last 60 days, filtered by domain","value":{"page":0,"limit":25,"posted_at_max_age_days":60,"company_domain_or":["google.com","apple.com","tesla.com","nvidia.com"]}},"default_params":{"summary":"All available parameters","value":{"order_by":[{"desc":true,"field":"date_posted"},{"desc":true,"field":"discovered_at"}],"offset":0,"page":0,"limit":25,"job_title_or":[],"job_title_not":[],"job_title_pattern_and":[],"job_title_pattern_or":[],"job_title_pattern_not":[],"job_country_code_or":[],"job_country_code_not":[],"posted_at_max_age_days":7,"job_description_pattern_or":[],"job_description_pattern_not":[],"job_description_pattern_and":[],"job_description_pattern_is_case_insensitive":true,"job_description_contains_or":[],"job_description_contains_not":[],"job_description_pattern_case_sensitive_or":[],"job_id_or":[],"job_id_not":[],"job_ids":[],"job_seniority_or":[],"job_technology_slug_or":[],"job_technology_slug_not":[],"job_technology_slug_and":[],"job_keyword_slug_or":[],"job_keyword_slug_and":[],"job_keyword_slug_not":[],"job_location_pattern_or":[],"job_location_pattern_not":[],"job_location_or":[],"job_location_not":[],"url_domain_or":[],"url_domain_not":[],"scraper_name_pattern_or":[],"company_name_or":[],"company_name_case_insensitive_or":[],"company_id_or":[],"company_domain_or":[],"company_domain_not":[],"company_name_not":[],"company_name_partial_match_or":[],"company_name_partial_match_not":[],"company_linkedin_url_or":[],"blur_company_data":false,"property_exists_or":[],"property_exists_and":[],"company_description_pattern_or":[],"company_description_pattern_not":[],"company_description_pattern_accent_insensitive":false,"funding_stage_or":[],"industry_or":[],"industry_not":[],"industry_id_or":[],"industry_id_not":[],"company_tags_or":[],"company_investors_or":[],"company_investors_partial_match_or":[],"company_technology_slug_or":[],"company_technology_slug_and":[],"company_technology_slug_not":[],"company_keyword_slug_or":[],"company_keyword_slug_and":[],"company_keyword_slug_not":[],"only_yc_companies":false,"company_location_pattern_or":[],"company_country_code_or":[],"company_country_code_not":[],"company_list_id_or":[],"company_list_id_not":[],"include_total_results":false}}}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobSearchResponse"}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"Bearer":[]}]}},"/v1/companies/search":{"post":{"tags":["Companies"],"summary":"Company Search","description":"This endpoint lets you search for companies by technology stack, hiring signals, and firmographics. It returns a list of companies that match the search criteria, along with the jobs and technology objects for each company that match the filters you've passed.\n\nIt consumes **3 API credits** for each company returned in the response.\n\nUseful resources: [Preview data mode](https://theirstack.com/en/docs/api/preview-data-mode),  [Free count mode](https://theirstack.com/en/docs/api/free-count)\n\nThe response includes both company data and any matching jobs or technologies based on your filters.","operationId":"search_companies_v1","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanySearchFilters-Input"},"examples":{"us_companies":{"summary":"US companies","value":{"order_by":[{"desc":true,"field":"employee_count"}],"page":0,"limit":25,"company_country_code_or":["US"]}},"us_companies_using_snowflake":{"summary":"US companies using Snowflake","value":{"order_by":[{"desc":true,"field":"employee_count"}],"page":0,"limit":25,"company_technology_slug_or":["snowflake"]}},"startups_with_recent_funding":{"summary":"Companies with $1M - $10M in funding","value":{"order_by":[{"desc":true,"field":"total_funding_usd"}],"page":0,"limit":25,"min_funding_usd":1000000,"max_funding_usd":10000000}},"companies_hiring_software_engineers_recently":{"summary":"Companies hiring software engineers in the last 30 days","value":{"order_by":[{"desc":true,"field":"employee_count"}],"page":0,"limit":25,"job_filters":{"job_title_or":[],"job_title_not":[],"job_title_pattern_and":[],"job_title_pattern_or":["software engineer"],"job_title_pattern_not":[],"job_country_code_or":[],"job_country_code_not":[],"posted_at_gte":"2026-04-10","job_description_pattern_or":[],"job_description_pattern_not":[],"job_description_pattern_and":[],"job_description_pattern_is_case_insensitive":true,"job_description_contains_or":[],"job_description_contains_not":[],"job_description_pattern_case_sensitive_or":[],"job_id_or":[],"job_id_not":[],"job_ids":[],"job_seniority_or":[],"job_technology_slug_or":[],"job_technology_slug_not":[],"job_technology_slug_and":[],"job_keyword_slug_or":[],"job_keyword_slug_and":[],"job_keyword_slug_not":[],"job_location_pattern_or":[],"job_location_pattern_not":[],"job_location_or":[],"job_location_not":[],"url_domain_or":[],"url_domain_not":[],"scraper_name_pattern_or":[]}}},"ai_companies_with_recent_job_postings":{"summary":"AI companies with recent job postings","value":{"order_by":[{"desc":true,"field":"employee_count"}],"page":0,"limit":25,"company_description_pattern_or":["artificial intelligence","machine learning","deep learning","neural networks","reinforcement learning","natural language processing","computer vision","generative models","transformer models","\\bllms?\\b","\\bnlp\\b"],"job_filters":{"job_title_or":[],"job_title_not":[],"job_title_pattern_and":[],"job_title_pattern_or":[],"job_title_pattern_not":[],"job_country_code_or":[],"job_country_code_not":[],"posted_at_max_age_days":30,"job_description_pattern_or":[],"job_description_pattern_not":[],"job_description_pattern_and":[],"job_description_pattern_is_case_insensitive":true,"job_description_contains_or":[],"job_description_contains_not":[],"job_description_pattern_case_sensitive_or":[],"job_id_or":[],"job_id_not":[],"job_ids":[],"job_seniority_or":[],"job_technology_slug_or":[],"job_technology_slug_not":[],"job_technology_slug_and":[],"job_keyword_slug_or":[],"job_keyword_slug_and":[],"job_keyword_slug_not":[],"job_location_pattern_or":[],"job_location_pattern_not":[],"job_location_or":[],"job_location_not":[],"url_domain_or":[],"url_domain_not":[],"scraper_name_pattern_or":[]}}},"companies_using_react_recently_with_high_confidence":{"summary":"Companies that started using or showing interest in React lately","value":{"order_by":[{"desc":true,"field":"employee_count"}],"page":0,"limit":25,"company_technology_slug_or":["react"],"tech_filters":{"keyword_slug_or":[],"keyword_category_slug_or":[],"keyword_parent_category_slug_or":[],"technology_slug_or":[],"technology_category_slug_or":[],"technology_parent_category_slug_or":[],"confidence_or":["high"]}}},"companies_using_aws_and_react":{"summary":"Companies using both AWS and React","value":{"order_by":[{"desc":true,"field":"employee_count"}],"page":0,"limit":25,"company_technology_slug_and":["aws","react"]}},"large_companies_in_finance":{"summary":"Large companies in the finance sector","value":{"order_by":[{"desc":true,"field":"annual_revenue_usd"}],"page":0,"limit":25,"min_employee_count":10000,"industry_id_or":[43]}},"companies_with_yc_backing":{"summary":"Y Combinator backed companies","value":{"order_by":[{"desc":true,"field":"employee_count"}],"page":0,"limit":25,"only_yc_companies":true}},"default_params":{"summary":"All available parameters","value":{"expand_technology_slugs":[],"order_by":[{"desc":true,"field":"employee_count"}],"company_name_or":[],"company_name_case_insensitive_or":[],"company_id_or":[],"company_domain_or":[],"company_domain_not":[],"company_name_not":[],"company_name_partial_match_or":[],"company_name_partial_match_not":[],"company_linkedin_url_or":[],"blur_company_data":false,"property_exists_or":[],"property_exists_and":[],"offset":0,"page":0,"limit":25,"company_description_pattern_or":[],"company_description_pattern_not":[],"company_description_pattern_accent_insensitive":false,"funding_stage_or":[],"industry_or":[],"industry_not":[],"industry_id_or":[],"industry_id_not":[],"company_tags_or":[],"company_investors_or":[],"company_investors_partial_match_or":[],"company_technology_slug_or":[],"company_technology_slug_and":[],"company_technology_slug_not":[],"company_keyword_slug_or":[],"company_keyword_slug_and":[],"company_keyword_slug_not":[],"only_yc_companies":false,"company_location_pattern_or":[],"company_country_code_or":[],"company_country_code_not":[],"company_list_id_or":[],"company_list_id_not":[],"include_total_results":false,"job_filters":{"job_title_or":[],"job_title_not":[],"job_title_pattern_and":[],"job_title_pattern_or":[],"job_title_pattern_not":[],"job_country_code_or":[],"job_country_code_not":[],"job_description_pattern_or":[],"job_description_pattern_not":[],"job_description_pattern_and":[],"job_description_pattern_is_case_insensitive":true,"job_description_contains_or":[],"job_description_contains_not":[],"job_description_pattern_case_sensitive_or":[],"job_id_or":[],"job_id_not":[],"job_ids":[],"job_seniority_or":[],"job_technology_slug_or":[],"job_technology_slug_not":[],"job_technology_slug_and":[],"job_keyword_slug_or":[],"job_keyword_slug_and":[],"job_keyword_slug_not":[],"job_location_pattern_or":[],"job_location_pattern_not":[],"job_location_or":[],"job_location_not":[],"url_domain_or":[],"url_domain_not":[],"scraper_name_pattern_or":[]},"tech_filters":{"keyword_slug_or":[],"keyword_category_slug_or":[],"keyword_parent_category_slug_or":[],"technology_slug_or":[],"technology_category_slug_or":[],"technology_parent_category_slug_or":[],"confidence_or":[]}}}}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanySearchResponse"}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"Bearer":[]}]}},"/v1/companies/technologies":{"post":{"tags":["Companies"],"summary":"Technographics","description":"This endpoint lists the technologies used by a company. For each technology, it returns the confidence level (`low`, `medium`, `high`), the number of jobs that mention the technology, and the first and last dates it was mentioned.\n\nYou must specify `company_domain`, `company_name`, `company_linkedin_url`.\n\nIt consumes **3 API credits** per company lookup, regardless of the number of technologies returned. It doesn't consume credits if there is no response.","operationId":"technographics_v1","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TechnographicsFilters"},"examples":{"google_technographics":{"summary":"Technologies used by google.com (Domain)","value":{"company_domain":"google.com"}},"databases_used_by_microsoft":{"summary":"Databases used by Microsoft (Name)","value":{"company_name":"Microsoft","keyword_category_slug_or":["relational-databases"],"technology_category_slug_or":["relational-databases"]}},"open_ai_technographics":{"summary":"Technologies used by OpenAI (LinkedIn URL)","value":{"company_linkedin_url":"https://www.linkedin.com/company/openai/"}},"is_apple_using_python":{"summary":"Is Apple using Python?","value":{"company_domain":"apple.com","keyword_slug_or":["python"],"technology_slug_or":["python"]}},"default_params":{"summary":"All available parameters","value":{"company_name_or":["Google"],"order_by":[{"desc":true,"field":"confidence"},{"desc":true,"field":"jobs"}],"include_total_results":false,"keyword_slug_or":[],"keyword_category_slug_or":[],"keyword_parent_category_slug_or":[],"technology_slug_or":[],"technology_category_slug_or":[],"technology_parent_category_slug_or":[],"confidence_or":[],"keyword_type_or":[],"keyword_type_not":[]}}}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyKeywordsResponse"}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"Bearer":[]}]}},"/v1/companies/buying_intents":{"post":{"tags":["Companies"],"summary":"Buying Intents","description":"This endpoint lists the buying intent topics detected for a company. For each topic, it returns the confidence level (`low`, `medium`, `high`), the number of jobs that mention the topic, and the first and last dates it was mentioned.\n\nYou must specify `company_domain`, `company_name`, `company_linkedin_url`.\n\nIt consumes **3 API credits** per company lookup, regardless of the number of buying intent topics returned. It doesn't consume credits if there is no response.","operationId":"buying_intents_v1","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TechnographicsFilters"},"examples":{"google_buying_intents":{"summary":"Buying intent topics for google.com (Domain)","value":{"company_domain":"google.com"}},"microsoft_buying_intents":{"summary":"Buying intent topics for Microsoft (Name)","value":{"company_name":"Microsoft"}},"open_ai_buying_intents":{"summary":"Buying intent topics for OpenAI (LinkedIn URL)","value":{"company_linkedin_url":"https://www.linkedin.com/company/openai/"}},"default_params":{"summary":"All available parameters","value":{"company_name_or":["Google"],"order_by":[{"desc":true,"field":"confidence"},{"desc":true,"field":"jobs"}],"include_total_results":false,"keyword_slug_or":[],"keyword_category_slug_or":[],"keyword_parent_category_slug_or":[],"technology_slug_or":[],"technology_category_slug_or":[],"technology_parent_category_slug_or":[],"confidence_or":[],"keyword_type_or":[],"keyword_type_not":[]}}}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyKeywordsResponse"}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"Bearer":[]}]}},"/v0/billing/credit-balance":{"get":{"tags":["Billing"],"summary":"Get Credit Balance","description":"Retrieve your team's current credit balance including remaining credits available for API calls, searches, and data exports across all endpoints.","operationId":"get_billing_credit_balance_v0","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreditsBalance"}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"Bearer":[]}]}}},"webhooks":{"job-new":{"post":{"tags":["Webhooks"],"summary":"Job.New","description":"Triggered when a new job matching your saved search criteria is discovered. [Learn more about webhooks](https://theirstack.com/en/docs/webhooks).","operationId":"webhook_job_new","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookPublicEvent"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"company-new":{"post":{"tags":["Webhooks"],"summary":"Company.New","description":"Triggered when a new company matching your saved search criteria is discovered. [Learn more about webhooks](https://theirstack.com/en/docs/webhooks).","operationId":"webhook_company_new","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookPublicEvent"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"BaseMetadata":{"properties":{"total_results":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Results","description":"Total number of results","examples":[2034]}},"type":"object","title":"BaseMetadata"},"Body_post_company_lists_add_companies_multiple_v0":{"properties":{"list_ids":{"items":{"type":"integer"},"type":"array","title":"List Ids","description":"List ids to add companies to","default":[]},"company_ids":{"items":{"type":"string"},"type":"array","title":"Company Ids","description":"Company IDs (encrypted slugs) to add to the list","default":[]}},"type":"object","title":"Body_post_company_lists_add_companies_multiple_v0"},"Body_post_company_lists_add_companies_v0":{"properties":{"company_ids":{"items":{"type":"string"},"type":"array","title":"Company Ids","description":"Company IDs (encrypted slugs) to add to the list","default":[],"examples":[["jzZtZUAlXO/EX2wK4o6/Jw=="],["Zhp1blVM6WuoHvhFmHlRww==","EYu9fMqOIuJkmaLobIjPqA=="]]},"company_names":{"items":{"type":"string"},"type":"array","title":"Company Names","description":"Company names to add to the list. Please don't use this filter anymore, use the `company_ids` filter instead.","default":[],"deprecated":true}},"type":"object","title":"Body_post_company_lists_add_companies_v0"},"Body_post_company_lists_remove_companies_v0":{"properties":{"company_ids":{"items":{"type":"string"},"type":"array","title":"Company Ids","description":"Company names to remove from the list","default":[],"examples":[["jzZtZUAlXO/EX2wK4o6/Jw=="],["Zhp1blVM6WuoHvhFmHlRww==","EYu9fMqOIuJkmaLobIjPqA=="]]}},"type":"object","title":"Body_post_company_lists_remove_companies_v0"},"Body_unsubscribe_email_one_click_v0":{"properties":{"list_unsubscribe":{"type":"string","title":"List Unsubscribe","default":"One-Click"}},"type":"object","title":"Body_unsubscribe_email_one_click_v0"},"BucketCredentials":{"properties":{"access_key_id":{"type":"string","title":"Access Key Id","description":"The access key id for the temporary credential","examples":["a3f8b2c9d1e4f5a6b7c8d9e0f1a2b3c4"]},"secret_access_key":{"type":"string","title":"Secret Access Key","description":"The secret access key for the temporary credential","examples":["7e9a2b4c6d8e0f1a3b5c7d9e1f3a5b7c9d1e3f5a"]},"session_token":{"type":"string","title":"Session Token","description":"The session token for the temporary credential","examples":["ZXlKaGJHY2lPaUpTVXpJMU5pSXNJblI1Y0NJNklrcFhWQ0o5LmV5SmlkV05yWlhRa"]},"expiration":{"type":"string","format":"date-time","title":"Expiration","description":"The expiration date of the temporary credential","examples":["2025-01-15T14:30:00Z"]},"storage":{"$ref":"#/components/schemas/StorageConfig","description":"Storage configuration including bucket name and endpoint URL"}},"type":"object","required":["access_key_id","secret_access_key","session_token","expiration","storage"],"title":"BucketCredentials"},"CatalogKeywordsMetadata":{"properties":{"total_results":{"type":"integer","title":"Total Results","description":"Total number of keywords"},"page":{"type":"integer","title":"Page","description":"Current page (0-based)"},"limit":{"type":"integer","title":"Limit","description":"Page size"}},"type":"object","required":["total_results","page","limit"],"title":"CatalogKeywordsMetadata"},"CatalogKeywordsResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/KeywordAggregated"},"type":"array","title":"Data"},"metadata":{"$ref":"#/components/schemas/CatalogKeywordsMetadata"}},"type":"object","required":["metadata"],"title":"CatalogKeywordsResponse"},"ColumnSortCompanySearch":{"properties":{"desc":{"type":"boolean","title":"Desc","description":"Whether to order by descending or ascending values","default":true},"field":{"type":"string","enum":["name","num_jobs","num_jobs_last_30_days","num_jobs_found","employee_count","alexa_ranking","founded_year","annual_revenue_usd","total_funding_usd","last_funding_round_date","confidence","jobs","first_date_found"],"title":"Field","description":"Order the results by some of these fields"}},"additionalProperties":false,"type":"object","required":["field"],"title":"ColumnSortCompanySearch"},"ColumnSortCompanyTechDetails":{"properties":{"desc":{"type":"boolean","title":"Desc","description":"Whether to order by descending or ascending values","default":true},"field":{"enum":[null,"jobs","jobs_last_7_days","jobs_last_30_days","jobs_last_180_days","last_date_found","first_date_found","relative_occurrence_within_category","theirstack_score","confidence"],"title":"Field","description":"Order the results by some of these fields"}},"additionalProperties":false,"type":"object","title":"ColumnSortCompanyTechDetails"},"ColumnSortJobSearch":{"properties":{"desc":{"type":"boolean","title":"Desc","description":"Whether to order by descending or ascending values","default":true},"field":{"type":"string","enum":["date_posted","discovered_at","salary","job_title","company","num_jobs"],"title":"Field","description":"Field to order by","default":"date_posted"}},"additionalProperties":false,"type":"object","title":"ColumnSortJobSearch"},"Commitment":{"type":"string","enum":["full_time","part_time","temporary","internship","contract","freelance","co_founder","apprenticeship","seasonal","volunteer","other"],"title":"Commitment"},"CompaniesPerCountryCode":{"properties":{"iso2":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Iso2","description":"ISO2 country code"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country","description":"Country name"},"num_companies":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Num Companies","description":"Number of companies in the country"}},"type":"object","title":"CompaniesPerCountryCode"},"CompaniesPerCountryCodeResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/CompaniesPerCountryCode"},"type":"array","title":"Data"},"metadata":{"$ref":"#/components/schemas/BaseMetadata"}},"type":"object","required":["data","metadata"],"title":"CompaniesPerCountryCodeResponse"},"CompanyKeywordsResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/KeywordFoundV1"},"type":"array","title":"Data"},"metadata":{"$ref":"#/components/schemas/Metadata"}},"type":"object","required":["data","metadata"],"title":"CompanyKeywordsResponse"},"CompanyList":{"properties":{"name":{"type":"string","title":"Name","description":"Name of the company list"},"id":{"type":"integer","title":"Id"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"deletable":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Deletable","description":"Whether the list can be deleted"},"companies_count":{"type":"integer","title":"Companies Count","description":"Number of companies in the list","default":0},"user_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"User Id","description":"User ID of the list owner"},"type":{"anyOf":[{"$ref":"#/components/schemas/CompanyListType"},{"type":"null"}],"description":"Type of the list: MANUAL_CREATION, WEBHOOK_TRIGGERED, REVEALED_COMPANIES"},"webhook_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Webhook Id","description":"Webhook ID of the list"}},"type":"object","required":["name","id","created_at"],"title":"CompanyList"},"CompanyListCreate":{"properties":{"name":{"type":"string","title":"Name","description":"Name of the company list"}},"type":"object","required":["name"],"title":"CompanyListCreate"},"CompanyListExportResponse":{"properties":{"url":{"type":"string","title":"Url","description":"The URL of the file with the companies report."}},"type":"object","required":["url"],"title":"CompanyListExportResponse"},"CompanyListItem":{"properties":{"company_name":{"type":"string","title":"Company Name"},"added_at":{"type":"string","format":"date-time","title":"Added At","description":"Date when the company was added to the list."},"revealed_at":{"type":"string","format":"date-time","title":"Revealed At","description":"Date when the company was revealed."},"company_object":{"$ref":"#/components/schemas/CompanyWithTechnologySlugs","description":"Company"}},"type":"object","required":["company_name","added_at","revealed_at","company_object"],"title":"CompanyListItem"},"CompanyListRename":{"properties":{"new_name":{"type":"string","title":"New Name","description":"New name of the company list"}},"type":"object","required":["new_name"],"title":"CompanyListRename"},"CompanyListType":{"type":"string","enum":["REVEALED_COMPANIES","WEBHOOK_TRIGGERED","MANUAL_CREATION","EXPORT_SNAPSHOT"],"title":"CompanyListType"},"CompanySearchFilters-Input":{"properties":{"expand_technology_slugs":{"items":{"type":"string"},"type":"array","title":"Expand Technology Slugs","description":"Specify technology slugs to include detailed technology usage information for each company. The response will include a 'technologies_found' field containing metrics like confidence score, ranking, and job count for each specified technology. Note: If a technology is not listed for a company, it means that company does not use that technology. This feature is useful for enriching company data with their technology stack details.","default":[]},"order_by":{"items":{"$ref":"#/components/schemas/ColumnSortCompanySearch"},"type":"array","title":"Order By","description":"List of column objects. You can pass several columns to order by, in order of priority. Only `field` is required, `desc` is True by default","default":[{"desc":true,"field":"confidence"},{"desc":true,"field":"num_jobs_found"},{"desc":true,"field":"num_jobs"},{"desc":true,"field":"num_jobs"},{"desc":true,"field":"employee_count"}]},"company_name_or":{"items":{"type":"string"},"type":"array","title":"Company Name Or","description":"Only return companies that match these names exactly, case-sensitively. This filter acts as an OR filter, so if you pass more than one company name, it will return companies that match any of the names.","default":[],"examples":[[],["Google","Facebook","Apple"]]},"company_name_case_insensitive_or":{"items":{"type":"string"},"type":"array","title":"Company Name Case Insensitive Or","description":"Only return companies that match these names exactly, case-insensitively.","default":[],"examples":[[],["google","stripe"]]},"company_id_or":{"items":{"type":"string"},"type":"array","title":"Company Id Or","description":"Only return companies that match these IDs exactly. This filter acts as an OR filter, so if you pass more than one company ID, it will return companies that match any of the IDs.","default":[],"examples":[[],["1234567890","1234567891"]]},"company_domain_or":{"items":{"type":"string"},"type":"array","title":"Company Domain Or","description":"Only return companies that match these domains exactly. It accepts full urls (https://www.google.com/) and emails (john.polo@gmail.com). This filter acts as an OR filter, so if you pass more than one company domain, it will return companies that match any of the domains.","default":[],"examples":[[],["google.com","stripe.com"],["https://www.google.com/","https://stripe.com/"],["andrew@stripe.com ","mark@meta.com"]]},"company_domain_not":{"items":{"type":"string"},"type":"array","title":"Company Domain Not","description":"Only return companies that don't match these domains exactly. It accepts full urls (https://www.google.com/) and emails (john.polo@gmail.com).","default":[],"examples":[[],["google.com","stripe.com"],["https://www.google.com/","https://stripe.com/"],["andrew@stripe.com ","mark@meta.com"]]},"company_name_not":{"items":{"type":"string"},"type":"array","title":"Company Name Not","description":"Only return companies that don't match these names exactly, case-sensitively.","default":[],"examples":[[],["Google","Facebook","Apple"]]},"company_name_partial_match_or":{"items":{"type":"string"},"type":"array","title":"Company Name Partial Match Or","description":"Company names. Will return companies whose name contain any of the the substrings passed here, case-insensitively. For example, if you pass \"google\", it will return \"Google\", \"Google LLC\", \"Google Inc\", etc.","default":[],"examples":[[],["google","stripe"]]},"company_name_partial_match_not":{"items":{"type":"string"},"type":"array","title":"Company Name Partial Match Not","description":"Company names. Will return companies whose name doesn't contain any of the the substrings passed here, case-insensitively. For example, if you pass 'google', it will exclude 'Google', 'Google LLC', 'Google Inc', etc.","default":[],"examples":[[],["google","stripe"]]},"company_linkedin_url_or":{"items":{"type":"string"},"type":"array","title":"Company Linkedin Url Or","description":"Return companies whose LinkedIn URL matches any of the slugs passed here. Can also pass full LinkedIn company URLs.","default":[],"examples":[[],["https://www.linkedin.com/company/google/"]]},"blur_company_data":{"type":"boolean","title":"Blur Company Data","description":"Enable preview mode to return blurred data without consuming API credits. When enabled, sensitive company fields (name, domain, URLs, descriptions) and job-specific fields (description, URLs) are blurred. This mode is useful for sales software integrations to show data previews to end users. Not available when filtering by company identifiers (company_name, company_domain, company_linkedin_url, company_id). Learn more about [here](https://theirstack.com/en/docs/api/preview-data-mode)","default":false},"property_exists_or":{"items":{"type":"string","enum":["domain","linkedin_url"]},"type":"array","title":"Property Exists Or","description":"Return companies that have any of these fields not null. For example, if you pass ['domain', 'linkedin_url'], it will return companies that have a domain OR a linkedin_url set.","default":[],"examples":[[],["domain","linkedin_url"]]},"property_exists_and":{"items":{"type":"string","enum":["domain","linkedin_url"]},"type":"array","title":"Property Exists And","description":"Return companies that have all of these fields not null. For example, if you pass ['domain', 'linkedin_url'], it will return companies that have both domain AND linkedin_url set.","default":[],"examples":[[],["domain","linkedin_url"]]},"offset":{"type":"integer","minimum":0.0,"title":"Offset","description":"Number of results to skip. Required for [offset-based pagination](https://theirstack.com/en/docs/api-reference/pagination).","default":0,"examples":[0]},"page":{"type":"integer","minimum":0.0,"title":"Page","description":"Page number. Required when using [page-based pagination](https://theirstack.com/en/docs/api-reference/pagination).","default":0,"examples":[0]},"limit":{"type":"integer","minimum":1.0,"title":"Limit","description":"Number of results per page","default":25,"examples":[25]},"cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor","description":"Cursor for pagination"},"company_description_pattern_or":{"items":{"type":"string"},"type":"array","title":"Company Description Pattern Or","description":"Case-insensitive patterns to match in the company description. Will return companies that match any of the patterns.","default":[]},"company_description_pattern_not":{"items":{"type":"string"},"type":"array","title":"Company Description Pattern Not","description":"Case-insensitive patterns to match in the company description. Will return companies that match any of the patterns.","default":[]},"company_description_pattern_accent_insensitive":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Company Description Pattern Accent Insensitive","description":"Set to True to make company description searches accent insensitive. For example, \"á\" will match \"a\" as well.","default":false,"examples":[null,true,false]},"min_revenue_usd":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Revenue Usd","description":"Minimum company revenue, in USD","examples":[null]},"max_revenue_usd":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Revenue Usd","description":"Maximum company revenue, in USD","examples":[null]},"min_employee_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Employee Count","description":"Minimum number of employees in a company","examples":[null,100]},"max_employee_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Employee Count","description":"Maximum number of employees in a company","examples":[null,100]},"min_employee_count_or_null":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Employee Count Or Null","description":"Minimum number of employees in a company. If we don't have company size information, we will return it as well.","examples":[null,100]},"max_employee_count_or_null":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Employee Count Or Null","description":"Maximum number of employees in a company. If we don't have company size information, we will return it as well.","examples":[null,100]},"min_funding_usd":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Funding Usd","description":"Minimum company funding, in USD","examples":[null,1000000000]},"max_funding_usd":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Funding Usd","description":"Maximum company funding, in USD","examples":[null,1000000000]},"funding_stage_or":{"items":{"type":"string"},"type":"array","title":"Funding Stage Or","description":"Funding stages of companies returned. Possible values: ['angel', 'convertible_note', 'debt_financing', 'equity_crowdfunding', 'other', 'private_equity', 'seed', 'series_a', 'series_b', 'series_c', 'series_d', 'series_e', 'series_f', 'series_g', 'series_h', 'venture_round_not_specified', 'series_i', 'series_j', 'undisclosed', 'series_unknown', 'pre_seed', 'post_ipo_secondary', 'post_ipo_equity', 'post_ipo_debt', 'non_equity_assistance', 'late_vc', 'initial_coin_offering', 'growth_equity_vc', 'grant', 'early_vc', 'corporate_round', 'secondary_market', 'product_crowdfunding']","default":[]},"industry_or":{"items":{"type":"string"},"type":"array","title":"Industry Or","description":"Names of industries, case-insensitive. Results will only include companies that belong to any of the industries specified in this parameter. Available values: [GET /v0/catalog/industries](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_industries_v0)\n\n    WARNING: Deprecated parameter. Use the industry_id_or field instead. ","default":[],"deprecated":true},"industry_not":{"items":{"type":"string"},"type":"array","title":"Industry Not","description":"Names of industries, case-insensitive. Results will exclude companies that belong to any of the industries specified in this parameter. Available values: [GET /v0/catalog/industries](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_industries_v0)\n\n    WARNING: Deprecated parameter. Use the industry_id_not field instead. ","default":[],"deprecated":true},"industry_id_or":{"items":{"type":"integer"},"type":"array","title":"Industry Id Or","description":"Industry codes. You can use any of [LinkedIn's Industry Codes V2](https://learn.microsoft.com/en-us/linkedin/shared/references/reference-tables/industry-codes-v2) or [GET /v0/catalog/industries](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_industries_v0)","default":[]},"industry_id_not":{"items":{"type":"integer"},"type":"array","title":"Industry Id Not","description":"Industry ids to exclude.You can use any of [LinkedIn's Industry Codes V2](https://learn.microsoft.com/en-us/linkedin/shared/references/reference-tables/industry-codes-v2) or [GET /v0/catalog/industries](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_industries_v0)","default":[]},"company_tags_or":{"items":{"type":"string"},"type":"array","title":"Company Tags Or","description":"Return companies that match any of these keywords","default":[]},"company_type":{"anyOf":[{"type":"string","enum":["recruiting_agency","direct_employer","all"]},{"type":"null"}],"title":"Company Type","description":"Filter by company type."},"company_investors_or":{"items":{"type":"string"},"type":"array","title":"Company Investors Or","description":"Investors of the company","default":[]},"company_investors_partial_match_or":{"items":{"type":"string"},"type":"array","title":"Company Investors Partial Match Or","description":"Investors of the company. Will return companies for which any of their investors contains any of the substrings passed here. For example, if you pass 'andree', all funds that match it (like 'Andreessen Horowitz', 'Andreessen Horowitz LLC', etc).","default":[]},"company_technology_slug_or":{"items":{"type":"string"},"type":"array","title":"Company Technology Slug Or","description":"Will return jobs from companies that that have mentioned any of these technologies in their jobs (not necessarily in the jobs returned). Case sensitive. Pass slugs. Check out all the technologies we track at [GET /v0/catalog/technologies](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_technologies_v0). Deprecated: use company_keyword_slug_or instead.","default":[],"deprecated":true},"company_technology_slug_and":{"items":{"type":"string"},"type":"array","title":"Company Technology Slug And","description":"Will return jobs from companies that that have mentioned all of these technologies in their jobs (not necessarily in the jobs returned). Case sensitive. Pass slugs. Check out all the technologies we track at [GET /v0/catalog/technologies](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_technologies_v0). Deprecated: use company_keyword_slug_and instead.","default":[],"deprecated":true},"company_technology_slug_not":{"items":{"type":"string"},"type":"array","title":"Company Technology Slug Not","description":"Will return jobs from companies that that haven't mentioned any of these technologies in their jobs. Case sensitive. Pass slugs. Check out all the technologies we track at [GET /v0/catalog/technologies](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_technologies_v0). Deprecated: use company_keyword_slug_not instead.","default":[],"deprecated":true},"company_keyword_slug_or":{"items":{"type":"string"},"type":"array","title":"Company Keyword Slug Or","description":"Return results from companies that have mentioned any of these keywords in their jobs. Case sensitive. Pass slugs. Check out all the keywords we track at [GET /v0/catalog/keywords](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_keywords_v0)","default":[]},"company_keyword_slug_and":{"items":{"type":"string"},"type":"array","title":"Company Keyword Slug And","description":"Return results from companies that have mentioned all of these keywords in their jobs. Case sensitive. Pass slugs. Check out all the keywords we track at [GET /v0/catalog/keywords](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_keywords_v0)","default":[]},"company_keyword_slug_not":{"items":{"type":"string"},"type":"array","title":"Company Keyword Slug Not","description":"Return results from companies that haven't mentioned any of these keywords in their jobs. Case sensitive. Pass slugs. Check out all the keywords we track at [GET /v0/catalog/keywords](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_keywords_v0)","default":[]},"only_yc_companies":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Only Yc Companies","description":"Only return YC companies","default":false},"company_location_pattern_or":{"items":{"type":"string"},"type":"array","title":"Company Location Pattern Or","description":"Return companies whose city matches any of the patterns passed here. Case insensitive. For example, if you pass 'san francisco', it will return companies whose city is 'San Francisco', 'San Francisco Bay Area', etc.","default":[]},"company_country_code_or":{"items":{"type":"string"},"type":"array","title":"Company Country Code Or","description":"Return companies whose HQ country code is any of the ones passed here, case sensitive. Pass ISO2 country codes.","default":[]},"company_country_code_not":{"items":{"type":"string"},"type":"array","title":"Company Country Code Not","description":"Return companies whose HQ country code is not any of the ones passed here, case sensitive. Pass ISO2 country codes.","default":[]},"company_list_id_or":{"items":{"type":"integer"},"type":"array","title":"Company List Id Or","description":"Return companies that belong to any of the company lists passed here","default":[]},"company_list_id_not":{"items":{"type":"integer"},"type":"array","title":"Company List Id Not","description":"Return companies that don't belong to any of the company lists passed here","default":[]},"company_linkedin_url_exists":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Company Linkedin Url Exists","description":"(Use `property_exists_or / property_exists_and` instead) Only return companies with a LinkedIn URL","deprecated":true,"examples":[null]},"revealed_company_data":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Revealed Company Data","description":"This field is deprecated and has no effect.","deprecated":true,"examples":[null]},"last_funding_round_date_lte":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Last Funding Round Date Lte","description":"Only return companies whose last funding round date is before or on this date. Format: 'YYYY-MM-DD'","examples":[null,"2025-05-25"]},"last_funding_round_date_gte":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Last Funding Round Date Gte","description":"Only return companies whose last funding round date is after or on this date. Format: 'YYYY-MM-DD'","examples":[null,"2025-05-25"]},"include_total_results":{"type":"boolean","title":"Include Total Results","description":"When enabled, calculates and returns `total_results` and `total_companies` fields in the response. WARNING: This significantly slows down responses as it requires reading the entire dataset. Recommended usage: enable only for the initial request to get totals, then disable for subsequent pagination requests.","default":false},"job_filters":{"anyOf":[{"$ref":"#/components/schemas/JobFilters"},{"type":"null"}]},"tech_filters":{"anyOf":[{"$ref":"#/components/schemas/KeywordFilters"},{"type":"null"}],"description":"Filter by technologies and buying intent topics detected for the company"}},"type":"object","title":"CompanySearchFilters"},"CompanySearchFilters-Output":{"properties":{"expand_technology_slugs":{"items":{"type":"string"},"type":"array","title":"Expand Technology Slugs","description":"Specify technology slugs to include detailed technology usage information for each company. The response will include a 'technologies_found' field containing metrics like confidence score, ranking, and job count for each specified technology. Note: If a technology is not listed for a company, it means that company does not use that technology. This feature is useful for enriching company data with their technology stack details.","default":[]},"order_by":{"items":{"$ref":"#/components/schemas/ColumnSortCompanySearch"},"type":"array","title":"Order By","description":"List of column objects. You can pass several columns to order by, in order of priority. Only `field` is required, `desc` is True by default","default":[{"desc":true,"field":"confidence"},{"desc":true,"field":"num_jobs_found"},{"desc":true,"field":"num_jobs"},{"desc":true,"field":"num_jobs"},{"desc":true,"field":"employee_count"}]},"company_name_or":{"items":{"type":"string"},"type":"array","title":"Company Name Or","description":"Only return companies that match these names exactly, case-sensitively. This filter acts as an OR filter, so if you pass more than one company name, it will return companies that match any of the names.","default":[],"examples":[[],["Google","Facebook","Apple"]]},"company_name_case_insensitive_or":{"items":{"type":"string"},"type":"array","title":"Company Name Case Insensitive Or","description":"Only return companies that match these names exactly, case-insensitively.","default":[],"examples":[[],["google","stripe"]]},"company_id_or":{"items":{"type":"string"},"type":"array","title":"Company Id Or","description":"Only return companies that match these IDs exactly. This filter acts as an OR filter, so if you pass more than one company ID, it will return companies that match any of the IDs.","default":[],"examples":[[],["1234567890","1234567891"]]},"company_domain_or":{"items":{"type":"string"},"type":"array","title":"Company Domain Or","description":"Only return companies that match these domains exactly. It accepts full urls (https://www.google.com/) and emails (john.polo@gmail.com). This filter acts as an OR filter, so if you pass more than one company domain, it will return companies that match any of the domains.","default":[],"examples":[[],["google.com","stripe.com"],["https://www.google.com/","https://stripe.com/"],["andrew@stripe.com ","mark@meta.com"]]},"company_domain_not":{"items":{"type":"string"},"type":"array","title":"Company Domain Not","description":"Only return companies that don't match these domains exactly. It accepts full urls (https://www.google.com/) and emails (john.polo@gmail.com).","default":[],"examples":[[],["google.com","stripe.com"],["https://www.google.com/","https://stripe.com/"],["andrew@stripe.com ","mark@meta.com"]]},"company_name_not":{"items":{"type":"string"},"type":"array","title":"Company Name Not","description":"Only return companies that don't match these names exactly, case-sensitively.","default":[],"examples":[[],["Google","Facebook","Apple"]]},"company_name_partial_match_or":{"items":{"type":"string"},"type":"array","title":"Company Name Partial Match Or","description":"Company names. Will return companies whose name contain any of the the substrings passed here, case-insensitively. For example, if you pass \"google\", it will return \"Google\", \"Google LLC\", \"Google Inc\", etc.","default":[],"examples":[[],["google","stripe"]]},"company_name_partial_match_not":{"items":{"type":"string"},"type":"array","title":"Company Name Partial Match Not","description":"Company names. Will return companies whose name doesn't contain any of the the substrings passed here, case-insensitively. For example, if you pass 'google', it will exclude 'Google', 'Google LLC', 'Google Inc', etc.","default":[],"examples":[[],["google","stripe"]]},"company_linkedin_url_or":{"items":{"type":"string"},"type":"array","title":"Company Linkedin Url Or","description":"Return companies whose LinkedIn URL matches any of the slugs passed here. Can also pass full LinkedIn company URLs.","default":[],"examples":[[],["https://www.linkedin.com/company/google/"]]},"blur_company_data":{"type":"boolean","title":"Blur Company Data","description":"Enable preview mode to return blurred data without consuming API credits. When enabled, sensitive company fields (name, domain, URLs, descriptions) and job-specific fields (description, URLs) are blurred. This mode is useful for sales software integrations to show data previews to end users. Not available when filtering by company identifiers (company_name, company_domain, company_linkedin_url, company_id). Learn more about [here](https://theirstack.com/en/docs/api/preview-data-mode)","default":false},"property_exists_or":{"items":{"type":"string","enum":["domain","linkedin_url"]},"type":"array","title":"Property Exists Or","description":"Return companies that have any of these fields not null. For example, if you pass ['domain', 'linkedin_url'], it will return companies that have a domain OR a linkedin_url set.","default":[],"examples":[[],["domain","linkedin_url"]]},"property_exists_and":{"items":{"type":"string","enum":["domain","linkedin_url"]},"type":"array","title":"Property Exists And","description":"Return companies that have all of these fields not null. For example, if you pass ['domain', 'linkedin_url'], it will return companies that have both domain AND linkedin_url set.","default":[],"examples":[[],["domain","linkedin_url"]]},"offset":{"type":"integer","minimum":0.0,"title":"Offset","description":"Number of results to skip. Required for [offset-based pagination](https://theirstack.com/en/docs/api-reference/pagination).","default":0,"examples":[0]},"page":{"type":"integer","minimum":0.0,"title":"Page","description":"Page number. Required when using [page-based pagination](https://theirstack.com/en/docs/api-reference/pagination).","default":0,"examples":[0]},"limit":{"type":"integer","minimum":1.0,"title":"Limit","description":"Number of results per page","default":25,"examples":[25]},"company_description_pattern_or":{"items":{"type":"string"},"type":"array","title":"Company Description Pattern Or","description":"Case-insensitive patterns to match in the company description. Will return companies that match any of the patterns.","default":[]},"company_description_pattern_not":{"items":{"type":"string"},"type":"array","title":"Company Description Pattern Not","description":"Case-insensitive patterns to match in the company description. Will return companies that match any of the patterns.","default":[]},"company_description_pattern_accent_insensitive":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Company Description Pattern Accent Insensitive","description":"Set to True to make company description searches accent insensitive. For example, \"á\" will match \"a\" as well.","default":false,"examples":[null,true,false]},"min_revenue_usd":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Revenue Usd","description":"Minimum company revenue, in USD","examples":[null]},"max_revenue_usd":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Revenue Usd","description":"Maximum company revenue, in USD","examples":[null]},"min_employee_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Employee Count","description":"Minimum number of employees in a company","examples":[null,100]},"max_employee_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Employee Count","description":"Maximum number of employees in a company","examples":[null,100]},"min_employee_count_or_null":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Employee Count Or Null","description":"Minimum number of employees in a company. If we don't have company size information, we will return it as well.","examples":[null,100]},"max_employee_count_or_null":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Employee Count Or Null","description":"Maximum number of employees in a company. If we don't have company size information, we will return it as well.","examples":[null,100]},"min_funding_usd":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Funding Usd","description":"Minimum company funding, in USD","examples":[null,1000000000]},"max_funding_usd":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Funding Usd","description":"Maximum company funding, in USD","examples":[null,1000000000]},"funding_stage_or":{"items":{"type":"string"},"type":"array","title":"Funding Stage Or","description":"Funding stages of companies returned. Possible values: ['angel', 'convertible_note', 'debt_financing', 'equity_crowdfunding', 'other', 'private_equity', 'seed', 'series_a', 'series_b', 'series_c', 'series_d', 'series_e', 'series_f', 'series_g', 'series_h', 'venture_round_not_specified', 'series_i', 'series_j', 'undisclosed', 'series_unknown', 'pre_seed', 'post_ipo_secondary', 'post_ipo_equity', 'post_ipo_debt', 'non_equity_assistance', 'late_vc', 'initial_coin_offering', 'growth_equity_vc', 'grant', 'early_vc', 'corporate_round', 'secondary_market', 'product_crowdfunding']","default":[]},"industry_or":{"items":{"type":"string"},"type":"array","title":"Industry Or","description":"Names of industries, case-insensitive. Results will only include companies that belong to any of the industries specified in this parameter. Available values: [GET /v0/catalog/industries](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_industries_v0)\n\n    WARNING: Deprecated parameter. Use the industry_id_or field instead. ","default":[],"deprecated":true},"industry_not":{"items":{"type":"string"},"type":"array","title":"Industry Not","description":"Names of industries, case-insensitive. Results will exclude companies that belong to any of the industries specified in this parameter. Available values: [GET /v0/catalog/industries](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_industries_v0)\n\n    WARNING: Deprecated parameter. Use the industry_id_not field instead. ","default":[],"deprecated":true},"industry_id_or":{"items":{"type":"integer"},"type":"array","title":"Industry Id Or","description":"Industry codes. You can use any of [LinkedIn's Industry Codes V2](https://learn.microsoft.com/en-us/linkedin/shared/references/reference-tables/industry-codes-v2) or [GET /v0/catalog/industries](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_industries_v0)","default":[]},"industry_id_not":{"items":{"type":"integer"},"type":"array","title":"Industry Id Not","description":"Industry ids to exclude.You can use any of [LinkedIn's Industry Codes V2](https://learn.microsoft.com/en-us/linkedin/shared/references/reference-tables/industry-codes-v2) or [GET /v0/catalog/industries](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_industries_v0)","default":[]},"company_tags_or":{"items":{"type":"string"},"type":"array","title":"Company Tags Or","description":"Return companies that match any of these keywords","default":[]},"company_type":{"anyOf":[{"type":"string","enum":["recruiting_agency","direct_employer","all"]},{"type":"null"}],"title":"Company Type","description":"Filter by company type."},"company_investors_or":{"items":{"type":"string"},"type":"array","title":"Company Investors Or","description":"Investors of the company","default":[]},"company_investors_partial_match_or":{"items":{"type":"string"},"type":"array","title":"Company Investors Partial Match Or","description":"Investors of the company. Will return companies for which any of their investors contains any of the substrings passed here. For example, if you pass 'andree', all funds that match it (like 'Andreessen Horowitz', 'Andreessen Horowitz LLC', etc).","default":[]},"company_technology_slug_or":{"items":{"type":"string"},"type":"array","title":"Company Technology Slug Or","description":"Will return jobs from companies that that have mentioned any of these technologies in their jobs (not necessarily in the jobs returned). Case sensitive. Pass slugs. Check out all the technologies we track at [GET /v0/catalog/technologies](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_technologies_v0). Deprecated: use company_keyword_slug_or instead.","default":[],"deprecated":true},"company_technology_slug_and":{"items":{"type":"string"},"type":"array","title":"Company Technology Slug And","description":"Will return jobs from companies that that have mentioned all of these technologies in their jobs (not necessarily in the jobs returned). Case sensitive. Pass slugs. Check out all the technologies we track at [GET /v0/catalog/technologies](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_technologies_v0). Deprecated: use company_keyword_slug_and instead.","default":[],"deprecated":true},"company_technology_slug_not":{"items":{"type":"string"},"type":"array","title":"Company Technology Slug Not","description":"Will return jobs from companies that that haven't mentioned any of these technologies in their jobs. Case sensitive. Pass slugs. Check out all the technologies we track at [GET /v0/catalog/technologies](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_technologies_v0). Deprecated: use company_keyword_slug_not instead.","default":[],"deprecated":true},"company_keyword_slug_or":{"items":{"type":"string"},"type":"array","title":"Company Keyword Slug Or","description":"Return results from companies that have mentioned any of these keywords in their jobs. Case sensitive. Pass slugs. Check out all the keywords we track at [GET /v0/catalog/keywords](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_keywords_v0)","default":[]},"company_keyword_slug_and":{"items":{"type":"string"},"type":"array","title":"Company Keyword Slug And","description":"Return results from companies that have mentioned all of these keywords in their jobs. Case sensitive. Pass slugs. Check out all the keywords we track at [GET /v0/catalog/keywords](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_keywords_v0)","default":[]},"company_keyword_slug_not":{"items":{"type":"string"},"type":"array","title":"Company Keyword Slug Not","description":"Return results from companies that haven't mentioned any of these keywords in their jobs. Case sensitive. Pass slugs. Check out all the keywords we track at [GET /v0/catalog/keywords](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_keywords_v0)","default":[]},"only_yc_companies":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Only Yc Companies","description":"Only return YC companies","default":false},"company_location_pattern_or":{"items":{"type":"string"},"type":"array","title":"Company Location Pattern Or","description":"Return companies whose city matches any of the patterns passed here. Case insensitive. For example, if you pass 'san francisco', it will return companies whose city is 'San Francisco', 'San Francisco Bay Area', etc.","default":[]},"company_country_code_or":{"items":{"type":"string"},"type":"array","title":"Company Country Code Or","description":"Return companies whose HQ country code is any of the ones passed here, case sensitive. Pass ISO2 country codes.","default":[]},"company_country_code_not":{"items":{"type":"string"},"type":"array","title":"Company Country Code Not","description":"Return companies whose HQ country code is not any of the ones passed here, case sensitive. Pass ISO2 country codes.","default":[]},"company_list_id_or":{"items":{"type":"integer"},"type":"array","title":"Company List Id Or","description":"Return companies that belong to any of the company lists passed here","default":[]},"company_list_id_not":{"items":{"type":"integer"},"type":"array","title":"Company List Id Not","description":"Return companies that don't belong to any of the company lists passed here","default":[]},"company_linkedin_url_exists":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Company Linkedin Url Exists","description":"(Use `property_exists_or / property_exists_and` instead) Only return companies with a LinkedIn URL","deprecated":true,"examples":[null]},"revealed_company_data":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Revealed Company Data","description":"This field is deprecated and has no effect.","deprecated":true,"examples":[null]},"last_funding_round_date_lte":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Last Funding Round Date Lte","description":"Only return companies whose last funding round date is before or on this date. Format: 'YYYY-MM-DD'","examples":[null,"2025-05-25"]},"last_funding_round_date_gte":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Last Funding Round Date Gte","description":"Only return companies whose last funding round date is after or on this date. Format: 'YYYY-MM-DD'","examples":[null,"2025-05-25"]},"include_total_results":{"type":"boolean","title":"Include Total Results","description":"When enabled, calculates and returns `total_results` and `total_companies` fields in the response. WARNING: This significantly slows down responses as it requires reading the entire dataset. Recommended usage: enable only for the initial request to get totals, then disable for subsequent pagination requests.","default":false},"job_filters":{"anyOf":[{"$ref":"#/components/schemas/JobFilters"},{"type":"null"}]},"tech_filters":{"anyOf":[{"$ref":"#/components/schemas/KeywordFilters"},{"type":"null"}],"description":"Filter by technologies and buying intent topics detected for the company"}},"type":"object","title":"CompanySearchFilters"},"CompanySearchResponse":{"properties":{"metadata":{"$ref":"#/components/schemas/Metadata"},"data":{"items":{"$ref":"#/components/schemas/CompanyWithTechnologiesAndJobs-Output"},"type":"array","title":"Data"}},"type":"object","required":["metadata","data"],"title":"CompanySearchResponse"},"CompanyWithTechnologiesAndJobs-Input":{"properties":{"id":{"type":"string","title":"Id","description":"Company ID","examples":["google"]},"name":{"type":"string","title":"Name","description":"Company name","examples":["Google"]},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain","description":"Company domain","examples":["google.com"]},"industry":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Industry","description":"Industry of the company","examples":["internet"]},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country","description":"Country of the company's HQ","examples":["United States"]},"country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country Code","description":"ISO2 country code. E.g. \"US\""},"employee_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Employee Count","description":"Number of employees of the company","examples":[7543]},"logo":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Logo","description":"Stable CDN-hosted company logo URL suitable for display in applications","examples":["https://example.com/logo.png"]},"num_jobs":{"type":"integer","title":"Num Jobs","description":"Number of jobs from this company in our database","default":0,"examples":[746]},"num_technologies":{"type":"integer","title":"Num Technologies","description":"Number of technologies mentioned in the jobs of this company","default":0,"examples":[746]},"num_keywords":{"type":"integer","title":"Num Keywords","description":"Number of distinct keywords (technologies + buying intent topics) found in this company's jobs","default":0},"num_buying_intent_topics":{"type":"integer","title":"Num Buying Intent Topics","description":"Number of distinct buying intent topic keywords found in this company's jobs","default":0},"possible_domains":{"items":{"type":"string"},"type":"array","title":"Possible Domains","description":"List of possible domains for the company","default":[]},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"Company domain. Same as the \"domain\" field. Will be deprecated in the future.","examples":["google.com"]},"industry_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Industry Id","description":"Code of the industry. One of LinkedIn's Industry Codes V2 from https://learn.microsoft.com/en-us/linkedin/shared/references/reference-tables/industry-codes-v2"},"linkedin_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Linkedin Url","examples":["http://www.linkedin.com/company/google"]},"num_jobs_last_30_days":{"type":"integer","title":"Num Jobs Last 30 Days","description":"Number of jobs from this company in our database posted in the last 30 days","default":0,"examples":[34]},"num_jobs_found":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Num Jobs Found","description":"When filtering companies by jobs, number of jobs found for this company","examples":[23]},"yc_batch":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Yc Batch","description":"If the company went through YC, this is its batch","examples":["W21"]},"apollo_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apollo Id","description":"ID of the company in Apollo","examples":["5b839bd0324d4445051f9a5a"]},"linkedin_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Linkedin Id","description":"ID of the company in LinkedIn"},"url_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url Source","description":"Source of the company URL"},"is_recruiting_agency":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Recruiting Agency","description":"Is a recruiting agency"},"founded_year":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Founded Year","description":"Year the company was founded","examples":[2019]},"annual_revenue_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Annual Revenue Usd","description":"Annual revenue of the company in USD","examples":[189000000.0]},"annual_revenue_usd_readable":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Annual Revenue Usd Readable","description":"Annual revenue of the company in USD, formated as an easily readable string","examples":["189M"]},"total_funding_usd":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Funding Usd","description":"Funding of the company in USD","examples":[500000]},"last_funding_round_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Last Funding Round Date","description":"Date of the last funding round of the company","examples":["2020-01-01"]},"last_funding_round_amount_readable":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Funding Round Amount Readable","description":"Amount of the last funding round of the company, formated as an easily readable string","examples":["$1.2M"]},"employee_count_range":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Employee Count Range","description":"Number range of employees at the company","examples":["1001-5000"]},"long_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Long Description","description":"Short description of the company","examples":["Google is a California-based multinational technology company that offers internet-related services such as a search engine, online advertising and cloud computing."]},"seo_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Seo Description","description":"SEO description of the company, extracted from their website"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City","description":"City of the company's HQ","examples":["Mountain View"]},"postal_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Postal Code","description":"Postal code of the company's HQ","examples":["28040"]},"company_keywords":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Company Keywords","description":"Company keywords, related to what the company does. Deprecated: use company_tags instead.","deprecated":true},"company_tags":{"items":{"type":"string"},"type":"array","title":"Company Tags","description":"Company keywords, related to what the company does","default":[]},"alexa_ranking":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Alexa Ranking","description":"Alexa ranking","examples":[1]},"publicly_traded_symbol":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Publicly Traded Symbol","examples":["GOOG"]},"publicly_traded_exchange":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Publicly Traded Exchange","examples":["NASDAQ"]},"investors":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Investors","description":"List of investors in this company"},"funding_stage":{"anyOf":[{"$ref":"#/components/schemas/FundingStage"},{"type":"null"}],"description":"Latest funding stage of the company"},"has_blurred_data":{"type":"boolean","title":"Has Blurred Data","description":"Whether the returned object has company identifiable data blurred or not","default":false},"keyword_slugs":{"items":{"type":"string"},"type":"array","title":"Keyword Slugs","description":"Slugs of all keywords (technologies and buying intent topics) found in this company's jobs","default":[],"examples":[["kafka","elasticsearch","lead-generation"]]},"technology_slugs":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Technology Slugs","description":"Slugs of the technologies found in this company's jobs. This is a subset of keyword_slugs filtered to only technology-type keywords.","examples":[["kafka","elasticsearch"]]},"technology_names":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Technology Names","description":"Names of the technologies found to be used by the company","deprecated":true,"examples":[["Kafka","Elasticsearch"]]},"technologies_found":{"items":{"$ref":"#/components/schemas/KeywordFoundV0-Input"},"type":"array","title":"Technologies Found","description":"List of technologies found to be used by the company, relevant to the current search","default":[]},"jobs_found":{"items":{"$ref":"#/components/schemas/JobBaseOut"},"type":"array","title":"Jobs Found","description":"List of the last 5 jobs posted by the company, relevant to the current search","default":[]},"keywords_found":{"items":{"$ref":"#/components/schemas/KeywordFoundV0-Input"},"type":"array","title":"Keywords Found","description":"List of buying intent keywords and technologies found in this company's jobs, relevant to the current search","default":[]}},"type":"object","required":["id","name"],"title":"CompanyWithTechnologiesAndJobs"},"CompanyWithTechnologiesAndJobs-Output":{"properties":{"id":{"type":"string","title":"Id","description":"Company ID","examples":["google"]},"name":{"type":"string","title":"Name","description":"Company name","examples":["Google"]},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain","description":"Company domain","examples":["google.com"]},"industry":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Industry","description":"Industry of the company","examples":["internet"]},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country","description":"Country of the company's HQ","examples":["United States"]},"country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country Code","description":"ISO2 country code. E.g. \"US\""},"employee_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Employee Count","description":"Number of employees of the company","examples":[7543]},"logo":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Logo","description":"Stable CDN-hosted company logo URL suitable for display in applications","examples":["https://example.com/logo.png"]},"num_jobs":{"type":"integer","title":"Num Jobs","description":"Number of jobs from this company in our database","default":0,"examples":[746]},"num_technologies":{"type":"integer","title":"Num Technologies","description":"Number of technologies mentioned in the jobs of this company","default":0,"examples":[746]},"num_keywords":{"type":"integer","title":"Num Keywords","description":"Number of distinct keywords (technologies + buying intent topics) found in this company's jobs","default":0},"num_buying_intent_topics":{"type":"integer","title":"Num Buying Intent Topics","description":"Number of distinct buying intent topic keywords found in this company's jobs","default":0},"possible_domains":{"items":{"type":"string"},"type":"array","title":"Possible Domains","description":"List of possible domains for the company","default":[]},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"Company domain. Same as the \"domain\" field. Will be deprecated in the future.","examples":["google.com"]},"industry_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Industry Id","description":"Code of the industry. One of LinkedIn's Industry Codes V2 from https://learn.microsoft.com/en-us/linkedin/shared/references/reference-tables/industry-codes-v2"},"linkedin_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Linkedin Url","examples":["http://www.linkedin.com/company/google"]},"num_jobs_last_30_days":{"type":"integer","title":"Num Jobs Last 30 Days","description":"Number of jobs from this company in our database posted in the last 30 days","default":0,"examples":[34]},"num_jobs_found":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Num Jobs Found","description":"When filtering companies by jobs, number of jobs found for this company","examples":[23]},"yc_batch":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Yc Batch","description":"If the company went through YC, this is its batch","examples":["W21"]},"apollo_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apollo Id","description":"ID of the company in Apollo","examples":["5b839bd0324d4445051f9a5a"]},"linkedin_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Linkedin Id","description":"ID of the company in LinkedIn"},"url_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url Source","description":"Source of the company URL"},"is_recruiting_agency":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Recruiting Agency","description":"Is a recruiting agency"},"founded_year":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Founded Year","description":"Year the company was founded","examples":[2019]},"annual_revenue_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Annual Revenue Usd","description":"Annual revenue of the company in USD","examples":[189000000.0]},"annual_revenue_usd_readable":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Annual Revenue Usd Readable","description":"Annual revenue of the company in USD, formated as an easily readable string","examples":["189M"]},"total_funding_usd":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Funding Usd","description":"Funding of the company in USD","examples":[500000]},"last_funding_round_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Last Funding Round Date","description":"Date of the last funding round of the company","examples":["2020-01-01"]},"last_funding_round_amount_readable":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Funding Round Amount Readable","description":"Amount of the last funding round of the company, formated as an easily readable string","examples":["$1.2M"]},"employee_count_range":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Employee Count Range","description":"Number range of employees at the company","examples":["1001-5000"]},"long_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Long Description","description":"Short description of the company","examples":["Google is a California-based multinational technology company that offers internet-related services such as a search engine, online advertising and cloud computing."]},"seo_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Seo Description","description":"SEO description of the company, extracted from their website"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City","description":"City of the company's HQ","examples":["Mountain View"]},"postal_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Postal Code","description":"Postal code of the company's HQ","examples":["28040"]},"company_keywords":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Company Keywords","description":"Company keywords, related to what the company does. Deprecated: use company_tags instead.","deprecated":true},"company_tags":{"items":{"type":"string"},"type":"array","title":"Company Tags","description":"Company keywords, related to what the company does","default":[]},"alexa_ranking":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Alexa Ranking","description":"Alexa ranking","examples":[1]},"publicly_traded_symbol":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Publicly Traded Symbol","examples":["GOOG"]},"publicly_traded_exchange":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Publicly Traded Exchange","examples":["NASDAQ"]},"investors":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Investors","description":"List of investors in this company"},"funding_stage":{"anyOf":[{"$ref":"#/components/schemas/FundingStage"},{"type":"null"}],"description":"Latest funding stage of the company"},"has_blurred_data":{"type":"boolean","title":"Has Blurred Data","description":"Whether the returned object has company identifiable data blurred or not","default":false},"keyword_slugs":{"items":{"type":"string"},"type":"array","title":"Keyword Slugs","description":"Slugs of all keywords (technologies and buying intent topics) found in this company's jobs","default":[],"examples":[["kafka","elasticsearch","lead-generation"]]},"technology_slugs":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Technology Slugs","description":"Slugs of the technologies found in this company's jobs. This is a subset of keyword_slugs filtered to only technology-type keywords.","examples":[["kafka","elasticsearch"]]},"technology_names":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Technology Names","description":"Names of the technologies found to be used by the company","deprecated":true,"examples":[["Kafka","Elasticsearch"]]},"technologies_found":{"items":{"$ref":"#/components/schemas/KeywordFoundV0-Output"},"type":"array","title":"Technologies Found","description":"List of technologies found to be used by the company, relevant to the current search","default":[]},"jobs_found":{"items":{"$ref":"#/components/schemas/JobBaseOut"},"type":"array","title":"Jobs Found","description":"List of the last 5 jobs posted by the company, relevant to the current search","default":[]},"keywords_found":{"items":{"$ref":"#/components/schemas/KeywordFoundV0-Output"},"type":"array","title":"Keywords Found","description":"List of buying intent keywords and technologies found in this company's jobs, relevant to the current search","default":[]}},"type":"object","required":["id","name"],"title":"CompanyWithTechnologiesAndJobs"},"CompanyWithTechnologySlugs":{"properties":{"id":{"type":"string","title":"Id","description":"Company ID","examples":["google"]},"name":{"type":"string","title":"Name","description":"Company name","examples":["Google"]},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain","description":"Company domain","examples":["google.com"]},"industry":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Industry","description":"Industry of the company","examples":["internet"]},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country","description":"Country of the company's HQ","examples":["United States"]},"country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country Code","description":"ISO2 country code. E.g. \"US\""},"employee_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Employee Count","description":"Number of employees of the company","examples":[7543]},"logo":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Logo","description":"Stable CDN-hosted company logo URL suitable for display in applications","examples":["https://example.com/logo.png"]},"num_jobs":{"type":"integer","title":"Num Jobs","description":"Number of jobs from this company in our database","default":0,"examples":[746]},"num_technologies":{"type":"integer","title":"Num Technologies","description":"Number of technologies mentioned in the jobs of this company","default":0,"examples":[746]},"num_keywords":{"type":"integer","title":"Num Keywords","description":"Number of distinct keywords (technologies + buying intent topics) found in this company's jobs","default":0},"num_buying_intent_topics":{"type":"integer","title":"Num Buying Intent Topics","description":"Number of distinct buying intent topic keywords found in this company's jobs","default":0},"possible_domains":{"items":{"type":"string"},"type":"array","title":"Possible Domains","description":"List of possible domains for the company","default":[]},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"Company domain. Same as the \"domain\" field. Will be deprecated in the future.","examples":["google.com"]},"industry_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Industry Id","description":"Code of the industry. One of LinkedIn's Industry Codes V2 from https://learn.microsoft.com/en-us/linkedin/shared/references/reference-tables/industry-codes-v2"},"linkedin_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Linkedin Url","examples":["http://www.linkedin.com/company/google"]},"num_jobs_last_30_days":{"type":"integer","title":"Num Jobs Last 30 Days","description":"Number of jobs from this company in our database posted in the last 30 days","default":0,"examples":[34]},"num_jobs_found":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Num Jobs Found","description":"When filtering companies by jobs, number of jobs found for this company","examples":[23]},"yc_batch":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Yc Batch","description":"If the company went through YC, this is its batch","examples":["W21"]},"apollo_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apollo Id","description":"ID of the company in Apollo","examples":["5b839bd0324d4445051f9a5a"]},"linkedin_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Linkedin Id","description":"ID of the company in LinkedIn"},"url_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url Source","description":"Source of the company URL"},"is_recruiting_agency":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Recruiting Agency","description":"Is a recruiting agency"},"founded_year":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Founded Year","description":"Year the company was founded","examples":[2019]},"annual_revenue_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Annual Revenue Usd","description":"Annual revenue of the company in USD","examples":[189000000.0]},"annual_revenue_usd_readable":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Annual Revenue Usd Readable","description":"Annual revenue of the company in USD, formated as an easily readable string","examples":["189M"]},"total_funding_usd":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Funding Usd","description":"Funding of the company in USD","examples":[500000]},"last_funding_round_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Last Funding Round Date","description":"Date of the last funding round of the company","examples":["2020-01-01"]},"last_funding_round_amount_readable":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Funding Round Amount Readable","description":"Amount of the last funding round of the company, formated as an easily readable string","examples":["$1.2M"]},"employee_count_range":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Employee Count Range","description":"Number range of employees at the company","examples":["1001-5000"]},"long_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Long Description","description":"Short description of the company","examples":["Google is a California-based multinational technology company that offers internet-related services such as a search engine, online advertising and cloud computing."]},"seo_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Seo Description","description":"SEO description of the company, extracted from their website"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City","description":"City of the company's HQ","examples":["Mountain View"]},"postal_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Postal Code","description":"Postal code of the company's HQ","examples":["28040"]},"company_keywords":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Company Keywords","description":"Company keywords, related to what the company does. Deprecated: use company_tags instead.","deprecated":true},"company_tags":{"items":{"type":"string"},"type":"array","title":"Company Tags","description":"Company keywords, related to what the company does","default":[]},"alexa_ranking":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Alexa Ranking","description":"Alexa ranking","examples":[1]},"publicly_traded_symbol":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Publicly Traded Symbol","examples":["GOOG"]},"publicly_traded_exchange":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Publicly Traded Exchange","examples":["NASDAQ"]},"investors":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Investors","description":"List of investors in this company"},"funding_stage":{"anyOf":[{"$ref":"#/components/schemas/FundingStage"},{"type":"null"}],"description":"Latest funding stage of the company"},"has_blurred_data":{"type":"boolean","title":"Has Blurred Data","description":"Whether the returned object has company identifiable data blurred or not","default":false},"keyword_slugs":{"items":{"type":"string"},"type":"array","title":"Keyword Slugs","description":"Slugs of all keywords (technologies and buying intent topics) found in this company's jobs","default":[],"examples":[["kafka","elasticsearch","lead-generation"]]},"technology_slugs":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Technology Slugs","description":"Slugs of the technologies found in this company's jobs. This is a subset of keyword_slugs filtered to only technology-type keywords.","examples":[["kafka","elasticsearch"]]},"technology_names":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Technology Names","description":"Names of the technologies found to be used by the company","deprecated":true,"examples":[["Kafka","Elasticsearch"]]}},"type":"object","required":["id","name"],"title":"CompanyWithTechnologySlugs"},"CreditsBalance":{"properties":{"ui_credits":{"type":"integer","minimum":0.0,"title":"Ui Credits","description":"Number of credits available to the team"},"used_ui_credits":{"type":"integer","minimum":0.0,"title":"Used Ui Credits","description":"Number of credits used in the current billing cycle"},"api_credits":{"type":"integer","minimum":0.0,"title":"Api Credits","description":"Number of API credits available to the team"},"used_api_credits":{"type":"integer","minimum":0.0,"title":"Used Api Credits","description":"Number of API credits used in the current billing cycle"},"earliest_expiration":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Earliest Expiration","description":"Earliest expiration date among invoices with remaining credits"}},"type":"object","required":["ui_credits","used_ui_credits","api_credits","used_api_credits"],"title":"CreditsBalance"},"CreditsConsumption":{"properties":{"period_start":{"type":"string","format":"date-time","title":"Period Start","description":"Start of the period."},"api_credits_consumed":{"type":"integer","title":"Api Credits Consumed","description":"Number of API credits consumed."},"ui_credits_consumed":{"type":"integer","title":"Ui Credits Consumed","description":"Number of UI credits consumed."}},"type":"object","required":["period_start","api_credits_consumed","ui_credits_consumed"],"title":"CreditsConsumption"},"DatasetGroup":{"properties":{"type":{"anyOf":[{"type":"string","enum":["jobs","companies","technologies","technographics","buying_intents","buying_intent_topics"]},{"type":"null"}],"title":"Type","description":"Dataset type"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","description":"Human-readable dataset type name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Description of the dataset"},"is_accessible":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Accessible","description":"Is this dataset accessible for the user based on their paid plan?"},"options":{"anyOf":[{"items":{"$ref":"#/components/schemas/DatasetOption"},"type":"array"},{"type":"null"}],"title":"Options","description":"Options of the dataset"}},"type":"object","title":"DatasetGroup"},"DatasetOption":{"properties":{"id":{"type":"string","title":"Id","description":"ID of the dataset option"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Description of the dataset option"},"item_type":{"type":"string","enum":["file","folder"],"title":"Item Type","description":"Type of the dataset option. If it is a folder, it means that the dataset is a folder and the path is the path of the folder. In this case, path will have a value and dataset_url will be null. If it is a file, it means that the dataset is a file and the dataset_url will have a value, and path will be null.","default":"file"},"format":{"type":"string","enum":["csv","parquet"],"title":"Format","description":"Format of the dataset"},"frequency":{"anyOf":[{"$ref":"#/components/schemas/DatasetUpdateFrequency"},{"type":"null"}],"description":"Update frequency of the dataset","default":"daily"},"version":{"type":"string","title":"Version","description":"Version of the dataset"},"is_deprecated":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Deprecated","description":"Is this dataset deprecated? If yes, it means that this dataset is no longer available for download."},"dataset_prefix":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dataset Prefix","description":"S3/R2 path prefix URL for listing and accessing datasets (for use with temporary credentials to list files)"},"dataset_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dataset Url","description":"URL of the dataset"},"dictionary_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dictionary Url","description":"URL of the dictionary","deprecated":true},"sample_dataset_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sample Dataset Url","description":"URL of the sample dataset"},"last_updated":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Updated","description":"Last updated date of the dataset"},"size":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Size","description":"Size of the dataset in bytes"}},"type":"object","required":["id","format","version"],"title":"DatasetOption","description":"Dataset option for v1 API. Extends base config with runtime fields."},"DatasetUpdateFrequency":{"type":"string","enum":["hourly","daily","weekly","monthly"],"title":"DatasetUpdateFrequency"},"EmailPreferencesResponseV0":{"properties":{"schema":{"additionalProperties":true,"type":"object","title":"Schema"},"form_data":{"additionalProperties":{"additionalProperties":{"type":"boolean"},"type":"object"},"type":"object","title":"Form Data"}},"type":"object","required":["schema","form_data"],"title":"EmailPreferencesResponseV0"},"Error":{"properties":{"code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Code","description":"The error code. Eg: `E-001`, `E-002`, `E-003`, `E-004`, `E-005`, `E-006`, `E-007`, `E-008`, `E-009`, `E-010`, `E-011`, `E-012`, `E-013`, `E-014`, `E-015`, `E-016`","examples":["E-001","E-002","E-003","E-004","E-005"]},"title":{"type":"string","title":"Title","description":"The error title.","examples":["Not allowed exception","Invalid re2 expression exception","Invalid country code exception","Connection reset by peer exception","Too many requests exception","Internal server error","Validation error","Timeout error"]},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"The error description"}},"type":"object","required":["title"],"title":"Error"},"ErrorResponse":{"properties":{"request_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Request Id","description":"The request id. This is useful to contact us to help you debug the issue. The request_id won't be present in all errors.","examples":[null]},"error":{"$ref":"#/components/schemas/Error"}},"type":"object","required":["error"],"title":"ErrorResponse"},"FundingStage":{"type":"string","enum":["angel","convertible_note","debt_financing","equity_crowdfunding","other","private_equity","seed","series_a","series_b","series_c","series_d","series_e","series_f","series_g","series_h","venture_round_not_specified","series_i","series_j","undisclosed","series_unknown","pre_seed","post_ipo_secondary","post_ipo_equity","post_ipo_debt","non_equity_assistance","late_vc","initial_coin_offering","growth_equity_vc","grant","early_vc","corporate_round","secondary_market","product_crowdfunding"],"title":"FundingStage"},"GeonameCatalogResponse":{"properties":{"id":{"type":"integer","title":"Id","description":"The unique identifier for the location, is based on the geonameid field from the geonames database","examples":[5128581]},"name":{"type":"string","title":"Name","description":"The name of the location","examples":["New York","Paris","Tokyo"]},"admin1_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Admin1 Name","description":"The name of the first-level administrative division (e.g., state or province) of the location","examples":["New York","Île-de-France","Tokyo"]},"country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country Code","description":"The ISO 3166-1 alpha-2 code of the country of the location","examples":["US","FR","JP"]},"feature_code":{"type":"string","title":"Feature Code","description":"The feature code of the location","examples":["PPL","PCL","PCLD"]},"feature_name":{"$ref":"#/components/schemas/GeonameType","description":"The feature class of the location (see https://www.geonames.org/export/codes.html)","examples":["city","country","region"]},"display_name":{"type":"string","title":"Display Name","readOnly":true},"country_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country Name","readOnly":true}},"type":"object","required":["id","name","feature_code","feature_name","display_name","country_name"],"title":"GeonameCatalogResponse"},"GeonameType":{"type":"string","enum":["city","region","country","continent"],"title":"GeonameType"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"IndustryStats":{"properties":{"industry_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Industry Id","description":"ID of the industry"},"industry":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Industry","description":"Name of the industry"},"hierarchy":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Hierarchy","description":"Hierarchy of the industry, according to LinkedIn's taxonomy"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Description of the industry"},"parent_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Parent Id","description":"ID of the parent industry"},"companies":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Companies","description":"Number of companies in the industry"},"jobs":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Jobs","description":"Number of jobs in the industry"}},"type":"object","title":"IndustryStats"},"IndustryStatsResponseV0":{"properties":{"data":{"items":{"$ref":"#/components/schemas/IndustryStats"},"type":"array","title":"Data"},"metadata":{"$ref":"#/components/schemas/BaseMetadata"}},"type":"object","required":["data","metadata"],"title":"IndustryStatsResponseV0"},"JobBaseOut":{"properties":{"id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Id","description":"ID of the job","examples":[1234]},"job_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Job Title","description":"Job title","examples":["Senior Data Engineer"]},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"URL of the job post","examples":["https://example.com/job/1234"]},"source_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Url","description":"Original source URL of the job post (e.g. job board URL)","examples":["https://linkedin.com/jobs/view/1234"]},"date_posted":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Date Posted","description":"Date when the job was posted","examples":["2021-01-01"]},"has_blurred_data":{"type":"boolean","title":"Has Blurred Data","description":"Whether the returned object has company identifiable data blurred or not","default":false},"company":{"type":"string","title":"Company"}},"type":"object","required":["company"],"title":"JobBaseOut"},"JobFilters":{"properties":{"job_title_or":{"items":{"type":"string"},"type":"array","title":"Job Title Or","description":"Natural language patterns to match job titles. Case-insensitive. Only jobs with title that match any of these patterns will be returned. Uses Postgres full text search.","default":[],"examples":[[],["software engineer","data scientist"],["software engineer","data scientist","product manager"]]},"job_title_not":{"items":{"type":"string"},"type":"array","title":"Job Title Not","description":"Natural language patterns to match job titles. Case-insensitive. Only jobs with title that do not match any of these patterns will be returned. Uses Postgres full text search.","default":[],"examples":[[],["software engineer","data scientist"],["software engineer","data scientist","product manager"]]},"job_title_pattern_and":{"items":{"type":"string"},"type":"array","title":"Job Title Pattern And","description":"Regex patterns to match job titles. Case-insensitive. Only jobs with title that match all of these patterns will be returned.","default":[],"examples":[[],["\\bsoftware\\s+engineer\\b","\\bdata\\s+scientist\\b","\\bproduct\\s+manager\\b"]]},"job_title_pattern_or":{"items":{"type":"string"},"type":"array","title":"Job Title Pattern Or","description":"Regex patterns to match job titles. Case-insensitive. Jobs whose job title matches of the filters will be returned.","default":[],"examples":[[],["\\bsoftware\\s+engineer\\b","\\bdata\\s+scientist\\b","\\bproduct\\s+manager\\b"]]},"job_title_pattern_not":{"items":{"type":"string"},"type":"array","title":"Job Title Pattern Not","description":"Regex patterns to match job titles. Case-insensitive. Jobs whose job title doesn't match any of the patterns will be returned.","default":[],"examples":[[],["\\bsoftware\\s+engineer\\b","\\bdata\\s+scientist\\b","\\bproduct\\s+manager\\b"]]},"job_country_code_or":{"items":{"type":"string"},"type":"array","title":"Job Country Code Or","description":"2-letter ISO country code of the location of the job. Can pass more than 1","default":[],"examples":[[],["US","GB"],["US","GB","FR"]]},"job_country_code_not":{"items":{"type":"string"},"type":"array","title":"Job Country Code Not","description":"2-letter ISO country code of the location of the job. Can pass more than 1. Will exclude jobs from these countries","default":[],"examples":[[],["US","GB"],["US","GB","FR"]]},"posted_at_max_age_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Posted At Max Age Days","description":"Date posted max age in days. If 0, only return jobs posted today. If 1, from today and yesterday, etc.","examples":[null,10,2,0]},"posted_at_gte":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Posted At Gte","description":"ISO 8601 date string (yyyy-mm-dd). Only jobs published in this date or after will be returned.","examples":[null,"2025-05-25"]},"posted_at_lte":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Posted At Lte","description":"ISO 8601 date string (yyyy-mm-dd). Only jobs published in this date or before will be returned.","examples":[null,"2025-05-25"]},"discovered_at_max_age_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Discovered At Max Age Days","description":"If 0, only return jobs added to our database in the current day. If 1, from today and yesterday, etc.","examples":[null,10,2,0]},"discovered_at_min_age_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Discovered At Min Age Days","description":"If 1, only return jobs discovered by TheirStack until yesterday. If 2, until 2 days ago, etc.","examples":[null,10,2,0]},"discovered_at_gte":{"anyOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date"},{"type":"null"}],"title":"Discovered At Gte","description":"Only jobs discovered by TheirStack on this date or datetime or after will be returned. In UTC timezone.","examples":[null,"2025-05-25","2025-05-25T12:00:00Z"]},"discovered_at_lte":{"anyOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date"},{"type":"null"}],"title":"Discovered At Lte","description":"Only jobs discovered by TheirStack on this date or datetime or before will be returned. In UTC timezone.","examples":[null,"2025-05-25","2025-05-25T12:00:00Z"]},"job_description_pattern_or":{"items":{"type":"string"},"type":"array","title":"Job Description Pattern Or","description":"Regex patterns to look for in job descriptions. Case-sensitive. Results will include jobs whose description matches any of these patterns. Use (?i) at the start of a pattern to make it case-insensitive. Can pass more than one.","default":[],"examples":[[],["(?i)\\bdata warehouse\\b","(?i)\\bELT\\b","(?i)\\bETL\\b"],["(?i)\\bdata migration\\b","(?i)\\bdatabase migration\\b"],["(?i)\\bobservability\\b","(?i)\\bdistributed tracing\\b"]]},"job_description_pattern_not":{"items":{"type":"string"},"type":"array","title":"Job Description Pattern Not","description":"Regex patterns to look for in job descriptions. Case-sensitive. Results will include jobs whose description don't match any of these patterns. Use (?i) at the start of a pattern to make it case-insensitive. Can pass more than one.","default":[],"examples":[[],["(?i)\\bdata warehouse\\b","(?i)\\bELT\\b","(?i)\\bETL\\b"],["(?i)\\bobservability\\b","(?i)\\bdistributed tracing\\b"]]},"job_description_pattern_and":{"items":{"type":"string"},"type":"array","title":"Job Description Pattern And","description":"Regex patterns that must ALL match the job description (AND logic). Use (?i) at the start of a pattern to make it case-insensitive. Results will only include jobs whose description matches every pattern in this list.","default":[],"examples":[[],["(?i)\\bML.?Ops\\b|\\bmachine learning operations\\b","(?i)\\bquery optim\\w+\\b|\\bquery performance\\b|\\bslow quer\\w+\\b"],["(?i)\\bdata migration\\b|\\bdatabase migration\\b","(?i)\\bno.?sql\\b|\\bdocument store\\b|\\bcolumn store\\b"],["(?i)\\bstream processing\\b|\\bevent streaming\\b|\\bmessage queue\\b","(?i)\\breal.?time\\b|\\blow.?latency\\b"]]},"job_description_pattern_is_case_insensitive":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Job Description Pattern Is Case Insensitive","description":"Deprecated. Has no effect.","default":true,"deprecated":true,"examples":[null,true,false]},"job_description_contains_or":{"items":{"type":"string"},"type":"array","title":"Job Description Contains Or","description":"Search for whole words in job descriptions using word boundaries (\\b). Case-insensitive by default, except for the patterns that are uppercase - in that case we'll respect it. Only finds complete words (e.g., searching 'quality' won't match 'inequality'). Results will include jobs whose description contains any of these words.","default":[],"examples":[[],["python","javascript"],["quality","testing"]]},"job_description_contains_not":{"items":{"type":"string"},"type":"array","title":"Job Description Contains Not","description":"Exclude jobs whose description contains any of these whole words using word boundaries (\\b). Case-insensitive by default, except for the patterns that are uppercase - in that case we'll respect it. Only finds complete words (e.g., searching 'quality' won't match 'inequality'). Results will exclude jobs whose description contains any of these words.","default":[],"examples":[[],["python","javascript"],["quality","testing"]]},"job_description_pattern_case_sensitive_or":{"items":{"type":"string"},"type":"array","title":"Job Description Pattern Case Sensitive Or","description":"Deprecated. Use job_description_pattern_or instead, which now behaves identically.","default":[],"deprecated":true,"examples":[[],["Python","JavaScript"],["API","REST"]]},"remote":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Remote","description":"True: only show remote jobs. False: only show non-remote jobs. None: show all jobs.","examples":[null,true,false]},"only_jobs_with_reports_to":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Only Jobs With Reports To","description":"Only return jobs where we identified the role the hired person would report to. Deprecated field, use reports_to_exists instead.","deprecated":true,"examples":[null,true,false]},"reports_to_exists":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Reports To Exists","description":"Only return jobs where we identified the role the hired person would report to. If True, only return jobs where we identified the role the hired person would report to. If False, only return jobs where we didn't identify the role the hired person would report to. If None, return all jobs.","deprecated":true,"examples":[null,true,false]},"final_url_exists":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Final Url Exists","description":"(Use `property_exists_or / property_exists_and` instead) Only return jobs with a final URL. Typically jobs that were originally posted on an ATS. If True, only return jobs with a final URL. If False, only return jobs without a final URL. If None, return all jobs.","deprecated":true,"examples":[null,true,false]},"only_jobs_with_hiring_managers":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Only Jobs With Hiring Managers","description":"Only return jobs with a hiring manager. If True, only return jobs with a hiring manager. If False, only return jobs without a hiring manager. If None, return all jobs.","deprecated":true,"examples":[null,true,false]},"hiring_managers_exists":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Hiring Managers Exists","description":"(Use `property_exists_or / property_exists_and` instead) If True, only return jobs with a hiring manager. If False, only return jobs without a hiring manager. If None, return all jobs.","deprecated":true,"examples":[null,true,false]},"job_id_or":{"items":{"type":"integer"},"type":"array","title":"Job Id Or","description":"Get jobs with these IDs only.","default":[],"examples":[[],[12423312,2123123,3123123]]},"job_id_not":{"items":{"type":"integer"},"type":"array","title":"Job Id Not","description":"Exclude jobs with these IDs.","default":[],"examples":[[],[12423312,2123123,3123123]]},"job_ids":{"items":{"type":"integer"},"type":"array","title":"Job Ids","description":"Get jobs with these IDs only. Deprecated parameter, use job_id_or instead.","default":[],"deprecated":true},"job_seniority_or":{"items":{"type":"string","enum":["c_level","staff","senior","junior","mid_level"]},"type":"array","title":"Job Seniority Or","description":"Will return jobs where the seniority is any of the ones passed here","default":[],"examples":[[],["intern","entry","mid","senior","principal"]]},"min_salary_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Min Salary Usd","description":"Minimum annual salary in USD. For example, 100000 means $100,000.","examples":[null,100000,150000]},"max_salary_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Salary Usd","description":"Maximum annual salary in USD. For example, 150000 means $150,000.","examples":[null,100000,150000]},"job_technology_slug_or":{"items":{"type":"string"},"type":"array","title":"Job Technology Slug Or","description":"Will return jobs where any of these technologies appear. Case sensitive. Pass slugs. Check out all the technologies we track with the technologies endpoint. If you pass more than one technology, we will return jobs that mentnion all of the technologies.","default":[]},"job_technology_slug_not":{"items":{"type":"string"},"type":"array","title":"Job Technology Slug Not","description":"Will return jobs where none of these technologies appear. Case sensitive. Pass slugs. Check out all the technologies we track with the technologies endpoint.","default":[]},"job_technology_slug_and":{"items":{"type":"string"},"type":"array","title":"Job Technology Slug And","description":"Will return jobs where all of these technologies appear. Case sensitive. Pass slugs. Check out all the technologies we track with the technologies endpoint.","default":[]},"job_keyword_slug_or":{"items":{"type":"string"},"type":"array","title":"Job Keyword Slug Or","description":"Will return jobs where any of these keyword slugs appear. Case sensitive. Check out all the keywords we track at [GET /v0/catalog/keywords](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_keywords_v0)","default":[]},"job_keyword_slug_and":{"items":{"type":"string"},"type":"array","title":"Job Keyword Slug And","description":"Will return jobs where all of these keyword slugs appear. Case sensitive. Check out all the keywords we track at [GET /v0/catalog/keywords](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_keywords_v0)","default":[]},"job_keyword_slug_not":{"items":{"type":"string"},"type":"array","title":"Job Keyword Slug Not","description":"Will return jobs where none of these keyword slugs appear. Case sensitive. Check out all the keywords we track at [GET /v0/catalog/keywords](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_keywords_v0)","default":[]},"job_location_pattern_or":{"items":{"type":"string"},"type":"array","title":"Job Location Pattern Or","description":"Regex patterns to match job locations. Case-insensitive. Searches both the location field and the enhanced locations array (using normalized city and state name fields within each location element). Jobs matching ANY of the provided patterns will be returned. Use this to find jobs in specific cities, states, or regions.","default":[],"examples":[[],["san francisco"],["california","new york"],["madrid"]]},"job_location_pattern_not":{"items":{"type":"string"},"type":"array","title":"Job Location Pattern Not","description":"Regex patterns to exclude job locations. Case-insensitive. Searches both the location field and the enhanced locations array (using normalized city and state name fields within each location element). Jobs matching ANY of the provided patterns will be EXCLUDED from results. Use this to filter out specific locations.","default":[],"examples":[[],["new york","california"],["madrid"]]},"job_location_or":{"items":{"$ref":"#/components/schemas/JobLocationFilter"},"type":"array","title":"Job Location Or","description":"Filter jobs by location. Returns jobs whose locations match ANY of the specified location criteria. Each location criteria is specified using a JobLocationFilter object. (You can find location IDs using the [locations catalog endpoint](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_locations_v0))","default":[],"examples":[[],[{"id":5128581},{"id":2921044}]]},"job_location_not":{"items":{"$ref":"#/components/schemas/JobLocationFilter"},"type":"array","title":"Job Location Not","description":"Filter jobs by location. Returns jobs whose locations DO NOT match ANY of the specified location criteria. Each location criteria is specified using a JobLocationFilter object. (You can find location IDs using the [locations catalog endpoint](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_locations_v0))","default":[],"examples":[[],[{"id":5128581},{"id":2921044}]]},"url_domain_or":{"items":{"type":"string"},"type":"array","title":"Url Domain Or","description":"Include jobs only if their URL domain (from `url` or `source_url`) is in the provided case-insensitive list. For example, ['greenhouse.io', 'workable.com'] will match URLs containing 'greenhouse.io' or 'workable.com'. Refer to our list of sources at https://theirstack.com/en/docs/data/job/sources.","default":[],"examples":[[],["greenhouse.io","workable.com","join.com","lever.co"],["linkedin.com"]]},"url_domain_not":{"items":{"type":"string"},"type":"array","title":"Url Domain Not","description":"Exclude jobs if their URL domain (from `url` or `source_url`) is in the provided case-insensitive list. For example, ['greenhouse.io', 'workable.com'] will exclude URLs containing 'greenhouse.io' or 'workable.com'. Refer to our list of sources at https://theirstack.com/en/docs/data/job/sources.","default":[],"examples":[[],["greenhouse.io","workable.com","join.com","lever.co"],["linkedin.com"]]},"scraper_name_pattern_or":{"items":{"type":"string"},"type":"array","title":"Scraper Name Pattern Or","description":"Regex patterns to match job sources. Case-insensitive.","default":[],"deprecated":true},"easy_apply":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Easy Apply","description":"If True, only return jobs that can be applied directly through the job board. If False, only return jobs that require redirecting to the company's website.","examples":[null,true,false]},"employment_statuses_or":{"anyOf":[{"items":{"$ref":"#/components/schemas/Commitment"},"type":"array"},{"type":"null"}],"title":"Employment Statuses Or","description":"Filter jobs by employment status. Returns jobs that match any of the specified employment types. If no values are provided or an empty list is sent, all jobs regardless of employment status will be returned.","examples":[[],["full_time"],["full_time","part_time"]]}},"additionalProperties":false,"type":"object","title":"JobFilters"},"JobLocation-Input":{"properties":{"id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Id","description":"The unique identifier for the location, is based on the geonameid field from the geonames database","examples":[5128581]},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","description":"The name of the location. If it's a city, it will be the city name; if it's a country, it will be the country name; if it's a region, it will be the region name, etc","examples":["New York City","Germany"]},"type":{"anyOf":[{"$ref":"#/components/schemas/GeonameType"},{"type":"null"}],"description":"The type of the location","examples":["city","country","region"]},"feature_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Feature Code","description":"GeoNames feature code (e.g., 'PPL' for populated place, 'ADM1' for first-order administrative division, 'PCLI' for country). Check all the possible feature codes in the GeoNames documentation","examples":["PPL","ADM1","PCLI"]},"country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country Code","description":"ISO 3166-1 alpha-2 country code of the location","examples":["US","DE"]},"admin1_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Admin1 Name","description":"State of the location (Deprecated): Use 'admin1_name' instead","deprecated":true,"examples":["California"]},"admin1_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Admin1 Code","description":"State code of the location (Deprecated): Use 'admin1_code' instead","deprecated":true,"examples":["06"]},"admin2_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Admin2 Name","description":"The second level administrative division name of the location (e.g., county or district)","examples":["New York County","Los Angeles County"]},"admin2_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Admin2 Code","description":"The second level administrative division code of the location","examples":["NY","LA"]},"continent":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Continent","description":"Continent code of the location","examples":["NA","EU","AS"]},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Latitude","description":"Geographic latitude coordinate for precise mapping","examples":[40.71427,37.774929]},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Longitude","description":"Geographic longitude coordinate for precise mapping","examples":[-74.00597,-122.419416]},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City","description":"The city of the location (Deprecated): Use 'name' field when 'type' is 'city'","deprecated":true},"address":{"type":"null","title":"Address","description":"Address of the location (Deprecated): This field has been removed. Use the location fields (name, admin1_name, country_code, etc.) to construct addresses as needed","deprecated":true,"examples":[null]},"postal_code":{"type":"null","title":"Postal Code","description":"Postal code of the location (Deprecated): This field has been removed and is no longer available","deprecated":true,"examples":[null]}},"type":"object","title":"JobLocation"},"JobLocation-Output":{"properties":{"id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Id","description":"The unique identifier for the location, is based on the geonameid field from the geonames database","examples":[5128581]},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","description":"The name of the location. If it's a city, it will be the city name; if it's a country, it will be the country name; if it's a region, it will be the region name, etc","examples":["New York City","Germany"]},"type":{"anyOf":[{"$ref":"#/components/schemas/GeonameType"},{"type":"null"}],"description":"The type of the location","examples":["city","country","region"]},"feature_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Feature Code","description":"GeoNames feature code (e.g., 'PPL' for populated place, 'ADM1' for first-order administrative division, 'PCLI' for country). Check all the possible feature codes in the GeoNames documentation","examples":["PPL","ADM1","PCLI"]},"country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country Code","description":"ISO 3166-1 alpha-2 country code of the location","examples":["US","DE"]},"admin1_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Admin1 Name","description":"The first level administrative division name of the location","examples":["New York","California"]},"admin1_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Admin1 Code","description":"The first level administrative division code of the location","examples":["NY","CA"]},"admin2_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Admin2 Name","description":"The second level administrative division name of the location (e.g., county or district)","examples":["New York County","Los Angeles County"]},"admin2_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Admin2 Code","description":"The second level administrative division code of the location","examples":["NY","LA"]},"continent":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Continent","description":"Continent code of the location","examples":["NA","EU","AS"]},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Latitude","description":"Geographic latitude coordinate for precise mapping","examples":[40.71427,37.774929]},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Longitude","description":"Geographic longitude coordinate for precise mapping","examples":[-74.00597,-122.419416]},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City","description":"The city of the location (Deprecated): Use 'name' field when 'type' is 'city'","deprecated":true},"address":{"type":"null","title":"Address","description":"Address of the location (Deprecated): This field has been removed. Use the location fields (name, admin1_name, country_code, etc.) to construct addresses as needed","deprecated":true,"examples":[null]},"postal_code":{"type":"null","title":"Postal Code","description":"Postal code of the location (Deprecated): This field has been removed and is no longer available","deprecated":true,"examples":[null]},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State","description":"State of the location (Deprecated): Use 'admin1_name' instead","deprecated":true,"examples":["California"]},"state_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State Code","description":"State code of the location (Deprecated): Use 'admin1_code' instead","deprecated":true,"examples":["06"]},"display_name":{"type":"string","title":"Display Name","description":"A human-readable display name for the location, constructed from available location fields","readOnly":true,"examples":["New York City, New York, United States","Germany","California, United States"]},"country_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country Name","description":"The full country name derived from the country_code","readOnly":true,"examples":["United States","Germany","United Kingdom"]}},"type":"object","required":["display_name","country_name"],"title":"JobLocation"},"JobLocationFilter":{"properties":{"id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Id","description":"Filter by location id. You can discover all the locations from the locations catalog endpoint [GET /v0/catalog/locations](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_locations_v0)","examples":[3117735]}},"type":"object","title":"JobLocationFilter"},"JobSearchFilters-Input":{"properties":{"order_by":{"items":{"$ref":"#/components/schemas/ColumnSortJobSearch"},"type":"array","title":"Order By","description":"List of column objects. You can pass several columns to order by, in order of priority. Only `field` is required, `desc` is True by default.","default":[{"desc":true,"field":"date_posted"},{"desc":true,"field":"discovered_at"}],"deprecated":true},"offset":{"type":"integer","minimum":0.0,"title":"Offset","description":"Number of results to skip. Required for [offset-based pagination](https://theirstack.com/en/docs/api-reference/pagination).","default":0,"examples":[0]},"page":{"type":"integer","minimum":0.0,"title":"Page","description":"Page number. Required when using [page-based pagination](https://theirstack.com/en/docs/api-reference/pagination).","default":0,"examples":[0]},"limit":{"type":"integer","minimum":1.0,"title":"Limit","description":"Number of results per page","default":25,"examples":[25]},"cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor","description":"Cursor for pagination"},"job_title_or":{"items":{"type":"string"},"type":"array","title":"Job Title Or","description":"Natural language patterns to match job titles. Case-insensitive. Only jobs with title that match any of these patterns will be returned. Uses Postgres full text search.","default":[],"examples":[[],["software engineer","data scientist"],["software engineer","data scientist","product manager"]]},"job_title_not":{"items":{"type":"string"},"type":"array","title":"Job Title Not","description":"Natural language patterns to match job titles. Case-insensitive. Only jobs with title that do not match any of these patterns will be returned. Uses Postgres full text search.","default":[],"examples":[[],["software engineer","data scientist"],["software engineer","data scientist","product manager"]]},"job_title_pattern_and":{"items":{"type":"string"},"type":"array","title":"Job Title Pattern And","description":"Regex patterns to match job titles. Case-insensitive. Only jobs with title that match all of these patterns will be returned.","default":[],"examples":[[],["\\bsoftware\\s+engineer\\b","\\bdata\\s+scientist\\b","\\bproduct\\s+manager\\b"]]},"job_title_pattern_or":{"items":{"type":"string"},"type":"array","title":"Job Title Pattern Or","description":"Regex patterns to match job titles. Case-insensitive. Jobs whose job title matches of the filters will be returned.","default":[],"examples":[[],["\\bsoftware\\s+engineer\\b","\\bdata\\s+scientist\\b","\\bproduct\\s+manager\\b"]]},"job_title_pattern_not":{"items":{"type":"string"},"type":"array","title":"Job Title Pattern Not","description":"Regex patterns to match job titles. Case-insensitive. Jobs whose job title doesn't match any of the patterns will be returned.","default":[],"examples":[[],["\\bsoftware\\s+engineer\\b","\\bdata\\s+scientist\\b","\\bproduct\\s+manager\\b"]]},"job_country_code_or":{"items":{"type":"string"},"type":"array","title":"Job Country Code Or","description":"2-letter ISO country code of the location of the job. Can pass more than 1","default":[],"examples":[[],["US","GB"],["US","GB","FR"]]},"job_country_code_not":{"items":{"type":"string"},"type":"array","title":"Job Country Code Not","description":"2-letter ISO country code of the location of the job. Can pass more than 1. Will exclude jobs from these countries","default":[],"examples":[[],["US","GB"],["US","GB","FR"]]},"posted_at_max_age_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Posted At Max Age Days","description":"Date posted max age in days. If 0, only return jobs posted today. If 1, from today and yesterday, etc.","examples":[null,10,2,0]},"posted_at_gte":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Posted At Gte","description":"ISO 8601 date string (yyyy-mm-dd). Only jobs published in this date or after will be returned.","examples":[null,"2025-05-25"]},"posted_at_lte":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Posted At Lte","description":"ISO 8601 date string (yyyy-mm-dd). Only jobs published in this date or before will be returned.","examples":[null,"2025-05-25"]},"discovered_at_max_age_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Discovered At Max Age Days","description":"If 0, only return jobs added to our database in the current day. If 1, from today and yesterday, etc.","examples":[null,10,2,0]},"discovered_at_min_age_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Discovered At Min Age Days","description":"If 1, only return jobs discovered by TheirStack until yesterday. If 2, until 2 days ago, etc.","examples":[null,10,2,0]},"discovered_at_gte":{"anyOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date"},{"type":"null"}],"title":"Discovered At Gte","description":"Only jobs discovered by TheirStack on this date or datetime or after will be returned. In UTC timezone.","examples":[null,"2025-05-25","2025-05-25T12:00:00Z"]},"discovered_at_lte":{"anyOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date"},{"type":"null"}],"title":"Discovered At Lte","description":"Only jobs discovered by TheirStack on this date or datetime or before will be returned. In UTC timezone.","examples":[null,"2025-05-25","2025-05-25T12:00:00Z"]},"job_description_pattern_or":{"items":{"type":"string"},"type":"array","title":"Job Description Pattern Or","description":"Regex patterns to look for in job descriptions. Case-sensitive. Results will include jobs whose description matches any of these patterns. Use (?i) at the start of a pattern to make it case-insensitive. Can pass more than one.","default":[],"examples":[[],["(?i)\\bdata warehouse\\b","(?i)\\bELT\\b","(?i)\\bETL\\b"],["(?i)\\bdata migration\\b","(?i)\\bdatabase migration\\b"],["(?i)\\bobservability\\b","(?i)\\bdistributed tracing\\b"]]},"job_description_pattern_not":{"items":{"type":"string"},"type":"array","title":"Job Description Pattern Not","description":"Regex patterns to look for in job descriptions. Case-sensitive. Results will include jobs whose description don't match any of these patterns. Use (?i) at the start of a pattern to make it case-insensitive. Can pass more than one.","default":[],"examples":[[],["(?i)\\bdata warehouse\\b","(?i)\\bELT\\b","(?i)\\bETL\\b"],["(?i)\\bobservability\\b","(?i)\\bdistributed tracing\\b"]]},"job_description_pattern_and":{"items":{"type":"string"},"type":"array","title":"Job Description Pattern And","description":"Regex patterns that must ALL match the job description (AND logic). Use (?i) at the start of a pattern to make it case-insensitive. Results will only include jobs whose description matches every pattern in this list.","default":[],"examples":[[],["(?i)\\bML.?Ops\\b|\\bmachine learning operations\\b","(?i)\\bquery optim\\w+\\b|\\bquery performance\\b|\\bslow quer\\w+\\b"],["(?i)\\bdata migration\\b|\\bdatabase migration\\b","(?i)\\bno.?sql\\b|\\bdocument store\\b|\\bcolumn store\\b"],["(?i)\\bstream processing\\b|\\bevent streaming\\b|\\bmessage queue\\b","(?i)\\breal.?time\\b|\\blow.?latency\\b"]]},"job_description_pattern_is_case_insensitive":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Job Description Pattern Is Case Insensitive","description":"Deprecated. Has no effect.","default":true,"deprecated":true,"examples":[null,true,false]},"job_description_contains_or":{"items":{"type":"string"},"type":"array","title":"Job Description Contains Or","description":"Search for whole words in job descriptions using word boundaries (\\b). Case-insensitive by default, except for the patterns that are uppercase - in that case we'll respect it. Only finds complete words (e.g., searching 'quality' won't match 'inequality'). Results will include jobs whose description contains any of these words.","default":[],"examples":[[],["python","javascript"],["quality","testing"]]},"job_description_contains_not":{"items":{"type":"string"},"type":"array","title":"Job Description Contains Not","description":"Exclude jobs whose description contains any of these whole words using word boundaries (\\b). Case-insensitive by default, except for the patterns that are uppercase - in that case we'll respect it. Only finds complete words (e.g., searching 'quality' won't match 'inequality'). Results will exclude jobs whose description contains any of these words.","default":[],"examples":[[],["python","javascript"],["quality","testing"]]},"job_description_pattern_case_sensitive_or":{"items":{"type":"string"},"type":"array","title":"Job Description Pattern Case Sensitive Or","description":"Deprecated. Use job_description_pattern_or instead, which now behaves identically.","default":[],"deprecated":true,"examples":[[],["Python","JavaScript"],["API","REST"]]},"remote":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Remote","description":"True: only show remote jobs. False: only show non-remote jobs. None: show all jobs.","examples":[null,true,false]},"only_jobs_with_reports_to":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Only Jobs With Reports To","description":"Only return jobs where we identified the role the hired person would report to. Deprecated field, use reports_to_exists instead.","deprecated":true,"examples":[null,true,false]},"reports_to_exists":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Reports To Exists","description":"Only return jobs where we identified the role the hired person would report to. If True, only return jobs where we identified the role the hired person would report to. If False, only return jobs where we didn't identify the role the hired person would report to. If None, return all jobs.","deprecated":true,"examples":[null,true,false]},"final_url_exists":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Final Url Exists","description":"(Use `property_exists_or / property_exists_and` instead) Only return jobs with a final URL. Typically jobs that were originally posted on an ATS. If True, only return jobs with a final URL. If False, only return jobs without a final URL. If None, return all jobs.","deprecated":true,"examples":[null,true,false]},"only_jobs_with_hiring_managers":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Only Jobs With Hiring Managers","description":"Only return jobs with a hiring manager. If True, only return jobs with a hiring manager. If False, only return jobs without a hiring manager. If None, return all jobs.","deprecated":true,"examples":[null,true,false]},"hiring_managers_exists":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Hiring Managers Exists","description":"(Use `property_exists_or / property_exists_and` instead) If True, only return jobs with a hiring manager. If False, only return jobs without a hiring manager. If None, return all jobs.","deprecated":true,"examples":[null,true,false]},"job_id_or":{"items":{"type":"integer"},"type":"array","title":"Job Id Or","description":"Get jobs with these IDs only.","default":[],"examples":[[],[12423312,2123123,3123123]]},"job_id_not":{"items":{"type":"integer"},"type":"array","title":"Job Id Not","description":"Exclude jobs with these IDs.","default":[],"examples":[[],[12423312,2123123,3123123]]},"job_ids":{"items":{"type":"integer"},"type":"array","title":"Job Ids","description":"Get jobs with these IDs only. Deprecated parameter, use job_id_or instead.","default":[],"deprecated":true},"job_seniority_or":{"items":{"type":"string","enum":["c_level","staff","senior","junior","mid_level"]},"type":"array","title":"Job Seniority Or","description":"Will return jobs where the seniority is any of the ones passed here","default":[],"examples":[[],["intern","entry","mid","senior","principal"]]},"min_salary_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Min Salary Usd","description":"Minimum annual salary in USD. For example, 100000 means $100,000.","examples":[null,100000,150000]},"max_salary_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Salary Usd","description":"Maximum annual salary in USD. For example, 150000 means $150,000.","examples":[null,100000,150000]},"job_technology_slug_or":{"items":{"type":"string"},"type":"array","title":"Job Technology Slug Or","description":"Will return jobs where any of these technologies appear. Case sensitive. Pass slugs. Check out all the technologies we track with the technologies endpoint. If you pass more than one technology, we will return jobs that mentnion all of the technologies.","default":[]},"job_technology_slug_not":{"items":{"type":"string"},"type":"array","title":"Job Technology Slug Not","description":"Will return jobs where none of these technologies appear. Case sensitive. Pass slugs. Check out all the technologies we track with the technologies endpoint.","default":[]},"job_technology_slug_and":{"items":{"type":"string"},"type":"array","title":"Job Technology Slug And","description":"Will return jobs where all of these technologies appear. Case sensitive. Pass slugs. Check out all the technologies we track with the technologies endpoint.","default":[]},"job_keyword_slug_or":{"items":{"type":"string"},"type":"array","title":"Job Keyword Slug Or","description":"Will return jobs where any of these keyword slugs appear. Case sensitive. Check out all the keywords we track at [GET /v0/catalog/keywords](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_keywords_v0)","default":[]},"job_keyword_slug_and":{"items":{"type":"string"},"type":"array","title":"Job Keyword Slug And","description":"Will return jobs where all of these keyword slugs appear. Case sensitive. Check out all the keywords we track at [GET /v0/catalog/keywords](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_keywords_v0)","default":[]},"job_keyword_slug_not":{"items":{"type":"string"},"type":"array","title":"Job Keyword Slug Not","description":"Will return jobs where none of these keyword slugs appear. Case sensitive. Check out all the keywords we track at [GET /v0/catalog/keywords](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_keywords_v0)","default":[]},"job_location_pattern_or":{"items":{"type":"string"},"type":"array","title":"Job Location Pattern Or","description":"Regex patterns to match job locations. Case-insensitive. Searches both the location field and the enhanced locations array (using normalized city and state name fields within each location element). Jobs matching ANY of the provided patterns will be returned. Use this to find jobs in specific cities, states, or regions.","default":[],"examples":[[],["san francisco"],["california","new york"],["madrid"]]},"job_location_pattern_not":{"items":{"type":"string"},"type":"array","title":"Job Location Pattern Not","description":"Regex patterns to exclude job locations. Case-insensitive. Searches both the location field and the enhanced locations array (using normalized city and state name fields within each location element). Jobs matching ANY of the provided patterns will be EXCLUDED from results. Use this to filter out specific locations.","default":[],"examples":[[],["new york","california"],["madrid"]]},"job_location_or":{"items":{"$ref":"#/components/schemas/JobLocationFilter"},"type":"array","title":"Job Location Or","description":"Filter jobs by location. Returns jobs whose locations match ANY of the specified location criteria. Each location criteria is specified using a JobLocationFilter object. (You can find location IDs using the [locations catalog endpoint](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_locations_v0))","default":[],"examples":[[],[{"id":5128581},{"id":2921044}]]},"job_location_not":{"items":{"$ref":"#/components/schemas/JobLocationFilter"},"type":"array","title":"Job Location Not","description":"Filter jobs by location. Returns jobs whose locations DO NOT match ANY of the specified location criteria. Each location criteria is specified using a JobLocationFilter object. (You can find location IDs using the [locations catalog endpoint](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_locations_v0))","default":[],"examples":[[],[{"id":5128581},{"id":2921044}]]},"url_domain_or":{"items":{"type":"string"},"type":"array","title":"Url Domain Or","description":"Include jobs only if their URL domain (from `url` or `source_url`) is in the provided case-insensitive list. For example, ['greenhouse.io', 'workable.com'] will match URLs containing 'greenhouse.io' or 'workable.com'. Refer to our list of sources at https://theirstack.com/en/docs/data/job/sources.","default":[],"examples":[[],["greenhouse.io","workable.com","join.com","lever.co"],["linkedin.com"]]},"url_domain_not":{"items":{"type":"string"},"type":"array","title":"Url Domain Not","description":"Exclude jobs if their URL domain (from `url` or `source_url`) is in the provided case-insensitive list. For example, ['greenhouse.io', 'workable.com'] will exclude URLs containing 'greenhouse.io' or 'workable.com'. Refer to our list of sources at https://theirstack.com/en/docs/data/job/sources.","default":[],"examples":[[],["greenhouse.io","workable.com","join.com","lever.co"],["linkedin.com"]]},"scraper_name_pattern_or":{"items":{"type":"string"},"type":"array","title":"Scraper Name Pattern Or","description":"Regex patterns to match job sources. Case-insensitive.","default":[],"deprecated":true},"easy_apply":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Easy Apply","description":"If True, only return jobs that can be applied directly through the job board. If False, only return jobs that require redirecting to the company's website.","examples":[null,true,false]},"employment_statuses_or":{"anyOf":[{"items":{"$ref":"#/components/schemas/Commitment"},"type":"array"},{"type":"null"}],"title":"Employment Statuses Or","description":"Filter jobs by employment status. Returns jobs that match any of the specified employment types. If no values are provided or an empty list is sent, all jobs regardless of employment status will be returned.","examples":[[],["full_time"],["full_time","part_time"]]},"company_name_or":{"items":{"type":"string"},"type":"array","title":"Company Name Or","description":"Only return companies that match these names exactly, case-sensitively. This filter acts as an OR filter, so if you pass more than one company name, it will return companies that match any of the names.","default":[],"examples":[[],["Google","Facebook","Apple"]]},"company_name_case_insensitive_or":{"items":{"type":"string"},"type":"array","title":"Company Name Case Insensitive Or","description":"Only return companies that match these names exactly, case-insensitively.","default":[],"examples":[[],["google","stripe"]]},"company_id_or":{"items":{"type":"string"},"type":"array","title":"Company Id Or","description":"Only return companies that match these IDs exactly. This filter acts as an OR filter, so if you pass more than one company ID, it will return companies that match any of the IDs.","default":[],"examples":[[],["1234567890","1234567891"]]},"company_domain_or":{"items":{"type":"string"},"type":"array","title":"Company Domain Or","description":"Only return companies that match these domains exactly. It accepts full urls (https://www.google.com/) and emails (john.polo@gmail.com). This filter acts as an OR filter, so if you pass more than one company domain, it will return companies that match any of the domains.","default":[],"examples":[[],["google.com","stripe.com"],["https://www.google.com/","https://stripe.com/"],["andrew@stripe.com ","mark@meta.com"]]},"company_domain_not":{"items":{"type":"string"},"type":"array","title":"Company Domain Not","description":"Only return companies that don't match these domains exactly. It accepts full urls (https://www.google.com/) and emails (john.polo@gmail.com).","default":[],"examples":[[],["google.com","stripe.com"],["https://www.google.com/","https://stripe.com/"],["andrew@stripe.com ","mark@meta.com"]]},"company_name_not":{"items":{"type":"string"},"type":"array","title":"Company Name Not","description":"Only return companies that don't match these names exactly, case-sensitively.","default":[],"examples":[[],["Google","Facebook","Apple"]]},"company_name_partial_match_or":{"items":{"type":"string"},"type":"array","title":"Company Name Partial Match Or","description":"Company names. Will return companies whose name contain any of the the substrings passed here, case-insensitively. For example, if you pass \"google\", it will return \"Google\", \"Google LLC\", \"Google Inc\", etc.","default":[],"examples":[[],["google","stripe"]]},"company_name_partial_match_not":{"items":{"type":"string"},"type":"array","title":"Company Name Partial Match Not","description":"Company names. Will return companies whose name doesn't contain any of the the substrings passed here, case-insensitively. For example, if you pass 'google', it will exclude 'Google', 'Google LLC', 'Google Inc', etc.","default":[],"examples":[[],["google","stripe"]]},"company_linkedin_url_or":{"items":{"type":"string"},"type":"array","title":"Company Linkedin Url Or","description":"Return companies whose LinkedIn URL matches any of the slugs passed here. Can also pass full LinkedIn company URLs.","default":[],"examples":[[],["https://www.linkedin.com/company/google/"]]},"blur_company_data":{"type":"boolean","title":"Blur Company Data","description":"Enable preview mode to return blurred data without consuming API credits. When enabled, sensitive company fields (name, domain, URLs, descriptions) and job-specific fields (description, URLs) are blurred. This mode is useful for sales software integrations to show data previews to end users. Not available when filtering by company identifiers (company_name, company_domain, company_linkedin_url, company_id). Learn more about [here](https://theirstack.com/en/docs/api/preview-data-mode)","default":false},"property_exists_or":{"items":{"type":"string","enum":["company_object.domain","company_object.linkedin_url","final_url","hiring_team","employment_statuses"]},"type":"array","title":"Property Exists Or","description":"Return jobs that have any of these fields not null. For example, if you pass ['final_url'], it will return jobs that have a final_url set. This field also support chaining of fields. For example, if you pass ['company_object.domain', 'company_object.linkedin_url'], it will return jobs that have a company domain or a company linkedin_url set.","default":[],"examples":[[],["company_object.domain","company_object.linkedin_url","final_url"]]},"property_exists_and":{"items":{"type":"string","enum":["company_object.domain","company_object.linkedin_url","final_url","hiring_team","employment_statuses"]},"type":"array","title":"Property Exists And","default":[],"examples":[[],["company_object.domain","company_object.linkedin_url","final_url"]]},"company_description_pattern_or":{"items":{"type":"string"},"type":"array","title":"Company Description Pattern Or","description":"Case-insensitive patterns to match in the company description. Will return companies that match any of the patterns.","default":[]},"company_description_pattern_not":{"items":{"type":"string"},"type":"array","title":"Company Description Pattern Not","description":"Case-insensitive patterns to match in the company description. Will return companies that match any of the patterns.","default":[]},"company_description_pattern_accent_insensitive":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Company Description Pattern Accent Insensitive","description":"Set to True to make company description searches accent insensitive. For example, \"á\" will match \"a\" as well.","default":false,"examples":[null,true,false]},"min_revenue_usd":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Revenue Usd","description":"Minimum company revenue, in USD","examples":[null]},"max_revenue_usd":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Revenue Usd","description":"Maximum company revenue, in USD","examples":[null]},"min_employee_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Employee Count","description":"Minimum number of employees in a company","examples":[null,100]},"max_employee_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Employee Count","description":"Maximum number of employees in a company","examples":[null,100]},"min_employee_count_or_null":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Employee Count Or Null","description":"Minimum number of employees in a company. If we don't have company size information, we will return it as well.","examples":[null,100]},"max_employee_count_or_null":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Employee Count Or Null","description":"Maximum number of employees in a company. If we don't have company size information, we will return it as well.","examples":[null,100]},"min_funding_usd":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Funding Usd","description":"Minimum company funding, in USD","examples":[null,1000000000]},"max_funding_usd":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Funding Usd","description":"Maximum company funding, in USD","examples":[null,1000000000]},"funding_stage_or":{"items":{"type":"string"},"type":"array","title":"Funding Stage Or","description":"Funding stages of companies returned. Possible values: ['angel', 'convertible_note', 'debt_financing', 'equity_crowdfunding', 'other', 'private_equity', 'seed', 'series_a', 'series_b', 'series_c', 'series_d', 'series_e', 'series_f', 'series_g', 'series_h', 'venture_round_not_specified', 'series_i', 'series_j', 'undisclosed', 'series_unknown', 'pre_seed', 'post_ipo_secondary', 'post_ipo_equity', 'post_ipo_debt', 'non_equity_assistance', 'late_vc', 'initial_coin_offering', 'growth_equity_vc', 'grant', 'early_vc', 'corporate_round', 'secondary_market', 'product_crowdfunding']","default":[]},"industry_or":{"items":{"type":"string"},"type":"array","title":"Industry Or","description":"Names of industries, case-insensitive. Results will only include companies that belong to any of the industries specified in this parameter. Available values: [GET /v0/catalog/industries](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_industries_v0)\n\n    WARNING: Deprecated parameter. Use the industry_id_or field instead. ","default":[],"deprecated":true},"industry_not":{"items":{"type":"string"},"type":"array","title":"Industry Not","description":"Names of industries, case-insensitive. Results will exclude companies that belong to any of the industries specified in this parameter. Available values: [GET /v0/catalog/industries](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_industries_v0)\n\n    WARNING: Deprecated parameter. Use the industry_id_not field instead. ","default":[],"deprecated":true},"industry_id_or":{"items":{"type":"integer"},"type":"array","title":"Industry Id Or","description":"Industry codes. You can use any of [LinkedIn's Industry Codes V2](https://learn.microsoft.com/en-us/linkedin/shared/references/reference-tables/industry-codes-v2) or [GET /v0/catalog/industries](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_industries_v0)","default":[]},"industry_id_not":{"items":{"type":"integer"},"type":"array","title":"Industry Id Not","description":"Industry ids to exclude.You can use any of [LinkedIn's Industry Codes V2](https://learn.microsoft.com/en-us/linkedin/shared/references/reference-tables/industry-codes-v2) or [GET /v0/catalog/industries](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_industries_v0)","default":[]},"company_tags_or":{"items":{"type":"string"},"type":"array","title":"Company Tags Or","description":"Return companies that match any of these keywords","default":[]},"company_type":{"anyOf":[{"type":"string","enum":["recruiting_agency","direct_employer","all"]},{"type":"null"}],"title":"Company Type","description":"Filter by company type."},"company_investors_or":{"items":{"type":"string"},"type":"array","title":"Company Investors Or","description":"Investors of the company","default":[]},"company_investors_partial_match_or":{"items":{"type":"string"},"type":"array","title":"Company Investors Partial Match Or","description":"Investors of the company. Will return companies for which any of their investors contains any of the substrings passed here. For example, if you pass 'andree', all funds that match it (like 'Andreessen Horowitz', 'Andreessen Horowitz LLC', etc).","default":[]},"company_technology_slug_or":{"items":{"type":"string"},"type":"array","title":"Company Technology Slug Or","description":"Will return jobs from companies that that have mentioned any of these technologies in their jobs (not necessarily in the jobs returned). Case sensitive. Pass slugs. Check out all the technologies we track at [GET /v0/catalog/technologies](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_technologies_v0). Deprecated: use company_keyword_slug_or instead.","default":[],"deprecated":true},"company_technology_slug_and":{"items":{"type":"string"},"type":"array","title":"Company Technology Slug And","description":"Will return jobs from companies that that have mentioned all of these technologies in their jobs (not necessarily in the jobs returned). Case sensitive. Pass slugs. Check out all the technologies we track at [GET /v0/catalog/technologies](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_technologies_v0). Deprecated: use company_keyword_slug_and instead.","default":[],"deprecated":true},"company_technology_slug_not":{"items":{"type":"string"},"type":"array","title":"Company Technology Slug Not","description":"Will return jobs from companies that that haven't mentioned any of these technologies in their jobs. Case sensitive. Pass slugs. Check out all the technologies we track at [GET /v0/catalog/technologies](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_technologies_v0). Deprecated: use company_keyword_slug_not instead.","default":[],"deprecated":true},"company_keyword_slug_or":{"items":{"type":"string"},"type":"array","title":"Company Keyword Slug Or","description":"Return results from companies that have mentioned any of these keywords in their jobs. Case sensitive. Pass slugs. Check out all the keywords we track at [GET /v0/catalog/keywords](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_keywords_v0)","default":[]},"company_keyword_slug_and":{"items":{"type":"string"},"type":"array","title":"Company Keyword Slug And","description":"Return results from companies that have mentioned all of these keywords in their jobs. Case sensitive. Pass slugs. Check out all the keywords we track at [GET /v0/catalog/keywords](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_keywords_v0)","default":[]},"company_keyword_slug_not":{"items":{"type":"string"},"type":"array","title":"Company Keyword Slug Not","description":"Return results from companies that haven't mentioned any of these keywords in their jobs. Case sensitive. Pass slugs. Check out all the keywords we track at [GET /v0/catalog/keywords](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_keywords_v0)","default":[]},"only_yc_companies":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Only Yc Companies","description":"Only return YC companies","default":false},"company_location_pattern_or":{"items":{"type":"string"},"type":"array","title":"Company Location Pattern Or","description":"Return companies whose city matches any of the patterns passed here. Case insensitive. For example, if you pass 'san francisco', it will return companies whose city is 'San Francisco', 'San Francisco Bay Area', etc.","default":[]},"company_country_code_or":{"items":{"type":"string"},"type":"array","title":"Company Country Code Or","description":"Return companies whose HQ country code is any of the ones passed here, case sensitive. Pass ISO2 country codes.","default":[]},"company_country_code_not":{"items":{"type":"string"},"type":"array","title":"Company Country Code Not","description":"Return companies whose HQ country code is not any of the ones passed here, case sensitive. Pass ISO2 country codes.","default":[]},"company_list_id_or":{"items":{"type":"integer"},"type":"array","title":"Company List Id Or","description":"Return companies that belong to any of the company lists passed here","default":[]},"company_list_id_not":{"items":{"type":"integer"},"type":"array","title":"Company List Id Not","description":"Return companies that don't belong to any of the company lists passed here","default":[]},"company_linkedin_url_exists":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Company Linkedin Url Exists","description":"(Use `property_exists_or / property_exists_and` instead) Only return companies with a LinkedIn URL","deprecated":true,"examples":[null]},"revealed_company_data":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Revealed Company Data","description":"This field is deprecated and has no effect.","deprecated":true,"examples":[null]},"last_funding_round_date_lte":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Last Funding Round Date Lte","description":"Only return companies whose last funding round date is before or on this date. Format: 'YYYY-MM-DD'","examples":[null,"2025-05-25"]},"last_funding_round_date_gte":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Last Funding Round Date Gte","description":"Only return companies whose last funding round date is after or on this date. Format: 'YYYY-MM-DD'","examples":[null,"2025-05-25"]},"include_total_results":{"type":"boolean","title":"Include Total Results","description":"When enabled, calculates and returns `total_results` and `total_companies` fields in the response. WARNING: This significantly slows down responses as it requires reading the entire dataset. Recommended usage: enable only for the initial request to get totals, then disable for subsequent pagination requests.","default":false}},"additionalProperties":false,"type":"object","title":"JobSearchFilters"},"JobSearchFilters-Output":{"properties":{"order_by":{"items":{"$ref":"#/components/schemas/ColumnSortJobSearch"},"type":"array","title":"Order By","description":"List of column objects. You can pass several columns to order by, in order of priority. Only `field` is required, `desc` is True by default.","default":[{"desc":true,"field":"date_posted"},{"desc":true,"field":"discovered_at"}],"deprecated":true},"offset":{"type":"integer","minimum":0.0,"title":"Offset","description":"Number of results to skip. Required for [offset-based pagination](https://theirstack.com/en/docs/api-reference/pagination).","default":0,"examples":[0]},"page":{"type":"integer","minimum":0.0,"title":"Page","description":"Page number. Required when using [page-based pagination](https://theirstack.com/en/docs/api-reference/pagination).","default":0,"examples":[0]},"limit":{"type":"integer","minimum":1.0,"title":"Limit","description":"Number of results per page","default":25,"examples":[25]},"job_title_or":{"items":{"type":"string"},"type":"array","title":"Job Title Or","description":"Natural language patterns to match job titles. Case-insensitive. Only jobs with title that match any of these patterns will be returned. Uses Postgres full text search.","default":[],"examples":[[],["software engineer","data scientist"],["software engineer","data scientist","product manager"]]},"job_title_not":{"items":{"type":"string"},"type":"array","title":"Job Title Not","description":"Natural language patterns to match job titles. Case-insensitive. Only jobs with title that do not match any of these patterns will be returned. Uses Postgres full text search.","default":[],"examples":[[],["software engineer","data scientist"],["software engineer","data scientist","product manager"]]},"job_title_pattern_and":{"items":{"type":"string"},"type":"array","title":"Job Title Pattern And","description":"Regex patterns to match job titles. Case-insensitive. Only jobs with title that match all of these patterns will be returned.","default":[],"examples":[[],["\\bsoftware\\s+engineer\\b","\\bdata\\s+scientist\\b","\\bproduct\\s+manager\\b"]]},"job_title_pattern_or":{"items":{"type":"string"},"type":"array","title":"Job Title Pattern Or","description":"Regex patterns to match job titles. Case-insensitive. Jobs whose job title matches of the filters will be returned.","default":[],"examples":[[],["\\bsoftware\\s+engineer\\b","\\bdata\\s+scientist\\b","\\bproduct\\s+manager\\b"]]},"job_title_pattern_not":{"items":{"type":"string"},"type":"array","title":"Job Title Pattern Not","description":"Regex patterns to match job titles. Case-insensitive. Jobs whose job title doesn't match any of the patterns will be returned.","default":[],"examples":[[],["\\bsoftware\\s+engineer\\b","\\bdata\\s+scientist\\b","\\bproduct\\s+manager\\b"]]},"job_country_code_or":{"items":{"type":"string"},"type":"array","title":"Job Country Code Or","description":"2-letter ISO country code of the location of the job. Can pass more than 1","default":[],"examples":[[],["US","GB"],["US","GB","FR"]]},"job_country_code_not":{"items":{"type":"string"},"type":"array","title":"Job Country Code Not","description":"2-letter ISO country code of the location of the job. Can pass more than 1. Will exclude jobs from these countries","default":[],"examples":[[],["US","GB"],["US","GB","FR"]]},"posted_at_max_age_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Posted At Max Age Days","description":"Date posted max age in days. If 0, only return jobs posted today. If 1, from today and yesterday, etc.","examples":[null,10,2,0]},"posted_at_gte":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Posted At Gte","description":"ISO 8601 date string (yyyy-mm-dd). Only jobs published in this date or after will be returned.","examples":[null,"2025-05-25"]},"posted_at_lte":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Posted At Lte","description":"ISO 8601 date string (yyyy-mm-dd). Only jobs published in this date or before will be returned.","examples":[null,"2025-05-25"]},"discovered_at_max_age_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Discovered At Max Age Days","description":"If 0, only return jobs added to our database in the current day. If 1, from today and yesterday, etc.","examples":[null,10,2,0]},"discovered_at_min_age_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Discovered At Min Age Days","description":"If 1, only return jobs discovered by TheirStack until yesterday. If 2, until 2 days ago, etc.","examples":[null,10,2,0]},"discovered_at_gte":{"anyOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date"},{"type":"null"}],"title":"Discovered At Gte","description":"Only jobs discovered by TheirStack on this date or datetime or after will be returned. In UTC timezone.","examples":[null,"2025-05-25","2025-05-25T12:00:00Z"]},"discovered_at_lte":{"anyOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date"},{"type":"null"}],"title":"Discovered At Lte","description":"Only jobs discovered by TheirStack on this date or datetime or before will be returned. In UTC timezone.","examples":[null,"2025-05-25","2025-05-25T12:00:00Z"]},"job_description_pattern_or":{"items":{"type":"string"},"type":"array","title":"Job Description Pattern Or","description":"Regex patterns to look for in job descriptions. Case-sensitive. Results will include jobs whose description matches any of these patterns. Use (?i) at the start of a pattern to make it case-insensitive. Can pass more than one.","default":[],"examples":[[],["(?i)\\bdata warehouse\\b","(?i)\\bELT\\b","(?i)\\bETL\\b"],["(?i)\\bdata migration\\b","(?i)\\bdatabase migration\\b"],["(?i)\\bobservability\\b","(?i)\\bdistributed tracing\\b"]]},"job_description_pattern_not":{"items":{"type":"string"},"type":"array","title":"Job Description Pattern Not","description":"Regex patterns to look for in job descriptions. Case-sensitive. Results will include jobs whose description don't match any of these patterns. Use (?i) at the start of a pattern to make it case-insensitive. Can pass more than one.","default":[],"examples":[[],["(?i)\\bdata warehouse\\b","(?i)\\bELT\\b","(?i)\\bETL\\b"],["(?i)\\bobservability\\b","(?i)\\bdistributed tracing\\b"]]},"job_description_pattern_and":{"items":{"type":"string"},"type":"array","title":"Job Description Pattern And","description":"Regex patterns that must ALL match the job description (AND logic). Use (?i) at the start of a pattern to make it case-insensitive. Results will only include jobs whose description matches every pattern in this list.","default":[],"examples":[[],["(?i)\\bML.?Ops\\b|\\bmachine learning operations\\b","(?i)\\bquery optim\\w+\\b|\\bquery performance\\b|\\bslow quer\\w+\\b"],["(?i)\\bdata migration\\b|\\bdatabase migration\\b","(?i)\\bno.?sql\\b|\\bdocument store\\b|\\bcolumn store\\b"],["(?i)\\bstream processing\\b|\\bevent streaming\\b|\\bmessage queue\\b","(?i)\\breal.?time\\b|\\blow.?latency\\b"]]},"job_description_pattern_is_case_insensitive":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Job Description Pattern Is Case Insensitive","description":"Deprecated. Has no effect.","default":true,"deprecated":true,"examples":[null,true,false]},"job_description_contains_or":{"items":{"type":"string"},"type":"array","title":"Job Description Contains Or","description":"Search for whole words in job descriptions using word boundaries (\\b). Case-insensitive by default, except for the patterns that are uppercase - in that case we'll respect it. Only finds complete words (e.g., searching 'quality' won't match 'inequality'). Results will include jobs whose description contains any of these words.","default":[],"examples":[[],["python","javascript"],["quality","testing"]]},"job_description_contains_not":{"items":{"type":"string"},"type":"array","title":"Job Description Contains Not","description":"Exclude jobs whose description contains any of these whole words using word boundaries (\\b). Case-insensitive by default, except for the patterns that are uppercase - in that case we'll respect it. Only finds complete words (e.g., searching 'quality' won't match 'inequality'). Results will exclude jobs whose description contains any of these words.","default":[],"examples":[[],["python","javascript"],["quality","testing"]]},"job_description_pattern_case_sensitive_or":{"items":{"type":"string"},"type":"array","title":"Job Description Pattern Case Sensitive Or","description":"Deprecated. Use job_description_pattern_or instead, which now behaves identically.","default":[],"deprecated":true,"examples":[[],["Python","JavaScript"],["API","REST"]]},"remote":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Remote","description":"True: only show remote jobs. False: only show non-remote jobs. None: show all jobs.","examples":[null,true,false]},"only_jobs_with_reports_to":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Only Jobs With Reports To","description":"Only return jobs where we identified the role the hired person would report to. Deprecated field, use reports_to_exists instead.","deprecated":true,"examples":[null,true,false]},"reports_to_exists":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Reports To Exists","description":"Only return jobs where we identified the role the hired person would report to. If True, only return jobs where we identified the role the hired person would report to. If False, only return jobs where we didn't identify the role the hired person would report to. If None, return all jobs.","deprecated":true,"examples":[null,true,false]},"final_url_exists":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Final Url Exists","description":"(Use `property_exists_or / property_exists_and` instead) Only return jobs with a final URL. Typically jobs that were originally posted on an ATS. If True, only return jobs with a final URL. If False, only return jobs without a final URL. If None, return all jobs.","deprecated":true,"examples":[null,true,false]},"only_jobs_with_hiring_managers":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Only Jobs With Hiring Managers","description":"Only return jobs with a hiring manager. If True, only return jobs with a hiring manager. If False, only return jobs without a hiring manager. If None, return all jobs.","deprecated":true,"examples":[null,true,false]},"hiring_managers_exists":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Hiring Managers Exists","description":"(Use `property_exists_or / property_exists_and` instead) If True, only return jobs with a hiring manager. If False, only return jobs without a hiring manager. If None, return all jobs.","deprecated":true,"examples":[null,true,false]},"job_id_or":{"items":{"type":"integer"},"type":"array","title":"Job Id Or","description":"Get jobs with these IDs only.","default":[],"examples":[[],[12423312,2123123,3123123]]},"job_id_not":{"items":{"type":"integer"},"type":"array","title":"Job Id Not","description":"Exclude jobs with these IDs.","default":[],"examples":[[],[12423312,2123123,3123123]]},"job_ids":{"items":{"type":"integer"},"type":"array","title":"Job Ids","description":"Get jobs with these IDs only. Deprecated parameter, use job_id_or instead.","default":[],"deprecated":true},"job_seniority_or":{"items":{"type":"string","enum":["c_level","staff","senior","junior","mid_level"]},"type":"array","title":"Job Seniority Or","description":"Will return jobs where the seniority is any of the ones passed here","default":[],"examples":[[],["intern","entry","mid","senior","principal"]]},"min_salary_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Min Salary Usd","description":"Minimum annual salary in USD. For example, 100000 means $100,000.","examples":[null,100000,150000]},"max_salary_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Salary Usd","description":"Maximum annual salary in USD. For example, 150000 means $150,000.","examples":[null,100000,150000]},"job_technology_slug_or":{"items":{"type":"string"},"type":"array","title":"Job Technology Slug Or","description":"Will return jobs where any of these technologies appear. Case sensitive. Pass slugs. Check out all the technologies we track with the technologies endpoint. If you pass more than one technology, we will return jobs that mentnion all of the technologies.","default":[]},"job_technology_slug_not":{"items":{"type":"string"},"type":"array","title":"Job Technology Slug Not","description":"Will return jobs where none of these technologies appear. Case sensitive. Pass slugs. Check out all the technologies we track with the technologies endpoint.","default":[]},"job_technology_slug_and":{"items":{"type":"string"},"type":"array","title":"Job Technology Slug And","description":"Will return jobs where all of these technologies appear. Case sensitive. Pass slugs. Check out all the technologies we track with the technologies endpoint.","default":[]},"job_keyword_slug_or":{"items":{"type":"string"},"type":"array","title":"Job Keyword Slug Or","description":"Will return jobs where any of these keyword slugs appear. Case sensitive. Check out all the keywords we track at [GET /v0/catalog/keywords](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_keywords_v0)","default":[]},"job_keyword_slug_and":{"items":{"type":"string"},"type":"array","title":"Job Keyword Slug And","description":"Will return jobs where all of these keyword slugs appear. Case sensitive. Check out all the keywords we track at [GET /v0/catalog/keywords](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_keywords_v0)","default":[]},"job_keyword_slug_not":{"items":{"type":"string"},"type":"array","title":"Job Keyword Slug Not","description":"Will return jobs where none of these keyword slugs appear. Case sensitive. Check out all the keywords we track at [GET /v0/catalog/keywords](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_keywords_v0)","default":[]},"job_location_pattern_or":{"items":{"type":"string"},"type":"array","title":"Job Location Pattern Or","description":"Regex patterns to match job locations. Case-insensitive. Searches both the location field and the enhanced locations array (using normalized city and state name fields within each location element). Jobs matching ANY of the provided patterns will be returned. Use this to find jobs in specific cities, states, or regions.","default":[],"examples":[[],["san francisco"],["california","new york"],["madrid"]]},"job_location_pattern_not":{"items":{"type":"string"},"type":"array","title":"Job Location Pattern Not","description":"Regex patterns to exclude job locations. Case-insensitive. Searches both the location field and the enhanced locations array (using normalized city and state name fields within each location element). Jobs matching ANY of the provided patterns will be EXCLUDED from results. Use this to filter out specific locations.","default":[],"examples":[[],["new york","california"],["madrid"]]},"job_location_or":{"items":{"$ref":"#/components/schemas/JobLocationFilter"},"type":"array","title":"Job Location Or","description":"Filter jobs by location. Returns jobs whose locations match ANY of the specified location criteria. Each location criteria is specified using a JobLocationFilter object. (You can find location IDs using the [locations catalog endpoint](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_locations_v0))","default":[],"examples":[[],[{"id":5128581},{"id":2921044}]]},"job_location_not":{"items":{"$ref":"#/components/schemas/JobLocationFilter"},"type":"array","title":"Job Location Not","description":"Filter jobs by location. Returns jobs whose locations DO NOT match ANY of the specified location criteria. Each location criteria is specified using a JobLocationFilter object. (You can find location IDs using the [locations catalog endpoint](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_locations_v0))","default":[],"examples":[[],[{"id":5128581},{"id":2921044}]]},"url_domain_or":{"items":{"type":"string"},"type":"array","title":"Url Domain Or","description":"Include jobs only if their URL domain (from `url` or `source_url`) is in the provided case-insensitive list. For example, ['greenhouse.io', 'workable.com'] will match URLs containing 'greenhouse.io' or 'workable.com'. Refer to our list of sources at https://theirstack.com/en/docs/data/job/sources.","default":[],"examples":[[],["greenhouse.io","workable.com","join.com","lever.co"],["linkedin.com"]]},"url_domain_not":{"items":{"type":"string"},"type":"array","title":"Url Domain Not","description":"Exclude jobs if their URL domain (from `url` or `source_url`) is in the provided case-insensitive list. For example, ['greenhouse.io', 'workable.com'] will exclude URLs containing 'greenhouse.io' or 'workable.com'. Refer to our list of sources at https://theirstack.com/en/docs/data/job/sources.","default":[],"examples":[[],["greenhouse.io","workable.com","join.com","lever.co"],["linkedin.com"]]},"scraper_name_pattern_or":{"items":{"type":"string"},"type":"array","title":"Scraper Name Pattern Or","description":"Regex patterns to match job sources. Case-insensitive.","default":[],"deprecated":true},"easy_apply":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Easy Apply","description":"If True, only return jobs that can be applied directly through the job board. If False, only return jobs that require redirecting to the company's website.","examples":[null,true,false]},"employment_statuses_or":{"anyOf":[{"items":{"$ref":"#/components/schemas/Commitment"},"type":"array"},{"type":"null"}],"title":"Employment Statuses Or","description":"Filter jobs by employment status. Returns jobs that match any of the specified employment types. If no values are provided or an empty list is sent, all jobs regardless of employment status will be returned.","examples":[[],["full_time"],["full_time","part_time"]]},"company_name_or":{"items":{"type":"string"},"type":"array","title":"Company Name Or","description":"Only return companies that match these names exactly, case-sensitively. This filter acts as an OR filter, so if you pass more than one company name, it will return companies that match any of the names.","default":[],"examples":[[],["Google","Facebook","Apple"]]},"company_name_case_insensitive_or":{"items":{"type":"string"},"type":"array","title":"Company Name Case Insensitive Or","description":"Only return companies that match these names exactly, case-insensitively.","default":[],"examples":[[],["google","stripe"]]},"company_id_or":{"items":{"type":"string"},"type":"array","title":"Company Id Or","description":"Only return companies that match these IDs exactly. This filter acts as an OR filter, so if you pass more than one company ID, it will return companies that match any of the IDs.","default":[],"examples":[[],["1234567890","1234567891"]]},"company_domain_or":{"items":{"type":"string"},"type":"array","title":"Company Domain Or","description":"Only return companies that match these domains exactly. It accepts full urls (https://www.google.com/) and emails (john.polo@gmail.com). This filter acts as an OR filter, so if you pass more than one company domain, it will return companies that match any of the domains.","default":[],"examples":[[],["google.com","stripe.com"],["https://www.google.com/","https://stripe.com/"],["andrew@stripe.com ","mark@meta.com"]]},"company_domain_not":{"items":{"type":"string"},"type":"array","title":"Company Domain Not","description":"Only return companies that don't match these domains exactly. It accepts full urls (https://www.google.com/) and emails (john.polo@gmail.com).","default":[],"examples":[[],["google.com","stripe.com"],["https://www.google.com/","https://stripe.com/"],["andrew@stripe.com ","mark@meta.com"]]},"company_name_not":{"items":{"type":"string"},"type":"array","title":"Company Name Not","description":"Only return companies that don't match these names exactly, case-sensitively.","default":[],"examples":[[],["Google","Facebook","Apple"]]},"company_name_partial_match_or":{"items":{"type":"string"},"type":"array","title":"Company Name Partial Match Or","description":"Company names. Will return companies whose name contain any of the the substrings passed here, case-insensitively. For example, if you pass \"google\", it will return \"Google\", \"Google LLC\", \"Google Inc\", etc.","default":[],"examples":[[],["google","stripe"]]},"company_name_partial_match_not":{"items":{"type":"string"},"type":"array","title":"Company Name Partial Match Not","description":"Company names. Will return companies whose name doesn't contain any of the the substrings passed here, case-insensitively. For example, if you pass 'google', it will exclude 'Google', 'Google LLC', 'Google Inc', etc.","default":[],"examples":[[],["google","stripe"]]},"company_linkedin_url_or":{"items":{"type":"string"},"type":"array","title":"Company Linkedin Url Or","description":"Return companies whose LinkedIn URL matches any of the slugs passed here. Can also pass full LinkedIn company URLs.","default":[],"examples":[[],["https://www.linkedin.com/company/google/"]]},"blur_company_data":{"type":"boolean","title":"Blur Company Data","description":"Enable preview mode to return blurred data without consuming API credits. When enabled, sensitive company fields (name, domain, URLs, descriptions) and job-specific fields (description, URLs) are blurred. This mode is useful for sales software integrations to show data previews to end users. Not available when filtering by company identifiers (company_name, company_domain, company_linkedin_url, company_id). Learn more about [here](https://theirstack.com/en/docs/api/preview-data-mode)","default":false},"property_exists_or":{"items":{"type":"string","enum":["company_object.domain","company_object.linkedin_url","final_url","hiring_team","employment_statuses"]},"type":"array","title":"Property Exists Or","description":"Return jobs that have any of these fields not null. For example, if you pass ['final_url'], it will return jobs that have a final_url set. This field also support chaining of fields. For example, if you pass ['company_object.domain', 'company_object.linkedin_url'], it will return jobs that have a company domain or a company linkedin_url set.","default":[],"examples":[[],["company_object.domain","company_object.linkedin_url","final_url"]]},"property_exists_and":{"items":{"type":"string","enum":["company_object.domain","company_object.linkedin_url","final_url","hiring_team","employment_statuses"]},"type":"array","title":"Property Exists And","default":[],"examples":[[],["company_object.domain","company_object.linkedin_url","final_url"]]},"company_description_pattern_or":{"items":{"type":"string"},"type":"array","title":"Company Description Pattern Or","description":"Case-insensitive patterns to match in the company description. Will return companies that match any of the patterns.","default":[]},"company_description_pattern_not":{"items":{"type":"string"},"type":"array","title":"Company Description Pattern Not","description":"Case-insensitive patterns to match in the company description. Will return companies that match any of the patterns.","default":[]},"company_description_pattern_accent_insensitive":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Company Description Pattern Accent Insensitive","description":"Set to True to make company description searches accent insensitive. For example, \"á\" will match \"a\" as well.","default":false,"examples":[null,true,false]},"min_revenue_usd":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Revenue Usd","description":"Minimum company revenue, in USD","examples":[null]},"max_revenue_usd":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Revenue Usd","description":"Maximum company revenue, in USD","examples":[null]},"min_employee_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Employee Count","description":"Minimum number of employees in a company","examples":[null,100]},"max_employee_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Employee Count","description":"Maximum number of employees in a company","examples":[null,100]},"min_employee_count_or_null":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Employee Count Or Null","description":"Minimum number of employees in a company. If we don't have company size information, we will return it as well.","examples":[null,100]},"max_employee_count_or_null":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Employee Count Or Null","description":"Maximum number of employees in a company. If we don't have company size information, we will return it as well.","examples":[null,100]},"min_funding_usd":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Funding Usd","description":"Minimum company funding, in USD","examples":[null,1000000000]},"max_funding_usd":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Funding Usd","description":"Maximum company funding, in USD","examples":[null,1000000000]},"funding_stage_or":{"items":{"type":"string"},"type":"array","title":"Funding Stage Or","description":"Funding stages of companies returned. Possible values: ['angel', 'convertible_note', 'debt_financing', 'equity_crowdfunding', 'other', 'private_equity', 'seed', 'series_a', 'series_b', 'series_c', 'series_d', 'series_e', 'series_f', 'series_g', 'series_h', 'venture_round_not_specified', 'series_i', 'series_j', 'undisclosed', 'series_unknown', 'pre_seed', 'post_ipo_secondary', 'post_ipo_equity', 'post_ipo_debt', 'non_equity_assistance', 'late_vc', 'initial_coin_offering', 'growth_equity_vc', 'grant', 'early_vc', 'corporate_round', 'secondary_market', 'product_crowdfunding']","default":[]},"industry_or":{"items":{"type":"string"},"type":"array","title":"Industry Or","description":"Names of industries, case-insensitive. Results will only include companies that belong to any of the industries specified in this parameter. Available values: [GET /v0/catalog/industries](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_industries_v0)\n\n    WARNING: Deprecated parameter. Use the industry_id_or field instead. ","default":[],"deprecated":true},"industry_not":{"items":{"type":"string"},"type":"array","title":"Industry Not","description":"Names of industries, case-insensitive. Results will exclude companies that belong to any of the industries specified in this parameter. Available values: [GET /v0/catalog/industries](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_industries_v0)\n\n    WARNING: Deprecated parameter. Use the industry_id_not field instead. ","default":[],"deprecated":true},"industry_id_or":{"items":{"type":"integer"},"type":"array","title":"Industry Id Or","description":"Industry codes. You can use any of [LinkedIn's Industry Codes V2](https://learn.microsoft.com/en-us/linkedin/shared/references/reference-tables/industry-codes-v2) or [GET /v0/catalog/industries](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_industries_v0)","default":[]},"industry_id_not":{"items":{"type":"integer"},"type":"array","title":"Industry Id Not","description":"Industry ids to exclude.You can use any of [LinkedIn's Industry Codes V2](https://learn.microsoft.com/en-us/linkedin/shared/references/reference-tables/industry-codes-v2) or [GET /v0/catalog/industries](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_industries_v0)","default":[]},"company_tags_or":{"items":{"type":"string"},"type":"array","title":"Company Tags Or","description":"Return companies that match any of these keywords","default":[]},"company_type":{"anyOf":[{"type":"string","enum":["recruiting_agency","direct_employer","all"]},{"type":"null"}],"title":"Company Type","description":"Filter by company type."},"company_investors_or":{"items":{"type":"string"},"type":"array","title":"Company Investors Or","description":"Investors of the company","default":[]},"company_investors_partial_match_or":{"items":{"type":"string"},"type":"array","title":"Company Investors Partial Match Or","description":"Investors of the company. Will return companies for which any of their investors contains any of the substrings passed here. For example, if you pass 'andree', all funds that match it (like 'Andreessen Horowitz', 'Andreessen Horowitz LLC', etc).","default":[]},"company_technology_slug_or":{"items":{"type":"string"},"type":"array","title":"Company Technology Slug Or","description":"Will return jobs from companies that that have mentioned any of these technologies in their jobs (not necessarily in the jobs returned). Case sensitive. Pass slugs. Check out all the technologies we track at [GET /v0/catalog/technologies](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_technologies_v0). Deprecated: use company_keyword_slug_or instead.","default":[],"deprecated":true},"company_technology_slug_and":{"items":{"type":"string"},"type":"array","title":"Company Technology Slug And","description":"Will return jobs from companies that that have mentioned all of these technologies in their jobs (not necessarily in the jobs returned). Case sensitive. Pass slugs. Check out all the technologies we track at [GET /v0/catalog/technologies](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_technologies_v0). Deprecated: use company_keyword_slug_and instead.","default":[],"deprecated":true},"company_technology_slug_not":{"items":{"type":"string"},"type":"array","title":"Company Technology Slug Not","description":"Will return jobs from companies that that haven't mentioned any of these technologies in their jobs. Case sensitive. Pass slugs. Check out all the technologies we track at [GET /v0/catalog/technologies](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_technologies_v0). Deprecated: use company_keyword_slug_not instead.","default":[],"deprecated":true},"company_keyword_slug_or":{"items":{"type":"string"},"type":"array","title":"Company Keyword Slug Or","description":"Return results from companies that have mentioned any of these keywords in their jobs. Case sensitive. Pass slugs. Check out all the keywords we track at [GET /v0/catalog/keywords](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_keywords_v0)","default":[]},"company_keyword_slug_and":{"items":{"type":"string"},"type":"array","title":"Company Keyword Slug And","description":"Return results from companies that have mentioned all of these keywords in their jobs. Case sensitive. Pass slugs. Check out all the keywords we track at [GET /v0/catalog/keywords](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_keywords_v0)","default":[]},"company_keyword_slug_not":{"items":{"type":"string"},"type":"array","title":"Company Keyword Slug Not","description":"Return results from companies that haven't mentioned any of these keywords in their jobs. Case sensitive. Pass slugs. Check out all the keywords we track at [GET /v0/catalog/keywords](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_keywords_v0)","default":[]},"only_yc_companies":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Only Yc Companies","description":"Only return YC companies","default":false},"company_location_pattern_or":{"items":{"type":"string"},"type":"array","title":"Company Location Pattern Or","description":"Return companies whose city matches any of the patterns passed here. Case insensitive. For example, if you pass 'san francisco', it will return companies whose city is 'San Francisco', 'San Francisco Bay Area', etc.","default":[]},"company_country_code_or":{"items":{"type":"string"},"type":"array","title":"Company Country Code Or","description":"Return companies whose HQ country code is any of the ones passed here, case sensitive. Pass ISO2 country codes.","default":[]},"company_country_code_not":{"items":{"type":"string"},"type":"array","title":"Company Country Code Not","description":"Return companies whose HQ country code is not any of the ones passed here, case sensitive. Pass ISO2 country codes.","default":[]},"company_list_id_or":{"items":{"type":"integer"},"type":"array","title":"Company List Id Or","description":"Return companies that belong to any of the company lists passed here","default":[]},"company_list_id_not":{"items":{"type":"integer"},"type":"array","title":"Company List Id Not","description":"Return companies that don't belong to any of the company lists passed here","default":[]},"company_linkedin_url_exists":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Company Linkedin Url Exists","description":"(Use `property_exists_or / property_exists_and` instead) Only return companies with a LinkedIn URL","deprecated":true,"examples":[null]},"revealed_company_data":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Revealed Company Data","description":"This field is deprecated and has no effect.","deprecated":true,"examples":[null]},"last_funding_round_date_lte":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Last Funding Round Date Lte","description":"Only return companies whose last funding round date is before or on this date. Format: 'YYYY-MM-DD'","examples":[null,"2025-05-25"]},"last_funding_round_date_gte":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Last Funding Round Date Gte","description":"Only return companies whose last funding round date is after or on this date. Format: 'YYYY-MM-DD'","examples":[null,"2025-05-25"]},"include_total_results":{"type":"boolean","title":"Include Total Results","description":"When enabled, calculates and returns `total_results` and `total_companies` fields in the response. WARNING: This significantly slows down responses as it requires reading the entire dataset. Recommended usage: enable only for the initial request to get totals, then disable for subsequent pagination requests.","default":false}},"additionalProperties":false,"type":"object","title":"JobSearchFilters"},"JobSearchResponse":{"properties":{"metadata":{"$ref":"#/components/schemas/Metadata"},"data":{"items":{"$ref":"#/components/schemas/JobWithMatchingPhrasesResponse-Output"},"type":"array","title":"Data"}},"type":"object","required":["metadata","data"],"title":"JobSearchResponse"},"JobWithMatchingPhrasesResponse-Input":{"properties":{"id":{"type":"integer","title":"Id","description":"ID of the job","examples":[1234]},"neg_posted_at_timestamp":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Neg Posted At Timestamp","description":"neg_posted_at_timestamp of the job"},"url_hashed":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Url Hashed","description":"url_hashed of the job"},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created At","description":"created_at of the job"},"job_title":{"type":"string","title":"Job Title","description":"Job title","examples":["Senior Data Engineer"]},"url":{"type":"string","title":"Url","description":"URL of the job post","examples":["https://example.com/job/1234"]},"date_posted":{"type":"string","format":"date","title":"Date Posted","description":"Date when the job was posted","examples":["2021-01-01"]},"has_blurred_data":{"type":"boolean","title":"Has Blurred Data","description":"Whether the returned object has company identifiable data blurred or not","default":false},"company":{"type":"string","title":"Company","description":"Company name. This field is deprecated, please don't use it","deprecated":true,"examples":["Google"]},"final_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Final Url","description":"Is the URL of the job in the career page of the company.","examples":["https://carecrafterhealth.com/careers/job-details/MFC286442-4","https://www.google.com/about/careers/applications/jobs/results/110690555461018310-software-engineer-iii-infrastructure-core","https://job-boards.greenhouse.io/sondermind/jobs/6620635003?gh_src=c1701b3d3us"]},"source_url":{"type":"string","title":"Source Url","description":"Is the url TheirStack used to get the job data.","examples":["https://www.linkedin.com/jobs/view/1234567890"]},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","description":"This is the city of the job.","deprecated":true,"examples":["New York","Madrid","London"]},"short_location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Short Location","description":"It's a combination of the city and the state of the job.","deprecated":true,"examples":["Tulsa, OK","Methuen, MA"]},"long_location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Long Location","description":"It's a combination of the city, the state and the postal code of the job.","deprecated":true,"examples":["Methuen, MA 01844","Tulsa, OK 74110"]},"state_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State Code","description":"The state code of the job.","deprecated":true,"examples":["OK","MA","NY"]},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Latitude","description":"The latitude of the job.","deprecated":true,"examples":[37.774929,42.360082]},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Longitude","description":"The longitude of the job.","deprecated":true,"examples":[-96.726486,-71.056883]},"postal_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Postal Code","description":"The postal code of the job.","deprecated":true,"examples":["01844","74110"]},"remote":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Remote","description":"If the job is remote.","examples":[true,false]},"hybrid":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Hybrid","description":"If the job is hybrid. A hybrid position is a job that combines remote and in-office work.","examples":[true,false]},"salary_string":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Salary String","description":"The salary of the job in the local currency. If a similar field is present in the job source, this property will contain the same content. If no similar field is present, the content will be have the following format: <min_annual_salary> <currency> - <max_annual_salary> <currency> per year. For the currencies where the symbol precedes the digits, the format will be <currency> <min_annual_salary> - <currency> <max_annual_salary> per year. In these latter two cases, both the min and max annual salary are expressed in either k (for thousands) or M (for millions).","examples":["$100,000 - $120,000","80k € - 120k € per year"]},"min_annual_salary":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Annual Salary","description":"The minimum annual salary of the job in the local currency.","examples":[100000,120000]},"min_annual_salary_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Min Annual Salary Usd","description":"The minimum annual salary of the job in USD.","examples":[100000,120000]},"max_annual_salary":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Annual Salary","description":"The maximum annual salary of the job in the local currency.","examples":[100000,120000]},"max_annual_salary_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Annual Salary Usd","description":"The maximum annual salary of the job in USD.","examples":[100000,120000]},"avg_annual_salary_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Annual Salary Usd","description":"This property calculates the average annual salary for a job in USD, based on the available minimum and maximum annual salary values (both already converted to USD):\n        If both min_annual_salary_usd and max_annual_salary_usd are missing or zero, it returns None.\n        If only the minimum is missing, it returns the maximum value.\n        If only the maximum is missing, it returns the minimum value.\n        If both are present, it returns the average of the two, rounded to two decimal places.\n        This ensures the property always provides the best possible estimate of the average salary, even if only one bound is available.\n        ","examples":[100000,120000]},"salary_currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Salary Currency","description":"The currency of the salary of the job.","examples":["USD","EUR","GBP"]},"countries":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Countries","description":"Countries of the job","deprecated":true,"examples":[["United States","Canada","Spain","France","Australia"]]},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country","description":"Country name of the job","deprecated":true,"examples":["United States","Canada","Spain","France","Australia"]},"country_codes":{"anyOf":[{"items":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":"array"},{"type":"null"}],"title":"Country Codes","description":"Two-letter country codes (ISO 3166-1 alpha-2) representing the job's locations.","deprecated":true,"examples":[["US","CA","ES","FR","AU"],["US"],["US","CA"]]},"country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country Code","description":"Two-letter country code (ISO 3166-1 alpha-2) representing the job's location. If the job has multiple locations, the first one is returned.","deprecated":true,"examples":["US","CA","ES","FR","AU"]},"cities":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Cities","description":"Cities of the job","deprecated":true,"examples":[["New York","San Francisco","London","Paris","Sydney"]]},"continents":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Continents","description":"Continents of the job","deprecated":true,"examples":[["North America","Europe","Asia","Australia","South America"]]},"seniority":{"anyOf":[{"$ref":"#/components/schemas/Seniority"},{"type":"null"}],"description":"Seniority level of the job"},"discovered_at":{"type":"string","format":"date-time","title":"Discovered At","description":"Date when the job was discovered by TheirStack","examples":["2024-01-01T00:00:00"]},"company_domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Domain","description":"Company website domain","examples":["acme.com"]},"hiring_team":{"anyOf":[{"items":{"$ref":"#/components/schemas/PersonBase"},"type":"array"},{"type":"null"}],"title":"Hiring Team","description":"Hiring team who posted the job","examples":[[{"first_name":"John Doe","full_name":"John Doe","image_url":"https://media.licdn.com/dms1234567890","linkedin_url":"https://www.linkedin.com/in/john-doe-1234567890","role":"CEO","thumbnail_url":"https://media.licdn.com/dms1234567890"}]]},"reposted":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Reposted","description":"Indicates whether the employer has republished this job posting.","examples":[true,false]},"date_reposted":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Date Reposted","description":"Date when the job was reposted","examples":["2024-01-01"]},"employment_statuses":{"items":{"$ref":"#/components/schemas/Commitment"},"type":"array","title":"Employment Statuses","description":"Employment statuses of the job","default":[],"examples":[["full_time"]]},"easy_apply":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Easy Apply","description":"Indicates whether the job application can be submitted directly through the job board (easy_apply=True) or requires redirecting to the company's website (easy_apply=False).","examples":[true,false]},"technology_slugs":{"items":{"type":"string"},"type":"array","title":"Technology Slugs","description":"Slugs of the technologies found in the job title, description, or URL. This is a subset of keyword_slugs filtered to only technology-type keywords.","default":[],"examples":[["google-firebase","postgresql","jira"]]},"keyword_slugs":{"items":{"type":"string"},"type":"array","title":"Keyword Slugs","description":"Slugs of all keywords (technologies and buying intent topics) found in the job title, description, or URL.","default":[],"examples":[["google-firebase","postgresql","lead-generation"]]},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Job description in markdown format","examples":["## About the Role\nWe are looking for a Senior Data Engineer with 5+ years of experience in data engineering to join our growing data team. You will be responsible for designing and implementing scalable data pipelines, data models, and data warehouses that support our business intelligence and analytics initiatives.\n\n## Key Responsibilities\n- Design, build, and maintain robust, scalable data pipelines using modern data engineering tools and frameworks\n- Develop and optimize data models and schemas for data warehouses and data lakes\n- Collaborate with data scientists, analysts, and product teams to understand data requirements and deliver solutions\n- Implement data quality monitoring and validation processes to ensure data accuracy and reliability\n- Optimize query performance and data processing workflows for large-scale datasets\n- Build and maintain ETL/ELT processes using tools like Apache Airflow, dbt, or similar\n- Work with cloud data platforms (AWS, GCP, or Azure) and their native data services\n- Establish data governance practices and ensure compliance with data privacy regulations\n- Mentor junior data engineers and contribute to technical documentation\n\n## Required Qualifications\n- Bachelor's degree in Computer Science, Engineering, or related technical field\n- 5+ years of experience in data engineering or related roles\n- Strong proficiency in Python and SQL\n- Experience with big data technologies (Spark, Kafka, Hadoop ecosystem)\n- Hands-on experience with cloud data platforms (AWS Redshift, GCP BigQuery, Azure Synapse, etc.)\n- Experience with data orchestration tools (Airflow, Prefect, or similar)\n- Knowledge of data modeling concepts and best practices\n- Experience with version control systems (Git) and CI/CD pipelines\n- Strong problem-solving skills and attention to detail\n\n## Preferred Qualifications\n- Experience with real-time data processing and streaming analytics\n- Knowledge of data visualization tools (Tableau, Looker, PowerBI)\n- Experience with containerization (Docker, Kubernetes)\n- Familiarity with machine learning workflows and MLOps practices\n- Experience with data governance and cataloging tools\n\n## What We Offer\n- Competitive salary and equity package\n- Comprehensive health, dental, and vision insurance\n- Flexible work arrangements and remote-friendly culture\n- Professional development budget for conferences and training\n- State-of-the-art equipment and technology stack\n- Collaborative and inclusive work environment\n- Opportunity to work with cutting-edge data technologies"]},"company_object":{"$ref":"#/components/schemas/CompanyWithTechnologySlugs","description":"Company object"},"locations":{"items":{"$ref":"#/components/schemas/JobLocation-Input"},"type":"array","title":"Locations","description":"All possible locations of the job with coordinates, city, state, state_code, country_code, etc.","default":[],"examples":[[{"admin1_code":"CA","admin1_name":"California","admin2_code":"101","admin2_name":"Sutter","continent":"NA","country_code":"US","country_name":"United States","display_name":"Live Oak, California, United States","feature_code":"PPL","id":5367315,"latitude":37.0,"longitude":-122.0,"name":"Live Oak","state":"California","state_code":"CA","type":"city"}]]},"normalized_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Normalized Title"},"manager_roles":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Manager Roles","description":"Roles of the person or people found in the job description to be the managers of the hired person. Can be useful to infer who's the decision maker for the technologies mentioned in the job post."},"matching_phrases":{"anyOf":[{"items":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":"array"},{"type":"null"}],"title":"Matching Phrases","description":"Phrases from the job description that match the pattern passed","default":[]},"matching_words":{"anyOf":[{"items":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":"array"},{"type":"null"}],"title":"Matching Words","description":"Words from the job description that match the pattern passed","default":[]}},"type":"object","required":["id","job_title","url","date_posted","company","source_url","discovered_at","company_object"],"title":"JobWithMatchingPhrasesResponse"},"JobWithMatchingPhrasesResponse-Output":{"properties":{"id":{"type":"integer","title":"Id","description":"ID of the job","examples":[1234]},"job_title":{"type":"string","title":"Job Title","description":"Job title","examples":["Senior Data Engineer"]},"url":{"type":"string","title":"Url","description":"URL of the job post","examples":["https://example.com/job/1234"]},"date_posted":{"type":"string","format":"date","title":"Date Posted","description":"Date when the job was posted","examples":["2021-01-01"]},"has_blurred_data":{"type":"boolean","title":"Has Blurred Data","description":"Whether the returned object has company identifiable data blurred or not","default":false},"company":{"type":"string","title":"Company","description":"Company name. This field is deprecated, please don't use it","deprecated":true,"examples":["Google"]},"final_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Final Url","description":"Is the URL of the job in the career page of the company.","examples":["https://carecrafterhealth.com/careers/job-details/MFC286442-4","https://www.google.com/about/careers/applications/jobs/results/110690555461018310-software-engineer-iii-infrastructure-core","https://job-boards.greenhouse.io/sondermind/jobs/6620635003?gh_src=c1701b3d3us"]},"source_url":{"type":"string","title":"Source Url","description":"Is the url TheirStack used to get the job data.","examples":["https://www.linkedin.com/jobs/view/1234567890"]},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","description":"This is the city of the job.","deprecated":true,"examples":["New York","Madrid","London"]},"short_location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Short Location","description":"It's a combination of the city and the state of the job.","deprecated":true,"examples":["Tulsa, OK","Methuen, MA"]},"long_location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Long Location","description":"It's a combination of the city, the state and the postal code of the job.","deprecated":true,"examples":["Methuen, MA 01844","Tulsa, OK 74110"]},"state_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State Code","description":"The state code of the job.","deprecated":true,"examples":["OK","MA","NY"]},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Latitude","description":"The latitude of the job.","deprecated":true,"examples":[37.774929,42.360082]},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Longitude","description":"The longitude of the job.","deprecated":true,"examples":[-96.726486,-71.056883]},"postal_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Postal Code","description":"The postal code of the job.","deprecated":true,"examples":["01844","74110"]},"remote":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Remote","description":"If the job is remote.","examples":[true,false]},"hybrid":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Hybrid","description":"If the job is hybrid. A hybrid position is a job that combines remote and in-office work.","examples":[true,false]},"salary_string":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Salary String","description":"The salary of the job in the local currency. If a similar field is present in the job source, this property will contain the same content. If no similar field is present, the content will be have the following format: <min_annual_salary> <currency> - <max_annual_salary> <currency> per year. For the currencies where the symbol precedes the digits, the format will be <currency> <min_annual_salary> - <currency> <max_annual_salary> per year. In these latter two cases, both the min and max annual salary are expressed in either k (for thousands) or M (for millions).","examples":["$100,000 - $120,000","80k € - 120k € per year"]},"min_annual_salary":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Annual Salary","description":"The minimum annual salary of the job in the local currency.","examples":[100000,120000]},"min_annual_salary_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Min Annual Salary Usd","description":"The minimum annual salary of the job in USD.","examples":[100000,120000]},"max_annual_salary":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Annual Salary","description":"The maximum annual salary of the job in the local currency.","examples":[100000,120000]},"max_annual_salary_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Annual Salary Usd","description":"The maximum annual salary of the job in USD.","examples":[100000,120000]},"avg_annual_salary_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Annual Salary Usd","description":"This property calculates the average annual salary for a job in USD, based on the available minimum and maximum annual salary values (both already converted to USD):\n        If both min_annual_salary_usd and max_annual_salary_usd are missing or zero, it returns None.\n        If only the minimum is missing, it returns the maximum value.\n        If only the maximum is missing, it returns the minimum value.\n        If both are present, it returns the average of the two, rounded to two decimal places.\n        This ensures the property always provides the best possible estimate of the average salary, even if only one bound is available.\n        ","examples":[100000,120000]},"salary_currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Salary Currency","description":"The currency of the salary of the job.","examples":["USD","EUR","GBP"]},"countries":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Countries","description":"Countries of the job","deprecated":true,"examples":[["United States","Canada","Spain","France","Australia"]]},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country","description":"Country name of the job","deprecated":true,"examples":["United States","Canada","Spain","France","Australia"]},"country_codes":{"anyOf":[{"items":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":"array"},{"type":"null"}],"title":"Country Codes","description":"Two-letter country codes (ISO 3166-1 alpha-2) representing the job's locations.","deprecated":true,"examples":[["US","CA","ES","FR","AU"],["US"],["US","CA"]]},"country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country Code","description":"Two-letter country code (ISO 3166-1 alpha-2) representing the job's location. If the job has multiple locations, the first one is returned.","deprecated":true,"examples":["US","CA","ES","FR","AU"]},"cities":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Cities","description":"Cities of the job","deprecated":true,"examples":[["New York","San Francisco","London","Paris","Sydney"]]},"continents":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Continents","description":"Continents of the job","deprecated":true,"examples":[["North America","Europe","Asia","Australia","South America"]]},"seniority":{"anyOf":[{"$ref":"#/components/schemas/Seniority"},{"type":"null"}],"description":"Seniority level of the job"},"discovered_at":{"type":"string","format":"date-time","title":"Discovered At","description":"Date when the job was discovered by TheirStack","examples":["2024-01-01T00:00:00"]},"company_domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Domain","description":"Company website domain","examples":["acme.com"]},"hiring_team":{"anyOf":[{"items":{"$ref":"#/components/schemas/PersonBase"},"type":"array"},{"type":"null"}],"title":"Hiring Team","description":"Hiring team who posted the job","examples":[[{"first_name":"John Doe","full_name":"John Doe","image_url":"https://media.licdn.com/dms1234567890","linkedin_url":"https://www.linkedin.com/in/john-doe-1234567890","role":"CEO","thumbnail_url":"https://media.licdn.com/dms1234567890"}]]},"reposted":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Reposted","description":"Indicates whether the employer has republished this job posting.","examples":[true,false]},"date_reposted":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Date Reposted","description":"Date when the job was reposted","examples":["2024-01-01"]},"employment_statuses":{"items":{"$ref":"#/components/schemas/Commitment"},"type":"array","title":"Employment Statuses","description":"Employment statuses of the job","default":[],"examples":[["full_time"]]},"easy_apply":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Easy Apply","description":"Indicates whether the job application can be submitted directly through the job board (easy_apply=True) or requires redirecting to the company's website (easy_apply=False).","examples":[true,false]},"technology_slugs":{"items":{"type":"string"},"type":"array","title":"Technology Slugs","description":"Slugs of the technologies found in the job title, description, or URL. This is a subset of keyword_slugs filtered to only technology-type keywords.","default":[],"examples":[["google-firebase","postgresql","jira"]]},"keyword_slugs":{"items":{"type":"string"},"type":"array","title":"Keyword Slugs","description":"Slugs of all keywords (technologies and buying intent topics) found in the job title, description, or URL.","default":[],"examples":[["google-firebase","postgresql","lead-generation"]]},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Job description in markdown format","examples":["## About the Role\nWe are looking for a Senior Data Engineer with 5+ years of experience in data engineering to join our growing data team. You will be responsible for designing and implementing scalable data pipelines, data models, and data warehouses that support our business intelligence and analytics initiatives.\n\n## Key Responsibilities\n- Design, build, and maintain robust, scalable data pipelines using modern data engineering tools and frameworks\n- Develop and optimize data models and schemas for data warehouses and data lakes\n- Collaborate with data scientists, analysts, and product teams to understand data requirements and deliver solutions\n- Implement data quality monitoring and validation processes to ensure data accuracy and reliability\n- Optimize query performance and data processing workflows for large-scale datasets\n- Build and maintain ETL/ELT processes using tools like Apache Airflow, dbt, or similar\n- Work with cloud data platforms (AWS, GCP, or Azure) and their native data services\n- Establish data governance practices and ensure compliance with data privacy regulations\n- Mentor junior data engineers and contribute to technical documentation\n\n## Required Qualifications\n- Bachelor's degree in Computer Science, Engineering, or related technical field\n- 5+ years of experience in data engineering or related roles\n- Strong proficiency in Python and SQL\n- Experience with big data technologies (Spark, Kafka, Hadoop ecosystem)\n- Hands-on experience with cloud data platforms (AWS Redshift, GCP BigQuery, Azure Synapse, etc.)\n- Experience with data orchestration tools (Airflow, Prefect, or similar)\n- Knowledge of data modeling concepts and best practices\n- Experience with version control systems (Git) and CI/CD pipelines\n- Strong problem-solving skills and attention to detail\n\n## Preferred Qualifications\n- Experience with real-time data processing and streaming analytics\n- Knowledge of data visualization tools (Tableau, Looker, PowerBI)\n- Experience with containerization (Docker, Kubernetes)\n- Familiarity with machine learning workflows and MLOps practices\n- Experience with data governance and cataloging tools\n\n## What We Offer\n- Competitive salary and equity package\n- Comprehensive health, dental, and vision insurance\n- Flexible work arrangements and remote-friendly culture\n- Professional development budget for conferences and training\n- State-of-the-art equipment and technology stack\n- Collaborative and inclusive work environment\n- Opportunity to work with cutting-edge data technologies"]},"company_object":{"$ref":"#/components/schemas/CompanyWithTechnologySlugs","description":"Company object"},"locations":{"items":{"$ref":"#/components/schemas/JobLocation-Output"},"type":"array","title":"Locations","description":"All possible locations of the job with coordinates, city, state, state_code, country_code, etc.","default":[],"examples":[[{"admin1_code":"CA","admin1_name":"California","admin2_code":"101","admin2_name":"Sutter","continent":"NA","country_code":"US","country_name":"United States","display_name":"Live Oak, California, United States","feature_code":"PPL","id":5367315,"latitude":37.0,"longitude":-122.0,"name":"Live Oak","state":"California","state_code":"CA","type":"city"}]]},"normalized_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Normalized Title"},"manager_roles":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Manager Roles","description":"Roles of the person or people found in the job description to be the managers of the hired person. Can be useful to infer who's the decision maker for the technologies mentioned in the job post."},"matching_phrases":{"anyOf":[{"items":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":"array"},{"type":"null"}],"title":"Matching Phrases","description":"Phrases from the job description that match the pattern passed","default":[]},"matching_words":{"anyOf":[{"items":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":"array"},{"type":"null"}],"title":"Matching Words","description":"Words from the job description that match the pattern passed","default":[]}},"type":"object","required":["id","job_title","url","date_posted","company","source_url","discovered_at","company_object"],"title":"JobWithMatchingPhrasesResponse"},"JobsCompaniesPerJobCountryCode":{"properties":{"iso2":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Iso2","description":"ISO2 country code"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country","description":"Country name"},"num_jobs":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Num Jobs","description":"Number of jobs with the location in the country"},"num_companies":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Num Companies","description":"Number of companies from jobs with the location in the country"}},"type":"object","title":"JobsCompaniesPerJobCountryCode"},"JobsCompaniesPerJobCountryCodeResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/JobsCompaniesPerJobCountryCode"},"type":"array","title":"Data"},"metadata":{"$ref":"#/components/schemas/BaseMetadata"}},"type":"object","required":["data","metadata"],"title":"JobsCompaniesPerJobCountryCodeResponse"},"KeywordAggregated":{"properties":{"name":{"type":"string","title":"Name","examples":["PostgreSQL"]},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category","description":"Category of the keyword","examples":["Relational Database"]},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","description":"Type of the keyword (e.g. technology, operational_activity)"},"slug":{"type":"string","title":"Slug","description":"Slug of the keyword","examples":["kafka","snowflake"]},"category_slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category Slug","description":"Slug of the category of the keyword","examples":["message-queue"]},"parent_category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parent Category","description":"Parent category of the keyword","examples":["Data Stores"]},"parent_category_slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parent Category Slug","description":"Slug of the parent category of the keyword","examples":["data-stores"]},"logo":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Logo","description":"Logo of the keyword"},"logo_thumbnail":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Logo Thumbnail","description":"Thumbnail of the keyword"},"one_liner":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"One Liner","description":"One-line description of the keyword","examples":["Apache Kafka"]},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"URL of the keyword"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Description of the keyword"},"jobs":{"type":"integer","title":"Jobs","description":"Number of jobs found mentioning this keyword"},"companies":{"type":"integer","title":"Companies","description":"Number of companies using this keyword"},"companies_found_last_week":{"type":"integer","title":"Companies Found Last Week","description":"Number of companies found using this keyword in the last week for the first time"}},"type":"object","required":["name","slug","jobs","companies","companies_found_last_week"],"title":"KeywordAggregated"},"KeywordCategoryItem":{"properties":{"name":{"type":"string","title":"Name","description":"Name of the category"},"slug":{"type":"string","title":"Slug","description":"Slug of the category"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Description of the category or subcategory"},"number_of_technologies":{"type":"integer","title":"Number Of Technologies","description":"Number of technologies in the category"},"number_of_companies":{"type":"integer","title":"Number Of Companies","description":"Number of companies using technologies in the category"},"technologies":{"items":{"$ref":"#/components/schemas/KeywordFromCategorySmallDetails"},"type":"array","title":"Technologies","description":"List of technologies in this category"},"category_slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category Slug","description":"Slug of the parent category"}},"type":"object","required":["name","slug","number_of_technologies","number_of_companies","technologies"],"title":"KeywordCategoryItem"},"KeywordCategoryResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/KeywordCategoryItem"},"type":"array","title":"Data"},"metadata":{"$ref":"#/components/schemas/BaseMetadata"}},"type":"object","required":["data","metadata"],"title":"KeywordCategoryResponse"},"KeywordExtended":{"properties":{"name":{"type":"string","title":"Name","examples":["PostgreSQL"]},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category","description":"Category of the keyword","examples":["Relational Database"]},"type":{"anyOf":[{"$ref":"#/components/schemas/KeywordType"},{"type":"null"}],"description":"Type of the keyword (e.g. technology, operational_activity)"},"slug":{"type":"string","title":"Slug","description":"Slug of the keyword","examples":["kafka","snowflake"]},"category_slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category Slug","description":"Slug of the category of the keyword","examples":["message-queue"]},"parent_category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parent Category","description":"Parent category of the keyword","examples":["Data Stores"]},"parent_category_slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parent Category Slug","description":"Slug of the parent category of the keyword","examples":["data-stores"]},"logo":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Logo","description":"Logo of the keyword"},"logo_thumbnail":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Logo Thumbnail","description":"Thumbnail of the keyword"}},"type":"object","required":["name","slug"],"title":"KeywordExtended"},"KeywordFilters":{"properties":{"keyword_slug_or":{"items":{"type":"string"},"type":"array","title":"Keyword Slug Or","description":"Return companies that have mentioned any of these keywords (technologies or buying intent topics) in their jobs. Case sensitive. Pass slugs. Check out all keywords at [GET /v0/catalog/keywords](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_keywords_v0)","default":[]},"keyword_category_slug_or":{"items":{"type":"string"},"type":"array","title":"Keyword Category Slug Or","description":"Return companies that have mentioned any keyword from any of these categories in their jobs. Case sensitive. Pass slugs. Check out all keyword categories at [GET /v0/catalog/keywords/categories](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_keywords_categories_v0)","default":[]},"keyword_parent_category_slug_or":{"items":{"type":"string"},"type":"array","title":"Keyword Parent Category Slug Or","description":"Return companies that have mentioned any keyword from any of these parent categories in their jobs. Case sensitive. Pass slugs. Check out all keyword categories at [GET /v0/catalog/keywords/categories](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_keywords_categories_v0)","default":[]},"technology_slug_or":{"items":{"type":"string"},"type":"array","title":"Technology Slug Or","description":"Deprecated: use `keyword_slug_or` instead. Will return companies that have mentioned any of these technologies in their jobs. Case sensitive. Pass slugs.","default":[],"deprecated":true},"technology_category_slug_or":{"items":{"type":"string"},"type":"array","title":"Technology Category Slug Or","description":"Deprecated: use `keyword_category_slug_or` instead. Will return companies that have mentioned any keyword from any of these categories in their jobs. Case sensitive. Pass slugs.","default":[],"deprecated":true},"technology_parent_category_slug_or":{"items":{"type":"string"},"type":"array","title":"Technology Parent Category Slug Or","description":"Deprecated: use `keyword_parent_category_slug_or` instead. Will return companies that have mentioned any keyword from any of these parent categories in their jobs. Case sensitive. Pass slugs.","default":[],"deprecated":true},"max_rank":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Rank","description":"The rank measures how common is a technology within its category. The technology most used among similar ones by a company will have a rank of 1, the second: 2, etc. This is useful to filter results by technology and get only results for the primary technology. ","examples":[null]},"min_jobs":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Jobs","description":"Minimum number of jobs found by each company using a technology","examples":[null]},"max_jobs":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Jobs","description":"Maximum number of jobs found by each company using a technology","examples":[null]},"min_relative_occurrence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Min Relative Occurrence","description":"Minimum value of relative_occurrence_within_category for each technology. Higher values increase the probability that this technology is actually used by the company, because it means a higher percentage of mentions to technologies among this category are of this technology.","examples":[null]},"first_date_found_gte":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"First Date Found Gte","description":"Only return technologies where the first time they were found was after or on this date. Format: \"YYYY-MM-DD\"","examples":[null]},"first_date_found_lte":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"First Date Found Lte","description":"Only return technologies where the first time they were found was before or on this date. Format: \"YYYY-MM-DD\"","examples":[null]},"last_date_found_gte":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Last Date Found Gte","description":"Only return technologies where the last time they were found was after or on this date. Format: \"YYYY-MM-DD\"","examples":[null]},"last_date_found_lte":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Last Date Found Lte","description":"Only return technologies where the last time they were found was before or on this date. Format: \"YYYY-MM-DD\"","examples":[null]},"confidence_or":{"items":{"type":"string","enum":["low","medium","high"]},"type":"array","title":"Confidence Or","description":"Returns technologies with any of these confidence values that the companies use them. Available values: \"high\", \"medium\", \"low\"","default":[]}},"type":"object","title":"KeywordFilters","description":"Filter by technologies and buying intent topics detected for a company."},"KeywordFoundV0-Input":{"properties":{"technology":{"$ref":"#/components/schemas/KeywordExtended","description":"Technology object"},"confidence":{"type":"string","enum":["low","medium","high"],"title":"Confidence","description":"How confident we are that the company uses this technology"},"jobs":{"type":"integer","title":"Jobs","description":"Number of jobs found mentioning this technology","examples":[54]},"jobs_last_7_days":{"type":"integer","title":"Jobs Last 7 Days","description":"Number of jobs from the given company mentioning this technology in the last 7 days"},"jobs_last_30_days":{"type":"integer","title":"Jobs Last 30 Days","description":"Number of jobs from the given company mentioning this technology in the last 30 days"},"jobs_last_180_days":{"type":"integer","title":"Jobs Last 180 Days","description":"Number of jobs from the given company mentioning this technology in the last 180 days"},"first_date_found":{"type":"string","format":"date","title":"First Date Found","description":"Date when the keyword was first mentioned by the company in a job post"},"last_date_found":{"type":"string","format":"date","title":"Last Date Found","description":"Date when the keyword was last mentioned by the company in a job post"},"rank_within_category":{"type":"integer","title":"Rank Within Category","description":"Measures how common this technology is among the company's jobs, compared to other technologies in the same category. The most mentioned technology in its category will have a rank of 1. This helps you infer which is the technology the company is most likely to be using, when they mention several technologies that belong to the same category."},"relative_occurrence_within_category":{"type":"number","title":"Relative Occurrence Within Category","description":"Measures the relative occurance of this technology among other technologies in the same category, in jobs by this company. If there are 10 jobs where a company mentions 3 categories, and they appear in 8, 3 and 2 jobs respectively, its relative occurrences will be 0.8, 0.3 and 0.2. This helps you infer how likely it is that the company is using this technology, when they mention several technologies that belong to the same category."},"theirstack_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Theirstack Score","description":"[DEPRECATED] This is a score we assign to every technology used by each company to assess how likely it is that they're using it, combining the value of `jobs` and `relative_occurrence_within_category`. The higher this value is, the higher the chances that the company uses this technology. Values lower than 1 mean it's not very likely they use it. Then, the higher the value of theirstack_score, the more likely it is that they actually use it.","deprecated":true},"company_name":{"type":"string","title":"Company Name","description":"Company name. This field is deprecated, please don't use it","deprecated":true,"examples":["Google"]}},"type":"object","required":["technology","confidence","jobs","jobs_last_7_days","jobs_last_30_days","jobs_last_180_days","first_date_found","last_date_found","rank_within_category","relative_occurrence_within_category","company_name"],"title":"KeywordFoundV0","description":"Response schema for /companies/technologies (includes deprecated fields)."},"KeywordFoundV0-Output":{"properties":{"technology":{"$ref":"#/components/schemas/KeywordExtended","description":"Technology object"},"confidence":{"type":"string","enum":["low","medium","high"],"title":"Confidence","description":"How confident we are that the company uses this technology"},"jobs":{"type":"integer","title":"Jobs","description":"Number of jobs found mentioning this technology","examples":[54]},"jobs_last_7_days":{"type":"integer","title":"Jobs Last 7 Days","description":"Number of jobs from the given company mentioning this technology in the last 7 days"},"jobs_last_30_days":{"type":"integer","title":"Jobs Last 30 Days","description":"Number of jobs from the given company mentioning this technology in the last 30 days"},"jobs_last_180_days":{"type":"integer","title":"Jobs Last 180 Days","description":"Number of jobs from the given company mentioning this technology in the last 180 days"},"first_date_found":{"type":"string","format":"date","title":"First Date Found","description":"Date when the keyword was first mentioned by the company in a job post"},"last_date_found":{"type":"string","format":"date","title":"Last Date Found","description":"Date when the keyword was last mentioned by the company in a job post"},"rank_within_category":{"type":"integer","title":"Rank Within Category","description":"Measures how common this technology is among the company's jobs, compared to other technologies in the same category. The most mentioned technology in its category will have a rank of 1. This helps you infer which is the technology the company is most likely to be using, when they mention several technologies that belong to the same category."},"relative_occurrence_within_category":{"type":"number","title":"Relative Occurrence Within Category","description":"Measures the relative occurance of this technology among other technologies in the same category, in jobs by this company. If there are 10 jobs where a company mentions 3 categories, and they appear in 8, 3 and 2 jobs respectively, its relative occurrences will be 0.8, 0.3 and 0.2. This helps you infer how likely it is that the company is using this technology, when they mention several technologies that belong to the same category."},"theirstack_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Theirstack Score","description":"[DEPRECATED] This is a score we assign to every technology used by each company to assess how likely it is that they're using it, combining the value of `jobs` and `relative_occurrence_within_category`. The higher this value is, the higher the chances that the company uses this technology. Values lower than 1 mean it's not very likely they use it. Then, the higher the value of theirstack_score, the more likely it is that they actually use it.","deprecated":true},"company_name":{"type":"string","title":"Company Name","description":"Company name. This field is deprecated, please don't use it","deprecated":true,"examples":["Google"]}},"type":"object","required":["technology","confidence","jobs","jobs_last_7_days","jobs_last_30_days","jobs_last_180_days","first_date_found","last_date_found","rank_within_category","relative_occurrence_within_category","company_name"],"title":"KeywordFoundV0","description":"Response schema for /companies/technologies (includes deprecated fields)."},"KeywordFoundV1":{"properties":{"technology":{"$ref":"#/components/schemas/KeywordExtended","description":"Technology object"},"confidence":{"type":"string","enum":["low","medium","high"],"title":"Confidence","description":"How confident we are that the company uses this technology"},"jobs":{"type":"integer","title":"Jobs","description":"Number of jobs found mentioning this technology","examples":[54]},"jobs_last_7_days":{"type":"integer","title":"Jobs Last 7 Days","description":"Number of jobs from the given company mentioning this technology in the last 7 days"},"jobs_last_30_days":{"type":"integer","title":"Jobs Last 30 Days","description":"Number of jobs from the given company mentioning this technology in the last 30 days"},"jobs_last_180_days":{"type":"integer","title":"Jobs Last 180 Days","description":"Number of jobs from the given company mentioning this technology in the last 180 days"},"first_date_found":{"type":"string","format":"date","title":"First Date Found","description":"Date when the keyword was first mentioned by the company in a job post"},"last_date_found":{"type":"string","format":"date","title":"Last Date Found","description":"Date when the keyword was last mentioned by the company in a job post"},"rank_within_category":{"type":"integer","title":"Rank Within Category","description":"Measures how common this technology is among the company's jobs, compared to other technologies in the same category. The most mentioned technology in its category will have a rank of 1. This helps you infer which is the technology the company is most likely to be using, when they mention several technologies that belong to the same category."},"relative_occurrence_within_category":{"type":"number","title":"Relative Occurrence Within Category","description":"Measures the relative occurance of this technology among other technologies in the same category, in jobs by this company. If there are 10 jobs where a company mentions 3 categories, and they appear in 8, 3 and 2 jobs respectively, its relative occurrences will be 0.8, 0.3 and 0.2. This helps you infer how likely it is that the company is using this technology, when they mention several technologies that belong to the same category."}},"type":"object","required":["technology","confidence","jobs","jobs_last_7_days","jobs_last_30_days","jobs_last_180_days","first_date_found","last_date_found","rank_within_category","relative_occurrence_within_category"],"title":"KeywordFoundV1","description":"Response schema for /companies/keywords (no deprecated fields)."},"KeywordFromCategorySmallDetails":{"properties":{"name":{"type":"string","title":"Name","description":"Names of the top 5 technologies"},"logo":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Logo","description":"Logos of the top 5 technologies"},"slug":{"type":"string","title":"Slug","description":"Slugs of the top 5 technologies"}},"type":"object","required":["name","slug"],"title":"KeywordFromCategorySmallDetails"},"KeywordParentCategoryItem":{"properties":{"name":{"type":"string","title":"Name","description":"Name of the parent category"},"slug":{"type":"string","title":"Slug","description":"Slug of the parent category"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Description of the category"},"number_of_technologies":{"type":"integer","title":"Number Of Technologies","description":"Number of technologies in the category"},"number_of_companies":{"type":"integer","title":"Number Of Companies","description":"Number of companies using technologies in the category"}},"type":"object","required":["name","slug","number_of_technologies","number_of_companies"],"title":"KeywordParentCategoryItem"},"KeywordParentCategoryResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/KeywordParentCategoryItem"},"type":"array","title":"Data"},"metadata":{"$ref":"#/components/schemas/BaseMetadata"}},"type":"object","required":["data","metadata"],"title":"KeywordParentCategoryResponse"},"KeywordType":{"type":"string","enum":["technology","software_product","technology_concept","operational_activity","strategic_initiative","metric_or_concept","product_or_service_offered","regulation","threat_or_risk","event","commodity","industry_vertical","physical_equipment","medical_research","government_body"],"title":"KeywordType"},"Metadata":{"properties":{"total_results":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Results","description":"Total number of results","examples":[2034]},"truncated_results":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Truncated Results","description":"Number of results that were not returned because the user doesn't have enough credits to fetch them all the possible results the API could have returned","default":0},"truncated_companies":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Truncated Companies","description":"Number of companies that were not returned because the user doesn't have enough credits to fetch all the possible results the API could have returned","default":0},"total_companies":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Companies","description":"Total number of companies","examples":[1045]}},"type":"object","title":"Metadata"},"PersonBase":{"properties":{"first_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"First Name","description":"First name of the person"},"full_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Full Name","description":"Full name of the person"},"linkedin_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Linkedin Url","description":"LinkedIn URL of the person"},"role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Role","description":"Role of the person"},"image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Url","description":"Image URL of the person"},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Thumbnail Url","description":"Thumbnail URL of the person"}},"type":"object","title":"PersonBase"},"RequestCount":{"properties":{"period_start":{"type":"string","format":"date-time","title":"Period Start","description":"Start of the period."},"number_of_requests":{"type":"integer","title":"Number Of Requests","description":"Number of requests."}},"type":"object","required":["period_start","number_of_requests"],"title":"RequestCount"},"SavedSearch":{"properties":{"id":{"type":"integer","title":"Id","description":"ID of the saved search"},"name":{"type":"string","title":"Name","description":"Name of the saved search"},"type":{"$ref":"#/components/schemas/SavedSearchType","description":"Type of the saved search."},"body":{"anyOf":[{"$ref":"#/components/schemas/CompanySearchFilters-Output"},{"$ref":"#/components/schemas/JobSearchFilters-Output"}],"title":"Body","description":"Filters. CompanySearchFilters if type is 'companies', JobSearchFilters if type is 'jobs'"},"is_alert_active":{"type":"boolean","title":"Is Alert Active","description":"Is the alert active","default":false},"user_id":{"type":"integer","title":"User Id","description":"Owner of the saved search"},"team_id":{"type":"integer","title":"Team Id","description":"Team of the saved search"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Date and time when the saved search was created"},"updated_at":{"type":"string","format":"date-time","title":"Updated At","description":"Date and time when the saved search was last updated"},"query":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Query","description":"Query of the request"},"path":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Path","description":"Path of the request"},"querystring_params":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Querystring Params","description":"Dictionary containing the querystring parameters of the request."},"creator":{"$ref":"#/components/schemas/UserSimple","description":"User who created the saved search"},"is_archived":{"type":"boolean","title":"Is Archived","description":"Is the saved search archived","default":false},"has_active_webhooks":{"type":"boolean","title":"Has Active Webhooks","description":"Has active webhooks","default":false},"frequency":{"anyOf":[{"$ref":"#/components/schemas/SavedSearchFrequency"},{"type":"null"}],"description":"Frequency of emails alerts sent."},"emails_subscribed":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Emails Subscribed","description":"Emails subscribed to the saved search alerts.","default":[]}},"type":"object","required":["id","name","type","body","user_id","team_id","created_at","updated_at","creator"],"title":"SavedSearch"},"SavedSearchCreate":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","description":"Name of the saved search"},"body":{"anyOf":[{"$ref":"#/components/schemas/CompanySearchFilters-Input"},{"$ref":"#/components/schemas/JobSearchFilters-Input"}],"title":"Body","description":"Filters. CompanySearchFilters if type is 'companies', JobSearchFilters if type is 'jobs'"},"type":{"$ref":"#/components/schemas/SavedSearchType","description":"Type of the saved search."},"is_alert_active":{"type":"boolean","title":"Is Alert Active","description":"Is the alert active","default":false}},"type":"object","required":["body","type"],"title":"SavedSearchCreate"},"SavedSearchFrequency":{"type":"string","enum":["daily","weekly"]},"SavedSearchResponseV0":{"properties":{"id":{"type":"integer","title":"Id","description":"ID of the saved search"},"name":{"type":"string","title":"Name","description":"Name of the saved search"},"type":{"$ref":"#/components/schemas/SavedSearchType","description":"Type of the saved search."},"body":{"anyOf":[{"$ref":"#/components/schemas/CompanySearchFilters-Output"},{"$ref":"#/components/schemas/JobSearchFilters-Output"}],"title":"Body","description":"Filters. CompanySearchFilters if type is 'companies', JobSearchFilters if type is 'jobs'"},"is_alert_active":{"type":"boolean","title":"Is Alert Active","description":"Is the alert active","default":false},"user_id":{"type":"integer","title":"User Id","description":"Owner of the saved search"},"team_id":{"type":"integer","title":"Team Id","description":"Team of the saved search"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Date and time when the saved search was created"},"updated_at":{"type":"string","format":"date-time","title":"Updated At","description":"Date and time when the saved search was last updated"},"query":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Query","description":"Query of the request"},"path":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Path","description":"Path of the request"},"querystring_params":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Querystring Params","description":"Dictionary containing the querystring parameters of the request."},"creator":{"$ref":"#/components/schemas/UserSimple","description":"User who created the saved search"},"is_archived":{"type":"boolean","title":"Is Archived","description":"Is the saved search archived","default":false},"has_active_webhooks":{"type":"boolean","title":"Has Active Webhooks","description":"Has active webhooks","default":false},"frequency":{"anyOf":[{"$ref":"#/components/schemas/SavedSearchFrequency"},{"type":"null"}],"description":"Frequency of emails alerts sent."},"emails_subscribed":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Emails Subscribed","description":"Emails subscribed to the saved search alerts.","default":[]}},"type":"object","required":["id","name","type","body","user_id","team_id","created_at","updated_at","creator"],"title":"SavedSearchResponseV0"},"SavedSearchType":{"type":"string","enum":["companies","jobs"]},"SavedSearchUpdate":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","description":"Name of the saved search"},"body":{"anyOf":[{"$ref":"#/components/schemas/CompanySearchFilters-Input"},{"$ref":"#/components/schemas/JobSearchFilters-Input"},{"type":"null"}],"title":"Body","description":"Filters. CompanySearchFilters if type is 'companies', JobSearchFilters if type is 'jobs'"},"type":{"anyOf":[{"$ref":"#/components/schemas/SavedSearchType"},{"type":"null"}],"description":"Type of the saved search."},"is_alert_active":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Alert Active","description":"Is the alert active"},"frequency":{"anyOf":[{"type":"string","enum":["daily","weekly"]},{"type":"null"}],"title":"Frequency","description":"Frequency of emails alerts sent."},"emails_subscribed":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Emails Subscribed","description":"Emails subscribed to the saved search alerts.","default":[]}},"type":"object","title":"SavedSearchUpdate"},"Seniority":{"type":"string","enum":["c_level","staff","senior","junior","mid_level"],"title":"Seniority"},"StorageConfig":{"properties":{"bucket_name":{"type":"string","title":"Bucket Name","description":"The S3/R2 bucket name where the datasets are stored","examples":["datasets"]},"endpoint_url":{"type":"string","title":"Endpoint Url","description":"The S3-compatible endpoint URL to use for accessing the bucket","examples":["https://example-datasets-url.com"]},"prefixes":{"items":{"type":"string"},"type":"array","title":"Prefixes","description":"The prefixes to use for the temporary credential","examples":[["jobs/daily"]]}},"type":"object","required":["bucket_name","endpoint_url","prefixes"],"title":"StorageConfig"},"TechnographicsFilters":{"properties":{"company_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Id","description":"Only return companies that match this TheirStack Company ID exactly. This ID is temporary and internal and will change in the future and become stable. Until then, it is only meant to be used internally by our UI (app.theirstack.com). For deduplication logic, use company_domain or company_linkedin_url instead.","examples":[null,"1234567890"]},"company_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Name","description":"Only return companies that match this name exactly, case-sensitively.","examples":[null,"Google","Stripe"]},"company_domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Domain","description":"Only return companies that match this domain exactly. It accepts full urls (https://www.google.com/) and emails (john.polo@gmail.com).","examples":[null,"google.com","https://www.google.com/","andrew@stripe.com"]},"company_linkedin_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Linkedin Url","description":"Return companies whose LinkedIn URL matches this URL exactly.","examples":[null,"https://www.linkedin.com/company/openai/","https://www.linkedin.com/company/google/"]},"company_name_or":{"items":{"type":"string"},"type":"array","title":"Company Name Or","description":"Only return companies that match these names exactly, case-sensitively. Deprecated, use the `company_name` filter instead.","default":[],"deprecated":true,"examples":[[],["Google","Facebook","Apple"]]},"order_by":{"items":{"$ref":"#/components/schemas/ColumnSortCompanyTechDetails"},"type":"array","title":"Order By","description":"List of column objects. You can pass several columns to order by, in order of priority. Only `field` is required, `desc` is True by default.","default":[{"desc":true,"field":"confidence"},{"desc":true,"field":"jobs"}]},"include_total_results":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Include Total Results","description":"When enabled, calculates and returns `total_results` and `total_companies` fields in the response. WARNING: This significantly slows down responses as it requires reading the entire dataset. Recommended usage: enable only for the initial request to get totals, then disable for subsequent pagination requests.","default":false},"offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Offset","description":"Number of results to skip. Required for [offset-based pagination](https://theirstack.com/en/docs/api-reference/pagination).","examples":[null,0]},"page":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Page","description":"Page number. Required when using [page-based pagination](https://theirstack.com/en/docs/api-reference/pagination).","examples":[null,0]},"limit":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Limit","description":"Number of results per page","examples":[null,50,500]},"keyword_slug_or":{"items":{"type":"string"},"type":"array","title":"Keyword Slug Or","description":"Return companies that have mentioned any of these keywords (technologies or buying intent topics) in their jobs. Case sensitive. Pass slugs. Check out all keywords at [GET /v0/catalog/keywords](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_keywords_v0)","default":[]},"keyword_category_slug_or":{"items":{"type":"string"},"type":"array","title":"Keyword Category Slug Or","description":"Return companies that have mentioned any keyword from any of these categories in their jobs. Case sensitive. Pass slugs. Check out all keyword categories at [GET /v0/catalog/keywords/categories](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_keywords_categories_v0)","default":[]},"keyword_parent_category_slug_or":{"items":{"type":"string"},"type":"array","title":"Keyword Parent Category Slug Or","description":"Return companies that have mentioned any keyword from any of these parent categories in their jobs. Case sensitive. Pass slugs. Check out all keyword categories at [GET /v0/catalog/keywords/categories](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_keywords_categories_v0)","default":[]},"technology_slug_or":{"items":{"type":"string"},"type":"array","title":"Technology Slug Or","description":"Deprecated: use `keyword_slug_or` instead. Will return companies that have mentioned any of these technologies in their jobs. Case sensitive. Pass slugs.","default":[],"deprecated":true},"technology_category_slug_or":{"items":{"type":"string"},"type":"array","title":"Technology Category Slug Or","description":"Deprecated: use `keyword_category_slug_or` instead. Will return companies that have mentioned any keyword from any of these categories in their jobs. Case sensitive. Pass slugs.","default":[],"deprecated":true},"technology_parent_category_slug_or":{"items":{"type":"string"},"type":"array","title":"Technology Parent Category Slug Or","description":"Deprecated: use `keyword_parent_category_slug_or` instead. Will return companies that have mentioned any keyword from any of these parent categories in their jobs. Case sensitive. Pass slugs.","default":[],"deprecated":true},"max_rank":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Rank","description":"The rank measures how common is a technology within its category. The technology most used among similar ones by a company will have a rank of 1, the second: 2, etc. This is useful to filter results by technology and get only results for the primary technology. ","examples":[null]},"min_jobs":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Jobs","description":"Minimum number of jobs found by each company using a technology","examples":[null]},"max_jobs":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Jobs","description":"Maximum number of jobs found by each company using a technology","examples":[null]},"min_relative_occurrence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Min Relative Occurrence","description":"Minimum value of relative_occurrence_within_category for each technology. Higher values increase the probability that this technology is actually used by the company, because it means a higher percentage of mentions to technologies among this category are of this technology.","examples":[null]},"first_date_found_gte":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"First Date Found Gte","description":"Only return technologies where the first time they were found was after or on this date. Format: \"YYYY-MM-DD\"","examples":[null]},"first_date_found_lte":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"First Date Found Lte","description":"Only return technologies where the first time they were found was before or on this date. Format: \"YYYY-MM-DD\"","examples":[null]},"last_date_found_gte":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Last Date Found Gte","description":"Only return technologies where the last time they were found was after or on this date. Format: \"YYYY-MM-DD\"","examples":[null]},"last_date_found_lte":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Last Date Found Lte","description":"Only return technologies where the last time they were found was before or on this date. Format: \"YYYY-MM-DD\"","examples":[null]},"confidence_or":{"items":{"type":"string","enum":["low","medium","high"]},"type":"array","title":"Confidence Or","description":"Returns technologies with any of these confidence values that the companies use them. Available values: \"high\", \"medium\", \"low\"","default":[]}},"type":"object","title":"TechnographicsFilters","description":"Filter technologies and buying intent topics detected for a company."},"UserSimple":{"properties":{"id":{"type":"integer","title":"Id"},"email":{"type":"string","title":"Email","description":"The user's email address"},"first_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"First Name","description":"The user's first name"},"last_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Name","description":"The user's last name"}},"type":"object","required":["id","email"],"title":"UserSimple"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"Webhook":{"properties":{"url":{"type":"string","maxLength":2083,"minLength":1,"format":"uri","title":"Url","description":"URL of the webhook","examples":["https://example.com/webhook"]},"search_id":{"type":"integer","title":"Search Id","description":"ID of the search that the webhook is listening to.","examples":[123]},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Description of the webhook","examples":["Webhook for new jobs"]},"listening_start_time":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Listening Start Time","description":"Date when the webhook started listening for events. If listening_start_time is None, the webhook will listen to all events matching the search query regardless of when they occurred.","examples":["2024-01-01T00:00:00Z"]},"trigger_once_per_company":{"type":"boolean","title":"Trigger Once Per Company","description":"Only for webhook type ='job.new'. If true, Company A with 5 jobs → 1 event triggered. If false, Company A with 5 jobs → 5 events triggered","default":false,"examples":[true]},"id":{"type":"integer","title":"Id"},"user_id":{"type":"integer","title":"User Id"},"team_id":{"type":"integer","title":"Team Id"},"is_active":{"type":"boolean","title":"Is Active"},"is_archived":{"type":"boolean","title":"Is Archived"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"search_name":{"type":"string","title":"Search Name"},"event_type":{"$ref":"#/components/schemas/WebhookEventType"},"scanning_frequency":{"type":"string","title":"Scanning Frequency","description":"Scanning frequency for the webhook","default":"10m"},"has_secret":{"type":"boolean","title":"Has Secret","readOnly":true}},"type":"object","required":["url","search_id","id","user_id","team_id","is_active","is_archived","created_at","updated_at","search_name","event_type","has_secret"],"title":"Webhook"},"WebhookCreate":{"properties":{"url":{"type":"string","maxLength":2083,"minLength":1,"format":"uri","title":"Url","description":"URL of the webhook","examples":["https://example.com/webhook"]},"search_id":{"type":"integer","title":"Search Id","description":"ID of the search that the webhook is listening to.","examples":[123]},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Description of the webhook","examples":["Webhook for new jobs"]},"listening_start_time":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Listening Start Time","description":"Date when the webhook started listening for events. If listening_start_time is None, the webhook will listen to all events matching the search query regardless of when they occurred.","examples":["2024-01-01T00:00:00Z"]},"trigger_once_per_company":{"type":"boolean","title":"Trigger Once Per Company","description":"Only for webhook type ='job.new'. If true, Company A with 5 jobs → 1 event triggered. If false, Company A with 5 jobs → 5 events triggered","default":false,"examples":[true]},"secret":{"anyOf":[{"type":"string","minLength":16},{"type":"null"}],"title":"Secret","description":"Secret used to sign webhook payloads with HMAC-SHA256. If set, deliveries include an X-TheirStack-Signature-256 header."}},"type":"object","required":["url","search_id"],"title":"WebhookCreate"},"WebhookEvent":{"properties":{"id":{"type":"integer","title":"Id"},"webhook_id":{"type":"integer","title":"Webhook Id"},"job_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Job Id"},"company_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Name"},"triggered_at":{"type":"string","format":"date-time","title":"Triggered At"},"status":{"$ref":"#/components/schemas/WebhookEventStatus"},"payload":{"anyOf":[{"$ref":"#/components/schemas/JobWithMatchingPhrasesResponse-Output"},{"$ref":"#/components/schemas/CompanyWithTechnologiesAndJobs-Output"},{"type":"null"}],"title":"Payload"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"response_status_code":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Response Status Code"},"response_body":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Response Body"}},"type":"object","required":["id","webhook_id","triggered_at","status","created_at","updated_at"],"title":"WebhookEvent"},"WebhookEventCount":{"properties":{"period_start":{"type":"string","format":"date-time","title":"Period Start","description":"Start of the period."},"number_of_events":{"type":"integer","title":"Number Of Events","description":"Number of events.","default":0},"status":{"anyOf":[{"$ref":"#/components/schemas/WebhookEventStatus"},{"type":"null"}],"description":"Status of the webhook event."},"webhook_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Webhook Id","description":"ID of the webhook."},"number_of_executions":{"type":"integer","title":"Number Of Executions","description":"Deprecated: use number_of_events.","deprecated":true,"readOnly":true}},"type":"object","required":["period_start","number_of_executions"],"title":"WebhookEventCount"},"WebhookEventRetryRequest":{"properties":{"webhook_event_ids":{"items":{"type":"integer"},"type":"array","title":"Webhook Event Ids","description":"IDs of the webhook events to retry."}},"type":"object","required":["webhook_event_ids"],"title":"WebhookEventRetryRequest"},"WebhookEventStatus":{"type":"string","enum":["IN_PROGRESS","SUCCESS","FAILED","NOT_TRIGGERED"],"title":"WebhookEventStatus"},"WebhookEventType":{"type":"string","enum":["job_new","company_new"],"title":"WebhookEventType"},"WebhookGroupBy":{"type":"string","enum":["status","webhook_id"],"title":"WebhookGroupBy"},"WebhookPublicEvent":{"properties":{"id":{"type":"integer","title":"Id","description":"Unique identifier for this webhook event"},"type":{"type":"string","enum":["job.new","company.new"],"title":"Type","description":"Event type indicating what triggered the webhook: 'job.new' for new jobs or 'company.new' for new companies"},"payload":{"anyOf":[{"$ref":"#/components/schemas/JobWithMatchingPhrasesResponse-Input"},{"$ref":"#/components/schemas/CompanyWithTechnologiesAndJobs-Input"}],"title":"Payload","description":"Event data containing the job or company information that triggered the webhook. If the type is 'job.new', the payload will be a JobWithMatchingPhrasesResponse object. If the type is 'company.new', the payload will be a CompanyWithTechnologiesAndJobs object."}},"type":"object","required":["id","type","payload"],"title":"WebhookPublicEvent"},"WebhookStatusUpdate":{"properties":{"is_active":{"type":"boolean","title":"Is Active"}},"type":"object","required":["is_active"],"title":"WebhookStatusUpdate"},"WebhookTest":{"properties":{"webhook_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Webhook Id","description":"ID of an existing webhook to test. When provided, url and event_type are loaded from the stored webhook. Body fields (url, secret) can override stored values."},"url":{"anyOf":[{"type":"string","maxLength":2083,"minLength":1,"format":"uri"},{"type":"null"}],"title":"Url","description":"URL to send the test event to. Required when webhook_id is not provided.","examples":["https://example.com/webhook"]},"event_type":{"anyOf":[{"$ref":"#/components/schemas/WebhookEventType"},{"type":"null"}],"description":"Type of event to simulate. Required when webhook_id is not provided."},"secret":{"anyOf":[{"type":"string","minLength":16},{"type":"null"}],"title":"Secret","description":"Secret used to sign webhook payloads with HMAC-SHA256. If set, deliveries include an X-TheirStack-Signature-256 header."}},"type":"object","title":"WebhookTest"},"WebhookTestResponse":{"properties":{"status":{"type":"integer","title":"Status"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"},"signature":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Signature"}},"type":"object","required":["status"],"title":"WebhookTestResponse"},"WebhookUpdate":{"properties":{"url":{"type":"string","maxLength":2083,"minLength":1,"format":"uri","title":"Url","description":"URL of the webhook","examples":["https://example.com/webhook"]},"search_id":{"type":"integer","title":"Search Id","description":"ID of the search that the webhook is listening to.","examples":[123]},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Description of the webhook","examples":["Webhook for new jobs"]},"listening_start_time":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Listening Start Time","description":"Date when the webhook started listening for events. If listening_start_time is None, the webhook will listen to all events matching the search query regardless of when they occurred.","examples":["2024-01-01T00:00:00Z"]},"trigger_once_per_company":{"type":"boolean","title":"Trigger Once Per Company","description":"Only for webhook type ='job.new'. If true, Company A with 5 jobs → 1 event triggered. If false, Company A with 5 jobs → 5 events triggered","default":false,"examples":[true]},"secret":{"anyOf":[{"type":"string","minLength":16},{"type":"null"}],"title":"Secret","description":"Secret used to sign webhook payloads with HMAC-SHA256. If set, deliveries include an X-TheirStack-Signature-256 header. Omit to keep current value; set to null to remove."}},"type":"object","required":["url","search_id"],"title":"WebhookUpdate"}},"securitySchemes":{"Bearer":{"type":"http","scheme":"bearer"}}},"tags":[{"name":"Jobs","description":"Operations with jobs"},{"name":"Companies","description":"The endpoints in this section let you search for companies with multiple filters, as well as getting technographics info about companies."},{"name":"Decision makers","description":"Finding decision makers"},{"name":"Saved Searches","description":"Saved searches let you save a search query so you can reuse it later. You can save a search by clicking on the 'Save' button on the top of the search results page on app.theirstack.com. You can also create and retrieve saved searches programmatically using this API."},{"name":"Catalog","description":"Catalog with the unique values that you can pass to some filters, such as technologies, industries..."},{"name":"Datasets","description":"Datasets are a way to get data from TheirStack. We publish datasets of companies, jobs, and technographics, available via S3 as flat files. If you're interested in accessing our data this way, contact us at hi@theirstack.com."},{"name":"Company Lists","description":"Company lists are a collection of company identifiers. Currently we use company names as identifiers. Company Lists can be used in other endpoints, such as the job search endpoint or the company search endpoint, to get results only from companies that are or aren't included in one or several lists."},{"name":"Webhooks","description":"Webhooks allow you to receive real-time notifications when events occur (new jobs, new companies) that match your saved search criteria. Configure webhooks to trigger actions in external systems like Zapier, Make, N8N, or your own applications."}]}