> ## Documentation Index
> Fetch the complete documentation index at: https://api.tryspecter.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Get company by ID
> Retrieve the full, current company record for a single Specter company ID. Returns `404` if no company matches the ID.
Costs 1 credit per request.
## OpenAPI
````yaml /api-ref/bundle_api.yaml get /companies/{companyId}
openapi: 3.0.0
info:
title: Specter API
termsOfService: https://tryspecter.com/terms/
contact:
name: API support
email: api-support@tryspecter.com
version: 1.0.0
servers:
- description: Production
url: https://app.tryspecter.com/api/v1
security:
- ApiKeyAuth: []
tags:
- name: Enrichment
description: >
Endpoints which can be used to query for data and, if the data is not
found request that it be retrieved by Specter systems.
- name: Companies
description: >
Endpoints that provide the most up to date information about all the
companies in our data set. Giving the ability to query by a specific
company id, or using a keyword such as the domain.
This also allows us to enrich the data about a company if we either do not
have it or it is older than expected, which means you always have the most
up-to-date information possible.
- name: People
description: >
Endpoints that expose Specter people records — profile data and contact
details — for a known person ID.
- name: Investors
description: >
Endpoints that expose Specter investor records — profile, activity,
targeting, funds, portfolio companies, and the funding rounds they have
participated in — for a known investor ID.
- name: Talent and Interest Signals
description: >
Endpoints for retrieving Specter Talent Signals and Investor Interest
Signals by ID.
- name: News Signals
description: >
Company-level news signals generated from articles monitored by Specter.
Each signal represents a single classified company mention within an
article and includes a summary of the newsworthy update (such as funding,
deals, revenue, profitability, or traction) along with an assigned
importance score.
- name: Revenue Signals
description: >
Revenue and profitability observations for companies, derived from news
coverage and public filings. Each signal captures one data point — the
revenue or profitability metric, the year it refers to, the source, and
the company it is attributed to.
- name: Transactions
description: >
Endpoints that expose transaction detail — funding rounds, acquisitions,
and IPOs — by ID.
- name: Company Lists
description: >
Create, query and maintain lists of companies that are of particular
interest. The endpoints here allow you to interrogate and maintain those
lists using a programmatic interface.
- name: People Lists
description: >
Create, query and maintain lists of people that are of particular
interest. The endpoints here allow you to interrogate and maintain those
lists using a programmatic interface.
- name: Investor Lists
description: >
Create, query and maintain lists of investors that are of particular
interest. The endpoints here allow you to interrogate and maintain those
lists using a programmatic interface.
- name: Network
description: >
Endpoints for accessing your team's LinkedIn network - the people and
companies your teammates are connected to.
- name: Saved Searches
description: >
Manage searches that have been saved via `tryspecter.com`. These endpoints
are useful to programmatically list and delete saved searches. To update a
search the UI should be used at `tryspecter.com`.
- name: Company Saved Searches
description: >
Query and get results for company searches that have been saved via
`tryspecter.com`. These endpoints are useful to programmatically get
results and information for a search. To update a search the UI should be
used at `tryspecter.com`.
- name: People Saved Searches
description: >
Query and get results for people searches that have been saved via
`tryspecter.com` or via the API. These endpoints are useful to
programmatically get results and information for a search. To update a
search the UI should be used at `tryspecter.com`.
- name: Investor Saved Searches
description: >
Query and inspect saved investor searches — metadata (name, match counts)
and paginated results — from searches saved via `tryspecter.com` or shared
with the API.
- name: Talent Signals Saved Searches
description: >
Query and get results for Talent Signals searches that have been saved via
`tryspecter.com`.
- name: Investor Interest Saved Searches
description: >
Query and get results for Investor Interest Signals searches that have
been saved via `tryspecter.com`.
- name: Organization
description: >
Endpoints for accessing your organization's members and org-level
resources.
- name: Customer Data
description: >
Retrieve a log of API calls made by your organization. Useful for auditing
usage, debugging integrations, and monitoring activity.
paths:
/companies/{companyId}:
get:
tags:
- Companies
summary: Get company by ID
description: >
Retrieve the full, current company record for a single Specter company
ID. Returns `404` if no company matches the ID.
Costs 1 credit per request.
parameters:
- $ref: '#/components/parameters/CompanyId'
responses:
'200':
$ref: '#/components/responses/CompanyResponse'
'401':
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/Forbidden'
'404':
$ref: '#/components/responses/NotFound'
'429':
$ref: '#/components/responses/RateLimits'
components:
parameters:
CompanyId:
in: path
name: companyId
schema:
type: string
required: true
description: The Specter company ID.
responses:
CompanyResponse:
description: Information about the company that was queried for.
content:
application/json:
schema:
$ref: '#/components/schemas/Company'
Unauthorized:
description: Unauthorized
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/ApiKeyMissing'
- $ref: '#/components/schemas/ApiKeyNotValid'
Forbidden:
description: Forbidden - There is no permissions to use the endpoint
content:
application/json:
schema:
type: object
properties:
errorCode:
description: NOT_PERMITTED
type: string
example: NOT_PERMITTED
message:
type: string
description: You do not have permission to access this resource.
example: You do not have permission to access this resource.
required:
- errorCode
- message
NotFound:
description: Not Found
content:
application/json:
schema:
type: object
required:
- errorCode
- message
properties:
errorCode:
type: string
description: NOT_FOUND
message:
type: string
description: Not Found
RateLimits:
description: Too Many Requests - API Rate limit exceeded
content:
application/json:
schema:
type: object
required:
- errorCode
- message
properties:
errorCode:
type: string
description: RATE_LIMITED
message:
type: string
description: You have been rate-limited
headers:
X-RateLimit-Limit:
schema:
type: integer
description: The total rate limit allowed for this endpoint
X-RateLimit-Remaining:
schema:
type: integer
description: The number of requests remaining
X-RateLimit-Reset:
schema:
type: number
format: float
description: The number of seconds until the rate limit resets
schemas:
Company:
properties:
id:
description: The Specter ID for this company, can be used in other endpoints
type: string
example: 1a2b3c4d5e6g1a2b3c4d5e6g
organization_name:
description: The main public name for the organization.
type: string
example: Hedgehog Analytics
organization_rank:
description: The Specter rank for this company.
type: number
example: 1258
organization_name_aliases:
description: A list of company names that are associated with this company.
items:
type: string
example: Porcupine Analytics
type: array
example:
- Porcupine, Analytics
- Procupine AI
primary_role:
$ref: '#/components/schemas/Role'
description: The primary role that this company has.
roles:
description: Other roles that the company may have.
items:
$ref: '#/components/schemas/Role'
type: array
description:
description: A description for what the company does, and who they are.
type: string
example: >-
Hedgehog Analytics is a data-driven company specializing in B2C
sales across North America.
tagline:
description: A concise description that highlights what the company does.
type: string
example: Hedgehog Analytics future data-driven sales company.
customer_focus:
$ref: '#/components/schemas/CustomerFocus'
description: The type of customers the company deals with.
business_models:
description: |
The business models that the company operates under.
There can be up to 3 business models assigned to the same company.
type: array
example:
- SaaS
- Subscription
items:
type: string
example:
- SaaS
- Consulting
- Subscription
- Freelance
certifications:
description: Industry certifications like **HIPAA, GDPR**, and more.
type: array
items:
type: string
example:
- HIPPA
- GDPR
- SOC 2
- B Corp
- ISO 27001
customer_profile:
description: |
The companies Typical Customer Profile to help understand the ideal
customers for each company.
type: string
example: >-
Small to medium business wanted to expand and improve their sales
pipelines.
traction_highlights:
description: >-
Impact data reported by the clients on their growth, highlights,
etc.
type: string
example: “5 million monthly unique users”
reported_clients:
description: >
A list of clients the company works with—these are Specter IDs that
link
to other companies in our system.
type: array
items:
type: string
example:
- 3a1b3c4d5e4g1a4453c4d5e3a
- 2a4b3c6d75efg132b3c4d5e2f
example:
- 3a1b3c4d5e4g1a4453c4d5e3a
- 2a4b3c6d75efg132b3c4d5e2f
last_updated:
description: |
A date for when the company was last updated in Specter.
Uses the format YYYY-MM-DD.
type: string
format: date
example: '2025-01-01'
tags:
description: |
Tags taken from different sorts that are related to the company its
industry and what it does.
items:
type: string
type: array
example:
- SaaS
- Data Analytics
industry:
$ref: '#/components/schemas/Industry'
tech_verticals:
$ref: '#/components/schemas/TechVertical'
industries:
description: |
[Deprecated] Use industry
A list of industries that the company trades or is associated with.
items:
type: string
type: array
example:
- Data and Analytics
- DeepTech
- Information Technology
- Software
deprecated: true
sub_industries:
description: >
[Deprecated] Use tech_industries
A list of sub-industries that the company trades or is associated
with.
items:
type: string
type: array
example:
- Analytics
- Open Source
- Software
deprecated: true
operating_status:
$ref: '#/components/schemas/OperatingStatus'
description: The status of the company.
highlights:
$ref: '#/components/schemas/Highlights'
description: All highlights (growth, funding, news, etc)
example:
- headcount_surge
- no_recent_funding
- strong_headcount_growth
- strong_social_growth
- strong_web_traffic_growth
- top_tier_investors
new_highlights:
$ref: '#/components/schemas/Highlights'
description: Highlights new to this month (growth, funding, news, etc)
example:
- headcount_surge
- strong_headcount_growth
- strong_social_growth
- strong_web_traffic_growth
- top_tier_investors
regions:
description: A list of regions that the company operates in.
items:
type: string
type: array
example:
- Europe
founded_year:
description: The year that the company was founded.
type: number
example: 2019
founders:
deprecated: true
description: |
The names of the founders. Deprecated, use the founder_info instead.
items:
type: string
type: array
example:
- Sam Specter
- Arthur Miller
founder_info:
description: Information about the founders.
items:
$ref: '#/components/schemas/CompanyFounders'
type: array
founder_count:
description: The number of founders, equal to the length of the founders list.
type: number
example: 2
employee_count:
description: The number of employees the company currently has.
type: number
example: 39
employee_count_range:
description: A range for how many the employees the company has.
type: string
enum:
- 1-10
- 11-50
- 51-200
- 201-500
- 501-1000
- 1001-5000
- 5001-10000
- 10001+
investors:
description: The list of investors who have invested in the company, can be none.
items:
type: string
type: array
example:
- YCombinator
investor_count:
description: >-
The number of investors, same as the length of the list of
investors.
type: number
example: 1
patent_count:
description: The number of patents that the company owns.
type: number
example: 5
trademark_count:
description: The number of trademarks the company has.
type: number
example: 2
website:
$ref: '#/components/schemas/Website'
description: The website information related to the company.
hq:
$ref: '#/components/schemas/HQ'
description: Location information about the companies HQ.
contact:
$ref: '#/components/schemas/Contact'
description: General contact information for the company.
acquisition:
$ref: '#/components/schemas/Acquisition'
description: >-
If the company has been acquired, information about the acquisition
is here.
ipo:
description: List of IPOs if there have been any.
items:
$ref: '#/components/schemas/IpoDetails'
type: array
growth_stage:
$ref: '#/components/schemas/GrowthStage'
description: Indicates what growth stage the company is in.
funding:
$ref: '#/components/schemas/Funding'
description: Information about funding the company has received.
web:
$ref: '#/components/schemas/Web'
description: Metrics related to the web, user visits, popularity, etc.
technologies:
description: A list of technologies that the company uses.
items:
type: string
type: array
example:
- Cloudflare CDN
- French Server Location
- Gravatar Profiles
- Hubspot Hosted
it_spend:
description: The annual amount in USD ($) that the company spends on IT.
type: number
example: 40
awards:
description: A list of awards the company has received.
items:
$ref: '#/components/schemas/Awards'
type: array
award_count:
description: >
The number of awards the company has, same as the length of the
awards
field.
type: number
example: 1
news:
description: >-
A list of new items about the company. At current, this may not
resemble what you see on the front end as it reflects News v1. The
latest (Specter News v2) endpoints are coming soon.
items:
$ref: '#/components/schemas/News'
type: array
reviews:
description: >
Information about reviews of the website, and products that the
company
has received through different sites (G2, Trustpilot, Chrome
Extensions, etc)
properties:
g2:
$ref: '#/components/schemas/G2Reviews'
trustpilot:
$ref: '#/components/schemas/TrustpilotReviews'
chrome_extensions:
$ref: '#/components/schemas/ChromeExtensionReviews'
glassdoor:
$ref: '#/components/schemas/GlassdoorReviews'
required:
- g2
additionalProperties: false
type: object
socials:
$ref: '#/components/schemas/Socials'
traction_metrics:
$ref: '#/components/schemas/TractionMetrics'
specter_strategic_signal_ids:
description: |
List of Specter's strategic signal IDs
type: array
items:
type: string
example: adced32f-8a8b-495f-a8f3-333449769736
founder_highlights:
type: array
description: >
Notable attributes of the founding team — e.g. prior exits, prior
VC-backed experience, strong technical background.
items:
type: string
example:
- prior_vc_backed_experience
- strong_technical_background
- vc_backed_founder
team_department_breakdown:
type: array
description: >
Share of employees in each department. `percentage` is a fraction
between 0 and 1.
items:
type: object
additionalProperties: false
properties:
department:
type: string
example: Engineering
percentage:
type: number
example: 0.34
team_location_breakdown:
type: array
description: Employee headcount by country.
items:
type: object
additionalProperties: false
properties:
country:
type: string
example: India
employee_count:
type: integer
example: 133
required:
- id
- organization_name
- organization_rank
- primary_role
- roles
- description
- customer_focus
- last_updated
- tags
- industries
- sub_industries
- operating_status
- logo_url
- highlights
- new_highlights
- regions
- founded_year
- founders
- foundersInfo
- founder_count
- employee_count
- employee_count_range
- investors
- investor_count
- patent_count
- trademark_count
- website
- hq
- contact
- ipo
- growth_stage
- funding
- web
- awards
- award_count
- news
- reviews
- socials
additionalProperties: false
title: CompanyResponse
type: object
ApiKeyMissing:
properties:
errorCode:
description: API_KEY_MISSING
example: API_KEY_MISSING
type: string
message:
description: No API Key was presented on the header X-API-KEY
example: No API Key was presented on the header X-API-KEY
type: string
ApiKeyNotValid:
properties:
errorCode:
description: API_KEY_NOT_VALID
example: API_KEY_NOT_VALID
type: string
message:
description: API key present, but not valid
example: API key present, but not valid
type: string
Role:
type: string
enum:
- company
- investor
- school
example: company
CustomerFocus:
type: string
enum:
- b2b
- b2c
- b2b_b2c
- b2c_b2b
example: b2c
Industry:
type: array
items:
type: string
example: Financial Services
example:
- Financial Services
- Financial Technology
description: >
Classifies companies by their economic activity — the market they serve
and the products or services they deliver.
E.g: Construction, Utilities, Wholesale.
There is one industry per company, with up to three levels.
nullable: true
TechVertical:
type: array
items:
type: array
items:
type: string
example: Blockchain, Crypto & Web3
example:
- - Blockchain, Crypto & Web3
- Crypto Exchanges and Trading Infrastructure
title: Experience.tech_verticals
description: >
Classifies companies by the technology domain they operate in — the
technical capability or space they're building around.
E.g: AI & Machine Learning, Cybersecurity, FinTech.
There can be up to 5 tech verticals per company, with 2 levels each.
nullable: true
OperatingStatus:
type: string
enum:
- active
- acquired
- closed
- ipo
example: active
Highlights:
type: array
items:
description: |
The type of highlight, the full list will be added shortly, these are
based on growth, news, funding and other aspects of the company.
type: string
example:
- early_stage
CompanyFounders:
properties:
specter_person_id:
description: The person Id for the founder to be used with the people API.
type: string
example: per_7f8d9e2a1b3c4d5e6f7g8h9i0
full_name:
description: Full name of the founder.
type: string
example: Sarah Chen
title:
description: Title of the founder.
type: string
example: Co-Founder & CTO
departments:
description: List of the departments the founder is in.
type: array
items:
type: string
example: Senior Leadership
seniority:
description: Seniority of the founder.
type: string
example: Executive Level
additionalProperties: false
title: CompanyFounders
type: object
Website:
properties:
domain:
description: The domain of the website, can have a sub-domain.
type: string
example: hedgehog_analytics.com
url:
description: The website url, will contain the protocol, and may contain `www.`.
type: string
example: https://www.hedgehog_analytics.com
domain_aliases:
description: Any other domains that are associated with the company.
items:
type: string
type: array
example:
- hh_analytics.com
- hedgehoganalytics.com
required:
- domain
- url
- domain_aliases
additionalProperties: false
type: object
HQ:
properties:
city:
description: City for the location.
type: string
example: London
state:
description: >-
State for the location, outside of America will relate to the
country and region.
type: string
example: England
country:
description: Country for the location.
type: string
example: United Kingdom
region:
description: Use `continent` instead.
type: string
example: Europe
deprecated: true
continent:
description: The continent the HQ is in.
type: string
example: Europe
regions:
description: Any regions that the HQ is in.
type: array
items:
type: string
example:
- London Metropolitan Area
- EMEA
required:
- city
- state
- country
- region
additionalProperties: false
title: HQ
type: object
Contact:
properties:
phone_number:
type: string
example: '075555555'
email:
type: string
example: contact@hedgehog_analytics.com
required:
- phone_number
- email
additionalProperties: false
title: Contact
type: object
Acquisition:
properties:
acquirer:
description: The acquiring party.
type: string
example: Acquire Er
date:
description: Date when the acquisition took place.
type: string
example: '2022-01-01'
amount_usd:
description: How much in USD ($) the acquisition was for.
type: number
example: 500000
required:
- acquirer
- date
- amount_usd
additionalProperties: false
title: Acquisition
type: object
IpoDetails:
properties:
wentPublicOn:
description: The date in the form YYYY-MM-DD that the IPO took place.
type: string
example: '2018-11-28'
stockExchange:
description: The stock exchange the company went public on.
type: string
example: cnsx
stockSymbol:
description: The stock symbol for the company.
type: string
example: HGAN
sharePrice:
description: The IPO stock price (not the current stock price)
type: number
example: 0.001
valuationPrice:
description: The valuation price upon IPO.
type: number
example: 500000
raisedAmount:
description: How much was raised USD ($) in the IPO.
type: number
example: 50000
additionalProperties: false
title: IpoDetails
type: object
GrowthStage:
type: string
enum:
- bootstrapped
- seed_stage
- early_stage
- growth_stage
- late_stage
- exit_stage
example: growth_stage
Funding:
properties:
total_funding_usd:
description: |
The total aggregated amount in USD ($) that the company has raised
in all funding rounds.
type: number
example: 50000
last_funding_usd:
description: The last amount in USD ($) that the company raised.
type: number
example: 50000
last_funding_date:
description: The date in the format YYYY-MM-DD that the last funding took place.
type: string
example: '2020-01-01'
last_funding_type:
$ref: '#/components/schemas/FundingType'
description: The last type of funding the company had, "series_a", "angel", etc
round_count:
description: How many funding rounds the company has had.
type: number
example: 1
round_details:
description: Details from each of the funding rounds the company has had.
items:
$ref: '#/components/schemas/FundingRound'
type: array
post_money_valuation_usd:
description: The post money valuation in USD ($).
type: number
required:
- total_funding_usd
- last_funding_usd
- last_funding_date
- last_funding_type
- round_count
- round_details
- post_money_valuation_usd
additionalProperties: false
title: Funding
type: object
Web:
properties:
visits:
type: number
example: 770
popularity_rank:
type: number
example: 16696448
top_country:
type: string
example: Europe
bounce_rate:
type: number
example: 23
bounce_rate_3mo_change:
type: number
example: 3
pages_per_visit:
type: number
example: 1.02
pages_per_visit_3mo_change:
type: number
example: -0.88
session_duration:
type: number
example: 43
session_duration_3mo_change:
type: number
example: 20
traffic_source:
description: >
The sources of web traffic in a semi-colon delimited list:
`Direct: 38.0%; Referrals: 8.8%; Search: 45.2%; Social: 5.9%; Mail:
0.1%`
type: string
example: >-
Direct: 38.0%; Referrals: 8.8%; Search: 45.2%; Social: 5.9%; Mail:
0.1%
country_breakdown:
type: string
example: 'Reddit: 100.0%'
required:
- visits
- popularity_rank
- top_country
- bounce_rate
- bounce_rate_3mo_change
- pages_per_visit
- pages_per_visit_3mo_change
- session_duration
- session_duration_3mo_change
- traffic_source
- country_breakdown
additionalProperties: false
title: Web
type: object
Awards:
properties:
award_name:
description: Name of the award.
type: string
example: Top Analytics Startup
award_details:
description: >-
Extra details about the award, the rank that it was received at for
instance.
type: string
example: Rank 2
award_year:
description: The year the award was received.
type: string
example: 2023
award_org:
description: The organization that gives out the award.
type: string
example: Data Innovation Awards
award_link:
description: A link to the award information.
type: string
example: https://data_awards.com/leaderboards/analytics-2023
logo_url:
description: >-
A logo for the award, often a badge to show what the award is in a
visual form.
type: string
example: https://specter-company-logo.s3.amazonaws.com/data_awards.jpeg
additionalProperties: false
title: CompanyAwards
type: object
News:
properties:
date:
description: Date in YYYY-MM-DD form that the news was published.
type: string
example: '2025-01-01'
title:
description: A title related to the news.
type: string
example: >-
Hedgehog Analytics set to transform data-driven decision making in
2025
url:
description: A link to the news.
type: string
example: https://technews.com/2025/hedgehog-analytics-vision
publisher:
description: The outlet that published the news.
type: string
example: TechNews Ltd
required:
- date
- title
- url
- publisher
additionalProperties: false
title: News
type: object
G2Reviews:
description: Information about all G2 reviews with an aggregated rating.
properties:
products:
items:
$ref: '#/components/schemas/G2ProductData'
type: array
rating_avg:
description: An average rating across all products.
type: number
example: 3.5
review_count:
description: The total number of G2 reviews across all products.
type: number
example: 15
required:
- products
- rating_avg
- review_count
additionalProperties: false
type: object
TrustpilotReviews:
description: Reviews for a company or website from Trustpilot
properties:
url:
description: The Trustpilot review link.
type: string
example: https://www.trustpilot.com/reviews/hedgehog_insights.com
review_count:
description: The total number of reviews on Trustpilot.
type: number
example: 5
review_avg:
description: The average rating for the company or website on Trustpilot.
type: number
example: 2.8
required:
- url
additionalProperties: false
title: TrustpilotReviews
type: object
ChromeExtensionReviews:
description: Information about Chrome extension reviews and ratings for the company.
properties:
products:
items:
$ref: '#/components/schemas/ChromeExtensionData'
type: array
rating_avg:
description: An average rating across all chrome extensions.
type: number
example: 3.5
review_count:
description: The total number of reviews across all Chrome extensions.
type: number
example: 15
user_count:
description: The total number of users across all Chrome extensions.
type: number
example: 150
required:
- products
- rating_avg
- review_count
additionalProperties: false
type: object
GlassdoorReviews:
description: Information about Glassdoor reviews and ratings for the company.
properties:
url:
description: The URL of the company's Glassdoor page.
type: string
example: https://www.glassdoor.com/Overview/hedgehog_insights.com
rating:
description: >
The Glassdoor rating for the company, reflecting their employee
satisfaction
and workplace reputation.
type: number
example: 3.5
reviews:
description: The number of views the company has received on Glassdoor.
type: number
example: 15
leadership_approval:
description: The leadership approval rating for the company.
type: number
example: 3.5
additionalProperties: false
type: object
Socials:
description: Information about different social sites.
properties:
twitter:
$ref: '#/components/schemas/Twitter'
facebook:
$ref: '#/components/schemas/Facebook'
linkedin:
$ref: '#/components/schemas/Linkedin'
itunes:
$ref: '#/components/schemas/ITunes'
googleplay:
$ref: '#/components/schemas/GoogePlay'
instagram:
$ref: '#/components/schemas/Instagram'
crunchbase:
$ref: '#/components/schemas/Crunchbase'
pitchbook:
$ref: '#/components/schemas/Pitchbook'
required:
- twitter
- facebook
- linkedin
- itunes
- googleplay
- instagram
- crunchbase
additionalProperties: false
title: Socials
type: object
TractionMetrics:
description: >
Gain deeper insights into a company's **traction and growth trends**
across key
areas, including website traffic, social media presence, app engagement,
and
employee expansion.
This dataset reveals how a company’s metrics have evolved over time,
allowing
you to track momentum and make **data-driven decisions**.
Each traction metric highlights the **difference between the current
value and
past values**, providing clear visibility into growth patterns over:
- 📆 1mo: 1-month growth
- 📆 2mo: 2-month growth
- 📆 3mo: 3-month growth
- 📆 4mo: 4-month growth
- 📆 5mo: 5-month growth
- 📆 6mo: 6-month growth
- 📆 12mo: 12-month growth
- 📆 24mo: 24-month growth
properties:
web_visits:
$ref: '#/components/schemas/TractionMetric'
description: |
📊 Tracks website visit trends over time, helping you assess
**online engagement and visibility**.
popularity_rank:
$ref: '#/components/schemas/TractionMetric'
description: |
🚀 Monitors shifts in website **popularity ranking**, showing how a
company compares to competitors.
employee_count:
$ref: '#/components/schemas/TractionMetric'
description: |
👥 Analyzes workforce expansion or reduction, helping gauge
**company growth and stability**.
linkedin_followers:
$ref: '#/components/schemas/TractionMetric'
description: >
🔗 Measures **LinkedIn follower trends**, revealing corporate
influence
and brand reach.
twitter_followers:
$ref: '#/components/schemas/TractionMetric'
description: >
🐦 Tracks **Twitter follower fluctuations**, offering insights into
social
engagement and audience growth.
instagram_followers:
$ref: '#/components/schemas/TractionMetric'
description: >
📸 Evaluates **Instagram follower trends**, highlighting brand
awareness
and social traction.
itunes_reviews:
$ref: '#/components/schemas/TractionMetric'
description: >
⭐ Measures **customer feedback on iTunes**, showing user sentiment
and
app reception.
googleplay_reviews:
$ref: '#/components/schemas/TractionMetric'
description: >
📱 Tracks **Google Play review trends**, providing insights into
mobile
app performance and reputation.
app_downloads:
$ref: '#/components/schemas/TractionMetric'
description: >
📈 Measures **app download growth** across platforms like iTunes
and
Google Play, reflecting adoption rates.
g2_reviews:
$ref: '#/components/schemas/TractionMetric'
description: >
💼 Monitors **G2 review growth**, showing how businesses are
perceived in
the B2B market.
trustpilot_reviews:
$ref: '#/components/schemas/TractionMetric'
description: >
🏆 Tracks **Trustpilot reviews**, providing a pulse on customer
trust and
brand credibility.
chrome_extensions_reviews:
$ref: '#/components/schemas/TractionMetric'
description: >
🌐 Measures **Chrome extension review growth**, offering insights
into
extension usability and satisfaction.
chrome_extensions_users:
$ref: '#/components/schemas/TractionMetric'
description: >
🔥 Tracks **Chrome extension user growth**, revealing adoption
trends and
product demand.
glassdoor_rating:
$ref: '#/components/schemas/TractionMetric'
description: >
🌟 Monitors **Glassdoor ratings**, reflecting employee
satisfaction,
company culture, and workplace reputation.
glassdoor_reviews:
$ref: '#/components/schemas/TractionMetric'
description: >
📝 Tracks **Glassdoor reviews**, providing qualitative insights into
employee experiences,
feedback, and organizational strengths or weaknesses.
additionalProperties: false
type: object
FundingType:
type: string
enum:
- angel
- pre_seed
- seed
- equity_crowdfunding
- product_crowdfunding
- non_equity_assistance
- convertible_note
- grant
- series_a
- series_b
- series_c
- series_d
- series_e
- series_f
- series_g
- series_h
- series_i
- series_j
- undisclosed
- series_unknown
- corporate_round
- private_equity
- debt_financing
- initial_coin_offering
- secondary_market
- post_ipo_debt
- post_ipo_equity
- post_ipo_secondary
- venture
example: angel
FundingRound:
properties:
type:
$ref: '#/components/schemas/FundingType'
description: The type of funding for this round ("angel", "series_a", etc)
date:
description: The date in the form YYYY-MM-DD that the round occurred.
type: string
example: '2020-02-02'
raised:
description: How much was raised in USD ($) for this round.
type: number
example: 50000
investors:
description: The investors that participated in the funding round.
items:
type: string
type: array
example:
- YCombinator
required:
- date
- investors
additionalProperties: false
title: FundingRound
type: object
G2ProductData:
description: Product data about the G2 product being reviewed.
properties:
product_name:
description: Name of the product.
type: string
example: Hedgehog Insights
url:
description: Link to the G2 reviews for the product.
type: string
example: https://www.g2.com/products/hedgehog_insights/reviews
review_count:
description: Number of reviews that the product has received.
type: number
example: 15
rating:
description: The rating out of 5 for the product.
type: number
example: 3.5
required:
- product_name
- url
additionalProperties: false
type: object
ChromeExtensionData:
description: Information about a specific Chrome extension.
properties:
name:
description: Name of the extension.
type: string
example: Hedgehog Customer Extension
url:
description: Link to the Chrome web store
type: string
example: >-
https://chromewebstore.google.com/detail/hedgehod-customer-extension/fdafneoiangoeinaeoigneon
review_count:
description: >
Number of reviews that the extension has received. If not present
then
there are no reviews.
type: number
example: 15
rating:
description: |
The rating out of 5 for the extension. If there are no reviews the
extension won't have a rating.
type: number
example: 3.5
user_count:
description: The current number of users of the extension.
type: number
example: 3.5
overall_rank:
description: A rank for the extension from all the extensions on the store.
type: number
example: 120
is_featured:
description: Tells if the extension is featured on the web store or not.
type: boolean
example: false
required:
- url
additionalProperties: false
type: object
Twitter:
properties:
url:
type: string
example: twitter.com/hedgehog_analytics
follower_count:
type: number
example: 10
required:
- url
- follower_count
additionalProperties: false
title: Twitter
type: object
Facebook:
properties:
url:
type: string
example: facebook.com/hedgehog_analytics
required:
- url
additionalProperties: false
title: Facebook
type: object
Linkedin:
properties:
url:
type: string
example: linkedin.com/company/hedgehog_analytics
follower_count:
type: number
example: 5000
required:
- url
- follower_count
additionalProperties: false
title: Linkedin
type: object
ITunes:
properties:
url:
type: string
example: apps.apple.com/sa/app/hedgehog_analytics/id34454543
app_id:
type: string
example: hh3242533
review_count:
type: number
example: 50
rating:
type: number
example: 3.8
required:
- url
- app_id
- review_count
- rating
additionalProperties: false
title: ITunes
type: object
GoogePlay:
properties:
url:
type: string
example: play.google.com/store/apps/details?id=com.hedgehog_analytics
app_id:
type: string
example: hedgehog_analytics
review_count:
type: number
example: 50
rating:
type: number
example: 2.4
install_count:
type: number
example: 5000
required:
- url
- app_id
- review_count
- rating
- install_count
additionalProperties: false
title: GoogePlay
type: object
Instagram:
properties:
url:
type: string
example: instagram.com/hedgehog_analytics
follower_count:
type: number
example: 40
following_count:
type: number
example: 2
required:
- url
- follower_count
- following_count
additionalProperties: false
title: Instagram
type: object
Crunchbase:
properties:
url:
type: string
example: crunchbase.com/organization/hedgehog_analytics
required:
- url
additionalProperties: false
title: Crunchbase
type: object
Pitchbook:
properties:
url:
type: string
example: pitchbook.com/profiles/company/000000-00
required:
- url
additionalProperties: false
title: Pitchbook
type: object
TractionMetric:
properties:
latest:
description: The current value of the metric.
type: number
example: 12260
1mo:
$ref: '#/components/schemas/ChangeMetric'
2mo:
$ref: '#/components/schemas/ChangeMetric'
3mo:
$ref: '#/components/schemas/ChangeMetric'
4mo:
$ref: '#/components/schemas/ChangeMetric'
5mo:
$ref: '#/components/schemas/ChangeMetric'
6mo:
$ref: '#/components/schemas/ChangeMetric'
12mo:
$ref: '#/components/schemas/ChangeMetric'
24mo:
$ref: '#/components/schemas/ChangeMetric'
required:
- latest
additionalProperties: false
title: TractionMetric
type: object
ChangeMetric:
properties:
value:
description: The value at this period.
type: number
example: 13649
change:
description: The difference between the latest value and this value.
type: number
example: 130
percentage:
description: The percentage change based on the latest value.
type: number
example: 1
required:
- value
- change
additionalProperties: false
title: ChangeMetric
type: object
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: X-API-Key
````