Technographics
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.
You must specify company_domain, company_name, company_linkedin_url.
It consumes 3 API credits per company lookup, regardless of the number of technologies returned. It doesn't consume credits if there is no response.
Authorization
Bearer In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
- company_domainstringnullable
Only return companies that match this domain exactly. It accepts full urls (https://www.google.com/) and emails (andrew@stripe.com).
- company_idstringnullable
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.
- company_linkedin_urlstringnullable
Return companies whose LinkedIn URL matches this URL exactly.
- company_namestringnullable
Only return companies that match this name exactly, case-sensitively.
- company_name_orarray<string>default: []deprecated
Only return companies that match these names exactly, case-sensitively. Deprecated, use the
company_namefilter instead. - confidence_orarray<string>default: []
Only return keywords (technologies or buying intent topics) detected with any of these confidence levels. Available values: "high", "medium", "low"
- low
- medium
- high
- first_date_found_gtestringnullabledate
Only return keywords (technologies or buying intent topics) where the first time they were found was after or on this date. Format: "YYYY-MM-DD"
- first_date_found_ltestringnullabledate
Only return keywords (technologies or buying intent topics) where the first time they were found was before or on this date. Format: "YYYY-MM-DD"
- include_total_resultsbooleannullabledefault: false
When enabled, calculates and returns
total_resultsandtotal_companiesfields 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. - keyword_category_slug_orarray<string>default: []
Only return keywords from any of these categories. Case sensitive. Pass slugs. Check out all keyword categories at GET /v1/catalog/keywords/categories
- keyword_parent_category_slug_orarray<string>default: []
Only return keywords from any of these parent categories. Case sensitive. Pass slugs. Check out all keyword categories at GET /v1/catalog/keywords/categories
- keyword_slug_orarray<string>default: []
Only return these keywords (technologies or buying intent topics). Case sensitive. Pass slugs. Check out all keywords at GET /v0/catalog/keywords
- last_date_found_gtestringnullabledate
Only return keywords (technologies or buying intent topics) where the last time they were found was after or on this date. Format: "YYYY-MM-DD"
- last_date_found_ltestringnullabledate
Only return keywords (technologies or buying intent topics) where the last time they were found was before or on this date. Format: "YYYY-MM-DD"
- limitintegernullable1 <= value
Number of results per page
- max_jobsintegernullable
Maximum number of jobs in which each company mentions the keyword (technology or buying intent topic)
- max_rankintegernullable
The rank measures how common a keyword (technology or buying intent topic) is within its category for a company. The keyword most mentioned among similar ones by a company has a rank of 1, the second 2, etc. Useful to keep only the primary technology or topic of each category.
- min_jobsintegernullable
Minimum number of jobs in which each company mentions the keyword (technology or buying intent topic)
- min_relative_occurrencenumbernullable
Minimum value of relative_occurrence_within_category for each keyword (technology or buying intent topic). Higher values increase the probability that the company actually uses the technology or cares about the topic, because a higher share of the mentions within that category are of this keyword.
- offsetintegernullable0 <= value
Number of results to skip. Required for offset-based pagination.
- order_byarray<ColumnSortCompanyTechDetails>default: [{"desc":true,"field":"confidence"},{"desc":true,"field":"jobs"}]
List of column objects. You can pass several columns to order by, in order of priority. Only
fieldis required,descis True by default. - pageintegernullable0 <= value
Page number. Required when using page-based pagination.
- technology_category_slug_orarray<string>default: []deprecated
Deprecated: use
keyword_category_slug_orinstead. Only return keywords from any of these categories. Case sensitive. Pass slugs. - technology_parent_category_slug_orarray<string>default: []deprecated
Deprecated: use
keyword_parent_category_slug_orinstead. Only return keywords from any of these parent categories. Case sensitive. Pass slugs. - technology_slug_orarray<string>default: []deprecated
Deprecated: use
keyword_slug_orinstead. Only return these technologies. Case sensitive. Pass slugs.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://api.theirstack.com/v1/companies/technologies" \ -H "Content-Type: application/json" \ -d '{ "company_name": "Microsoft", "keyword_category_slug_or": [ "relational-databases" ], "technology_category_slug_or": [ "relational-databases" ] }'{
"data": [
{
"confidence": "low",
"first_date_found": "2019-08-24",
"jobs": 54,
"jobs_last_180_days": 0,
"jobs_last_30_days": 0,
"jobs_last_7_days": 0,
"last_date_found": "2019-08-24",
"rank_within_category": 0,
"relative_occurrence_within_category": 0,
"technology": {
"category": "Relational Database",
"category_slug": "message-queue",
"logo": "string",
"logo_thumbnail": "string",
"name": "PostgreSQL",
"parent_category": "Data Stores",
"parent_category_slug": "data-stores",
"slug": "kafka",
"type": "technology"
}
}
],
"metadata": {
"total_companies": 1045,
"total_results": 2034,
"truncated_companies": 0,
"truncated_results": 0
}
}{
"error": {
"code": "E-001",
"description": "string",
"title": "Not allowed exception"
},
"request_id": null
}{
"error": {
"code": "E-001",
"description": "string",
"title": "Not allowed exception"
},
"request_id": null
}{
"error": {
"code": "E-001",
"description": "string",
"title": "Not allowed exception"
},
"request_id": null
}{
"error": {
"code": "E-001",
"description": "string",
"title": "Not allowed exception"
},
"request_id": null
}How is this guide?
Last updated on
Company Search POST
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.
Buying Intents POST
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.