PredictLeads provides company intelligence datasets that are indicative of company performance.
Tracked are some 70+ million companies globally for signals like: News Events, Job Openings, Technographics, Key Customers data and more.
Use cases include:
Companies dataset includes additional information about the company eg.: normalized company location, ticker, meta title, meta description...
CompaniesDataset
|
object
|
data
|
array
|
Company
|
object
|
id
|
string
PredictLeads ID of the Company object.
uuid
|
type
|
string
Type of the Company object.
"company"
|
attributes
|
object
|
domain
|
string
Company domain name. |
ticker
|
string
nullable
Company stock symbol (ticker) if available. |
company_name
|
string
nullable
Company name if available. |
friendly_company_name
|
string
Company friendly name. |
location
|
string
Company location. |
location_data
|
array
|
LocationData
|
object
|
city
|
string
nullable
|
state
|
string
nullable
|
zip_code
|
string
nullable
|
country
|
string
nullable
|
region
|
string
nullable
|
continent
|
string
nullable
|
fuzzy_match
|
boolean
nullable
|
language
|
string
Company website's language. |
meta_title
|
string
Company website's meta title. |
meta_description
|
string
Company website's meta title. |
relationships
|
object
Contains references to related objects listed in property "included". |
parent_company
|
object
|
data
|
object
|
id
|
|
type
|
|
redirects_to
|
object
|
data
|
object
|
id
|
|
type
|
|
included
|
array
Contains objects referenced in property "relationships". |
CompanyLite
|
object
|
id
|
string
PredictLeads ID of the CompanyLite object.
uuid
|
type
|
string
Type of the CompanyLite object.
"company"
|
attributes
|
object
|
domain
|
string
Company domain name. |
ticker
|
string
nullable
Company stock symbol (ticker) if available. |
company_name
|
string
nullable
Company name if available. |
meta
|
object
Meta information about response. Only shown in API responses. |
count
(optional)
|
integer
Total number of results.
|
message
(optional)
|
string
Additional information about response. |
message_type
(optional)
|
string
Type of the message.
"accepted"
|
redirects_to_domain
|
string
nullable
Domain that this company domain redirects to. |
parent_company_domain
|
string
nullable
Parent company domain. |
Company Connections describe relationships between companies.
It is sourced from Case Study pages, Testimonials and more. Connections are categorized into 8 categories
such as vendor, partner, investor, parent...
Connections data can be used to get insight about the quality of company network, to identify partners in
common, measure its progress over time and more.
ConnectionsDataset
|
|
data
|
array
|
Connection
|
object
|
id
|
string
PredictLeads ID of the Connection object.
uuid
|
type
|
string
Type of the Connection object.
"connection"
|
attributes
|
object
|
category
|
string
Connection category.
"other", "partner", "vendor", "integration", "investor", "sponsor", "parent", "rebranding", "published_in"
|
source_category
|
string
Describes source where the category was found.
"undefined", "partner_page", "vendor_page", "integration_page", "investor_page", "sponsor_page", "parent_page", "case_study_page", "testimonial_page", "social_page", "manual_input", "domain_redirect", "same_subpage", "partner_section", "vendor_section", "integration_section", "investor_section", "sponsor_section", "parent_section", "case_study_section", "testimonial_section", "social_section", "published_in_section", "vendor_inverse_section", "investor_inverse_section", "parent_inverse_section", "footer", "header", "vendor_inverse_page", "cookie_section"
|
source_url
|
string
nullable
If the connection was found on a subpage, source_url points to that subpage.
uri
|
individual_source_url
(optional)
|
string
nullable
Some connections contain additional information on their individual subpages. individual_source_url points to that subpage.
uri
|
context
(optional)
|
string
Text found near the connection. Often contains additional relationship information between the two companies. |
first_seen_at
|
string
Time & date (ISO 8601) of when the connection was first seen.
date-time
|
last_seen_at
|
string
Time & date (ISO 8601) of when the connection was last seen.
date-time
|
relationships
|
object
Contains references to related objects listed in property "included". Order of companies is guaranteed and necessary to preserve the meaning of the "category". For example:... Contains references to related objects listed in property "included". Order of companies is guaranteed and necessary to preserve the meaning of the "category". For example: Company1 is a vendor to Company2. |
company1
|
object
|
data
|
object
|
id
|
|
type
|
|
company2
|
object
|
data
|
object
|
id
|
|
type
|
|
included
|
array
Contains objects referenced in property "relationships". |
CompanyLite
|
object
|
id
|
string
PredictLeads ID of the CompanyLite object.
uuid
|
type
|
string
Type of the CompanyLite object.
"company"
|
attributes
|
object
|
domain
|
string
Company domain name. |
ticker
|
string
nullable
Company stock symbol (ticker) if available. |
company_name
|
string
nullable
Company name if available. |
meta
|
object
Meta information about response. Only shown in API responses. |
count
(optional)
|
integer
Total number of results.
|
message
(optional)
|
string
Additional information about response. |
message_type
(optional)
|
string
Type of the message.
"accepted"
|
redirects_to_domain
|
string
nullable
Domain that this company domain redirects to. |
parent_company_domain
|
string
nullable
Parent company domain. |
Financing Events are events extracted from News Events data.
These include e.g. Venture capital rounds, Private Equity investments etc.
Financing events are grouped by date of investment and include investment amount, names of investors and
more.
FinancingEventsDataset
|
object
|
data
|
array
|
FinancingEvent
|
object
|
id
|
string
PredictLeads ID of the FinancingEvent object.
uuid
|
type
|
string
Type of the FinancingEvent object.
"financing_event"
|
attributes
|
object
|
effective_date
|
string
nullable
ISO 8601 date when the event has happened.
date-time
|
found_at
|
string
ISO 8601 date when the event was discovered and created.
date-time
|
categories
|
array
[ "private_equity", "series_e", "venture" ]
|
Items
|
string
"private_equity", "equity_crowdfunding", "product_crowdfunding", "convertible_note", "debt_financing", "donation", "grant", "post_ipo_debt", "post_ipo_equity", "post_ipo_secondary", "post_ipo", "initial_public_offering", "initial_coin_offering", "initial_dex_offering", "venture", "pre_angel", "angel", "angel1", "angel2", "angel3", "pre_seed", "seed", "seed1", "seed2", "seed3", "pre_series_a", "series_a", "series_a1", "series_a2", "series_a3", "pre_series_b", "series_b", "series_b1", "series_b2", "series_b3", "pre_series_c", "series_c", "series_c1", "series_c2", "series_c3", "pre_series_d", "series_d", "series_d1", "series_d2", "series_d3", "pre_series_e", "series_e", "series_e1", "series_e2", "series_e3", "pre_series_f", "series_f", "series_f1", "series_f2", "series_f3", "pre_series_g", "series_g", "series_g1", "series_g2", "series_g3", "pre_series_h", "series_h", "series_h1", "series_h2", "series_h3", "pre_series_i", "series_i", "series_i1", "series_i2", "series_i3", "pre_series_j", "series_j", "series_j1", "series_j2", "series_j3"
|
financing_type
|
string
nullable
A financing type this event is mentioning.
"Series E funding"
|
financing_type_normalized
|
string
nullable
A normalized value of "financing_type" property, where possible.
"pre_angel", "angel", "angel1", "angel2", "angel3", "pre_seed", "seed", "seed1", "seed2", "seed3", "pre_series_a", "series_a", "series_a1", "series_a2", "series_a3", "pre_series_b", "series_b", "series_b1", "series_b2", "series_b3", "pre_series_c", "series_c", "series_c1", "series_c2", "series_c3", "pre_series_d", "series_d", "series_d1", "series_d2", "series_d3", "pre_series_e", "series_e", "series_e1", "series_e2", "series_e3", "pre_series_f", "series_f", "series_f1", "series_f2", "series_f3", "pre_series_g", "series_g", "series_g1", "series_g2", "series_g3", "pre_series_h", "series_h", "series_h1", "series_h2", "series_h3", "pre_series_i", "series_i", "series_i1", "series_i2", "series_i3", "pre_series_j", "series_j", "series_j1", "series_j2", "series_j3", null
"series_e"
|
amount
|
string
nullable
This is a string of a value as extracted from text.
"$555.5 million"
|
amount_normalized
|
integer
nullable
Integer value of "amount" property.
555500000
|
source_urls
|
array
|
Items
|
string
uri
[ "https://www.chinamoneynetwork.com/2018/10...
[ "https://www.chinamoneynetwork.com/2018/10/10/yunfeng-advantech-lead-300m-round-in-chinas-airbnb-copycat-xiaozhu-com" ]
|
relationships
|
object
Contains references to related objects listed in property "included". |
company
|
object
|
data
|
object
|
id
|
|
type
|
|
investors
|
object
|
data
|
array
|
Items
|
object
|
id
|
|
type
|
|
included
|
array
Contains objects referenced in property "relationships". |
CompanyLite
|
object
|
id
|
string
PredictLeads ID of the CompanyLite object.
uuid
|
type
|
string
Type of the CompanyLite object.
"company"
|
attributes
|
object
|
domain
|
string
Company domain name. |
ticker
|
string
nullable
Company stock symbol (ticker) if available. |
company_name
|
string
nullable
Company name if available. |
meta
|
object
Meta information about response. Only shown in API responses. |
count
(optional)
|
integer
Total number of results.
|
message
(optional)
|
string
Additional information about response. |
message_type
(optional)
|
string
Type of the message.
"accepted"
|
redirects_to_domain
|
string
nullable
Domain that this company domain redirects to. |
parent_company_domain
|
string
nullable
Parent company domain. |
Job Openings are found on companies' career sites and job boards. Job Openings and other descriptions can
be used to identify company investment areas, current priorities and future developments.
Provided are fields like Job Category (marketing, sales, HR, support...), job description, salary, location
and many more.
JobOpeningsDataset
|
object
|
data
|
array
|
JobOpening
|
object
|
id
|
string
PredictLeads ID of the JobOpening object.
uuid
|
type
|
string
Type of the JobOpening object.
"job_opening"
|
attributes
|
object
|
title
|
string
Job title. |
description
|
string
nullable
Job opening description. |
url
|
string
URL of the web page where the data was found.
uri
|
first_seen_at
|
string
Time & date (ISO 8601) of when the job opening was first seen.
date-time
|
last_seen_at
|
string
Time & date (ISO 8601) of when the job opening was last seen.
date-time
|
last_processed_at
|
string
Time & date (ISO 8601) of when the job opening was last sent to processing.
date-time
|
contract_types
|
array
Zero or more types describing the job opening.
[ "full time", "remote" ]
|
Items
|
string
|
categories
|
array
Zero or more organizational categories of the job opening.
[ "finance", "data_analysis" ]
|
Items
|
string
|
onet_data
|
object
Inferred O*NET data for this job opening. O*NET is a source and standardization of occupational information. More info on the O*NET data: onetonline.org. |
code
|
string
nullable
O*NET category code representing this job opening.
"29-1021.00"
|
family
|
string
nullable
O*NET family name matching the code for this job opening.
"Healthcare Practitioners and Technical"
|
occupation_name
|
string
nullable
O*NET occupation name matching the code for this job opening.
"Dentists, General"
|
salary
|
string
nullable
Raw salary string.
"£40000 - £50000 GBP"
|
salary_data
|
object
Parsed raw salary data. |
salary_low
|
number
nullable
Salary range lower bound. If salary is not a range both low and high values will be the same. |
salary_high
|
number
nullable
Salary range upper bound. |
salary_currency
|
string
nullable
Salary currency. |
salary_low_usd
|
number
nullable
Salary range lower bound, converted to USD. |
salary_high_usd
|
number
nullable
Salary range upper bound, converted to USD. |
salary_time_unit
|
string
nullable
Salary time unit.
"hour", "day", "week", "month", "year", null
|
seniority
|
string
nullable
Seniority inferred from the job opening title. |
status
|
string
nullable
null or "closed" if keyword "job no longer available", "vacancy listing expired", "position filled", etc. is found on job opening site.
"closed", null
|
language
|
string
nullable
Language in which a job opening description is written. |
location
|
string
nullable
Raw location string. |
location_data
|
array
|
LocationData
|
object
|
city
|
string
nullable
|
state
|
string
nullable
|
zip_code
|
string
nullable
|
country
|
string
nullable
|
region
|
string
nullable
|
continent
|
string
nullable
|
fuzzy_match
|
boolean
nullable
|
tags
|
array
Includes keywords found under job opening description. |
Items
|
string
|
relationships
|
object
Contains references to related objects listed in property "included". |
company
|
object
|
data
|
object
|
id
|
|
type
|
|
included
|
array
Contains objects referenced in property "relationships". |
CompanyLite
|
object
|
id
|
string
PredictLeads ID of the CompanyLite object.
uuid
|
type
|
string
Type of the CompanyLite object.
"company"
|
attributes
|
object
|
domain
|
string
Company domain name. |
ticker
|
string
nullable
Company stock symbol (ticker) if available. |
company_name
|
string
nullable
Company name if available. |
meta
|
object
Meta information about response. Only shown in API responses. |
count
(optional)
|
integer
Total number of results.
|
message
(optional)
|
string
Additional information about response. |
message_type
(optional)
|
string
Type of the message.
"accepted"
|
redirects_to_domain
|
string
nullable
Domain that this company domain redirects to. |
parent_company_domain
|
string
nullable
Parent company domain. |
News Events are categorized events found in News Articles from various sources such as press releases, industry news, blogs and PR sites.
All events are provided in a structured format for all categories and always include company domain name to which the News Event belongs.
Because of the structured nature the News Events are better deduplicated and there is high signal to noise ratio.
News Event signals also include News Article title, body, author and more.
NewsEventsDataset
|
object
|
|
data
|
array
|
|
NewsEvent
|
object
|
|
id
|
string
PredictLeads ID of the NewsEvent object.
uuid
|
|
type
|
string
Type of the NewsEvent object.
"news_event"
|
|
attributes
|
object
|
|
summary
|
string
A short, human readable excerpt of this event data. |
|
category
|
string
Name of the category this event represents.
"hires", "retires_from", "leaves", "promotes", "receives_financing", "goes_public", "invests_into", "acquires", "opens_new_location", "recognized_as", "receives_award", "partners_with", "merges_with", "launches", "is_developing", "integrates_with", "expands_offices_to", "expands_offices_in", "signs_new_client", "sells_assets_to", "invests_into_assets", "expands_facilities", "increases_headcount_by", "decreases_headcount_by", "closes_offices_in", "files_suit_against", "has_issues_with", "identified_as_competitor_of"
"invests_into"
|
|
found_at
|
string
ISO 8601 date when the event was discovered and created. |
|
confidence
|
number
Floating point number of confidence between 0 and 1. Currently PredictLeads takes care of limiting the News Events so as to have a good balance between match rate and accuracy. Thus we do not... Floating point number of confidence between 0 and 1. Currently PredictLeads takes care of limiting the News Events so as to have a good balance between match rate and accuracy. Thus we do not recommend filtering News Events further based on this confidence. |
|
article_sentence
|
string
Sentence in the News Article where event information was found. |
|
human_approved
|
boolean
If true, this event has been manually verified by a human. |
|
planning
|
boolean
When true, the event is planned to happen. E.g. the company might plan to launch a product in December. |
|
amount
|
string
nullable
This is a string of a value as extracted from text.
"$1.8 million"
|
|
amount_normalized
|
integer
nullable
Integer value of "amount" property.
18000000
|
|
assets
|
string
nullable
Assets found in the News Event.
"hydrogen production facility"
|
|
assets_tags
|
array
An array of assets tags extracted from "assets" property.
[ "production" ]
|
|
Items
|
string
|
|
award
|
string
nullable
Award type this event is announcing.
"Pierre Potier Award"
|
|
contact
|
string
nullable
Person name that the News Event mentions.
"Elon Musk"
|
|
conference
|
string
nullable
Conference name where the News Event was mentioned at.
"World Business Outlook Awards"
|
|
effective_date
|
string
nullable
ISO 8601 date (without time) the News Event is mentioning, in string format.
"2024-04-05"
|
|
division
|
string
nullable
Whether event concerns a specific division. |
|
financing_type
|
string
nullable
A financing type this event is mentioning.
"Series B funding"
|
|
financing_type_normalized
|
string
nullable
A normalized value of "financing_type" property, where possible.
"pre_angel", "angel", "angel1", "angel2", "angel3", "pre_seed", "seed", "seed1", "seed2", "seed3", "pre_series_a", "series_a", "series_a1", "series_a2", "series_a3", "pre_series_b", "series_b", "series_b1", "series_b2", "series_b3", "pre_series_c", "series_c", "series_c1", "series_c2", "series_c3", "pre_series_d", "series_d", "series_d1", "series_d2", "series_d3", "pre_series_e", "series_e", "series_e1", "series_e2", "series_e3", "pre_series_f", "series_f", "series_f1", "series_f2", "series_f3", "pre_series_g", "series_g", "series_g1", "series_g2", "series_g3", "pre_series_h", "series_h", "series_h1", "series_h2", "series_h3", "pre_series_i", "series_i", "series_i1", "series_i2", "series_i3", "pre_series_j", "series_j", "series_j1", "series_j2", "series_j3", null
"series_b"
|
|
financing_type_tags
|
array
An array of financing type categories.
[ "equity" ]
|
|
Items
|
string
|
|
headcount
|
integer
nullable
A number of people mentioned organization is involved with.
200
|
|
job_title
|
string
nullable
Job title this event is mentioning.
"Director of Media and Analytics"
|
|
job_title_tags
|
array
An array of job title tags.
[ "marketing", "directors" ]
|
|
Items
|
string
|
|
location
|
string
nullable
Location of where the event happened or where the organization has expanded/relocated.
"Menlo Park, California, United States"
|
|
location_data
|
array
|
|
LocationData
|
object
|
|
city
|
string
nullable
|
|
state
|
string
nullable
|
|
zip_code
|
string
nullable
|
|
country
|
string
nullable
|
|
region
|
string
nullable
|
|
continent
|
string
nullable
|
|
fuzzy_match
|
boolean
nullable
|
|
product
|
string
nullable
Name of the product as mentioned by this event.
"Credit Pass"
|
|
product_data
|
object
|
|
full_text
|
string
nullable
Full product name as recognized by Named Entity Recognition, without further cleaning of the product name.
"Plant Control System", "3D printing service...
"Plant Control System", "3D printing service for spare parts"
|
|
name
|
string
nullable
Cleaned name of the product referenced in the News Event.
"VideoPoet"
|
|
release_type
|
string
nullable
Product release type.
"major"
|
|
release_version
|
string
nullable
Product release version.
"v3.0"
|
|
fuzzy_match
|
boolean
nullable
When true we might not have extracted the product name cleanly. When false exact product name should be extracted well. |
|
product_tags
|
array
List of tags regarding the product.
[ "mobile", "online_technology" ]
|
|
Items
|
string
|
|
recognition
|
string
nullable
Name of the recognition the company received.
"50 Smartest Companies"
|
|
vulnerability
|
string
nullable
Company issue.
"account suspension errors"
|
|
relationships
|
object
Contains references to related objects listed in property "included". |
|
company1
|
object
|
|
data
|
object
|
|
id
|
||
type
|
||
company2
|
object
|
|
data
|
object
|
|
id
|
||
type
|
||
most_relevant_source
|
object
|
|
data
|
object
|
|
id
|
||
type
|
||
included
|
array
Contains objects referenced in property "relationships". |
|
Items
|
|
|
One of
|
"type"
|
|
CompanyLite
|
object
|
|
id
|
string
PredictLeads ID of the CompanyLite object.
uuid
|
|
type
|
string
Type of the CompanyLite object.
"company"
|
|
attributes
|
object
|
|
domain
|
string
Company domain name. |
|
ticker
|
string
nullable
Company stock symbol (ticker) if available. |
|
company_name
|
string
nullable
Company name if available. |
|
or
|
||
NewsArticleLite
|
object
|
|
id
|
string
PredictLeads ID of the NewsArticleLite object.
uuid
|
|
type
|
string
Type of the NewsArticleLite object.
"news_article"
|
|
attributes
|
object
|
|
url
|
string
News Article source URL.
uri
|
|
title
|
string
Prettified News Article title or heading. |
|
author
|
string
nullable
News Article author name. |
|
image_url
|
string
nullable
News Article most relevant image URL. |
|
published_at
|
string
ISO 8601 date when News Article was published.
date-time
|
|
body
|
string
News Article text (article content). |
|
meta
|
object
Meta information about response. Only shown in API responses. |
|
count
(optional)
|
integer
Total number of results.
|
|
message
(optional)
|
string
Additional information about response. |
|
message_type
(optional)
|
string
Type of the message.
"accepted"
|
|
redirects_to_domain
|
string
nullable
Domain that this company domain redirects to. |
|
parent_company_domain
|
string
nullable
Parent company domain. |
Technologies are detected on websites and jobs related posts.
TechnologiesDataset
|
object
|
data
|
array
|
Technology
|
object
|
id
|
string
PredictLeads ID of the Technology object.
uuid
|
type
|
string
Type of the Technology object.
"technology"
|
attributes
|
object
|
name
|
string
|
description
|
string
nullable
|
categories
|
array
|
Items
|
string
|
parent_categories
|
array
|
Items
|
string
|
domain
|
string
nullable
|
url
|
string
nullable
uri
|
pricing_data
|
object
|
min_usd
|
number
nullable
|
max_usd
|
number
nullable
|
interval
|
string
nullable
|
tags
|
array
|
Items
|
string
|
created_at
|
string
date-time
|
relationships
|
object
Contains references to related objects listed in property "included". |
company
|
object
|
data
|
object
|
id
|
|
type
|
|
included
|
array
Contains objects referenced in property "relationships". |
CompanyLite
|
object
|
id
|
string
PredictLeads ID of the CompanyLite object.
uuid
|
type
|
string
Type of the CompanyLite object.
"company"
|
attributes
|
object
|
domain
|
string
Company domain name. |
ticker
|
string
nullable
Company stock symbol (ticker) if available. |
company_name
|
string
nullable
Company name if available. |
meta
(optional)
|
object
Meta information about response. Only shown in API responses. |
count
(optional)
|
integer
Total number of results.
|
message
(optional)
|
string
Additional information about response. |
message_type
(optional)
|
string
Type of the message.
"accepted"
|
Technology detections provide insight into tech stacks of companies.
Detections are sourced from company websites and from job opening descriptions.
Each detection is also enriched with company and technology information which includes technology
description, technology category, pricing and more.
TechnologyDetectionsDataset
|
object
|
|
data
|
array
|
|
TechnologyDetection
|
object
|
|
id
|
string
PredictLeads ID of the TechnologyDetection object.
uuid
|
|
type
|
string
Type of the TechnologyDetection object.
"technology_detection"
|
|
attributes
|
object
|
|
first_seen_at
|
string
date-time
|
|
last_seen_at
|
string
date-time
|
|
behind_firewall
|
boolean
|
|
score
|
number
|
|
relationships
|
object
Contains references to related objects listed in property "included". |
|
company
|
object
|
|
data
|
object
|
|
id
|
||
type
|
||
seen_on_job_openings
|
object
|
|
data
|
array
|
|
Items
|
object
|
|
id
|
||
type
|
||
seen_on_subpages
|
object
|
|
data
|
array
|
|
Items
|
object
|
|
id
|
||
type
|
||
technology
|
object
|
|
data
|
object
|
|
id
|
||
type
|
||
included
|
array
Contains objects referenced in property "relationships". |
|
Items
|
|
|
One of
|
"type"
|
|
CompanyLite
|
object
|
|
id
|
string
PredictLeads ID of the CompanyLite object.
uuid
|
|
type
|
string
Type of the CompanyLite object.
"company"
|
|
attributes
|
object
|
|
domain
|
string
Company domain name. |
|
ticker
|
string
nullable
Company stock symbol (ticker) if available. |
|
company_name
|
string
nullable
Company name if available. |
|
or
|
||
TechnologyLite
|
object
|
|
id
|
string
PredictLeads ID of the TechnologyLite object.
uuid
|
|
type
|
string
Type of the TechnologyLite object.
"technology"
|
|
attributes
|
object
|
|
name
|
string
|
|
or
|
||
DetectionOnSubpage
|
object
|
|
id
|
string
PredictLeads ID of the DetectionOnSubpage object.
uuid
|
|
type
|
string
Type of the DetectionOnSubpage object.
"detection_on_subpage"
|
|
attributes
|
object
|
|
first_seen_at
|
string
date-time
|
|
last_seen_at
|
string
date-time
|
|
subpage_url
|
string
uri
|
|
or
|
||
JobOpeningLite
|
object
|
|
id
|
string
PredictLeads ID of the JobOpeningLite object.
uuid
|
|
type
|
string
Type of the JobOpeningLite object.
"job_opening"
|
|
attributes
|
object
|
|
first_seen_at
|
string
Time & date (ISO 8601) of when the job opening was first seen.
date-time
|
|
last_seen_at
|
string
Time & date (ISO 8601) of when the job opening was last seen.
date-time
|
|
url
|
string
URL of the web page where the data was found.
uri
|
|
meta
|
object
Meta information about response. Only shown in API responses. |
|
count
(optional)
|
integer
Total number of results.
|
|
message
(optional)
|
string
Additional information about response. |
|
message_type
(optional)
|
string
Type of the message.
"accepted"
|
|
redirects_to_domain
|
string
nullable
Domain that this company domain redirects to. |
|
parent_company_domain
|
string
nullable
Parent company domain. |
Provides information on how a given website has been evolving.
This dataset tracks when certain subpages like "about us", "blog", "careers", "api docs",
"customer support"... pages have been added. The more subpages a given company adds in a shorter time
frame, normally the faster its progress. One could also segment companies based on the categories of
subpages they have.
WebsiteEvolutionDataset
|
object
|
data
|
array
|
Subpage
|
object
|
id
|
string
PredictLeads ID of the Subpage object.
uuid
|
type
|
string
Type of the Subpage object.
"subpage"
|
attributes
|
object
|
url
|
string
Subpage URL.
uri
|
first_seen_at
|
string
Time & date (ISO 8601) of when the subpage was first seen.
date-time
|
last_seen_at
|
string
Time & date (ISO 8601) of when the subpage was last seen.
date-time
|
category
|
string
Subpage category. |
text_content
|
string
nullable
Text content from the subpage. Sentences are contextually separated with new lines (\n). |
relationships
|
object
Contains references to related objects listed in property "included". |
company
|
object
|
data
|
object
|
id
|
|
type
|
|
included
|
array
Contains objects referenced in property "relationships". |
CompanyLite
|
object
|
id
|
string
PredictLeads ID of the CompanyLite object.
uuid
|
type
|
string
Type of the CompanyLite object.
"company"
|
attributes
|
object
|
domain
|
string
Company domain name. |
ticker
|
string
nullable
Company stock symbol (ticker) if available. |
company_name
|
string
nullable
Company name if available. |
meta
|
object
Meta information about response. Only shown in API responses. |
count
(optional)
|
integer
Total number of results.
|
message
(optional)
|
string
Additional information about response. |
message_type
(optional)
|
string
Type of the message.
"accepted"
|
redirects_to_domain
|
string
nullable
Domain that this company domain redirects to. |
parent_company_domain
|
string
nullable
Parent company domain. |
GitHub repositories gives insight into how frequently a website is contributing to its public GitHub repository.
GithubRepositoriesDataset
|
object
|
|
data
|
array
|
|
GithubRepository
|
|
|
attributes
|
object
|
|
url
|
string
Url to GitHub repository.
uri
|
|
description
|
string
nullable
Description of GitHub repository. |
|
first_seen_at
|
string
ISO 8601 date when the GitHub repository was discovered.
date-time
|
|
relationships
|
object
Contains references to related objects listed in property "included". |
|
company
|
object
|
|
data
|
object
|
|
id
|
||
type
|
||
timeseries_datapoints
|
object
|
|
data
|
array
|
|
Items
|
object
|
|
id
|
||
type
|
string
Type of the included TimeseriesDatapointGithubRepository object.
"timeseries_datapoint"
|
|
included
|
array
Contains objects referenced in property "relationships". |
|
Items
|
|
|
One of
|
"type"
|
|
CompanyLite
|
object
|
|
id
|
string
PredictLeads ID of the CompanyLite object.
uuid
|
|
type
|
string
Type of the CompanyLite object.
"company"
|
|
attributes
|
object
|
|
domain
|
string
Company domain name. |
|
ticker
|
string
nullable
Company stock symbol (ticker) if available. |
|
company_name
|
string
nullable
Company name if available. |
|
or
|
||
TimeseriesDatapointGithubRepository
|
object
|
|
id
|
string
PredictLeads ID of the TimeseriesDatapointGithubRepository object.
uuid
|
|
type
|
string
Type of the TimeseriesDatapointGithubRepository object.
"timeseries_datapoint"
|
|
attributes
|
object
|
|
timestamp
|
string
ISO 8601 date when data was detected.
date-time
|
|
data
|
object
|
|
forks
|
integer
Number of times this repository was forked at the creation of this datapoint. |
|
stars
|
integer
Number of times this repository was starred at the creation of this datapoint. |
|
watches
|
integer
Number of GitHub profiles that were watching this repository at the creation of this datapoint. |
|
last_update_at
|
string
ISO 8601 date of the last update to the repository at the creation of this datapoint.
date-time
|
|
meta
|
object
Meta information about response. Only shown in API responses. |
|
count
(optional)
|
integer
Total number of results.
|
|
message
(optional)
|
string
Additional information about response. |
|
message_type
(optional)
|
string
Type of the message.
"accepted"
|
|
redirects_to_domain
|
string
nullable
Domain that this company domain redirects to. |
|
parent_company_domain
|
string
nullable
Parent company domain. |
Our API is RESTful with responses delivered in JSON format.
For easier implementation, we provide API description also in OpenAPI schema (version 3.1.0) JSON format and OpenAPI SwaggerUI playground.
In order to use our API, you must first sign up to get an authentication token.
You can see live status of our API services.
If you would like to receive data as Flat Files or via Webhooks, please get in touch with our sales.
Authentication is done via the authentication token which you can find on your subscription plans page.
In order to use the API you need to call an endpoint URL with both your API token and API key.
The primary and recommended method for authenticating with PredictLeads is to specify the API key in the HTTP request header using an extended header field.
Each account using the API has request limits implemented. The amount of requests one can do each month is limited by the chosen plan. You can track your monthly usage on your subscription plans page.
Once the account reaches the limit, all further requests will produce a 403 HTTP error, notifying the user of the reached limit. If you have any further questions regarding the limits, feel free to contact us via support.
Responses with a list of objects are paginated. Use page
parameter to get more results. Total number of all possible results is displayed inside meta
attributes as count
.
To validate whether the webhook came from PredictLeads, we suggest verifying the webhook payloads with the X-Predict-Signature header (which we pass with every webhook).
Header payload is a SHA1 HMAC hexdigest computed with your token and the raw body of the request.
Whenever we find a new data for one of the companies you are tracking, we wll send a POST request to your general Webhook URL with the object.
Go to your subscription plans page to enter your Webhook URL.
Returns followed companies.
Query Parameters | |||
page
(optional)
|
integer
Page number of shown items.
1
1
|
||
limit
(optional)
|
integer
Limit the number of shown items per page.
100
1000
|
Follow the company.
Path Parameters | |||
domain
|
string
Company's domain. |
Unfollow the company.
Path Parameters | |||
domain
|
string
Company's domain. |
Returns Company.
Path Parameters | |||
domain
|
string
Company's domain. |
||
Query Parameters | |||
page
(optional)
|
integer
Page number of shown items.
1
1
|
||
limit
(optional)
|
integer
Limit the number of shown items per page.
100
1000
|
Returns a list of company's News Events.
Path Parameters | |||
domain
|
string
Company's domain. |
||
Query Parameters | |||
page
(optional)
|
integer
Page number of shown items.
1
1
|
||
limit
(optional)
|
integer
Limit the number of shown items per page.
100
1000
|
Returns specific News Event.
Path Parameters | |||
id
|
uuid
News Event's id. |
Returns a list of company's Financing Events.
Path Parameters | |||
domain
|
string
Company's domain. |
||
Query Parameters | |||
page
(optional)
|
integer
Page number of shown items.
1
1
|
||
limit
(optional)
|
integer
Limit the number of shown items per page.
100
1000
|
Returns a list of company's Job Openings.
Path Parameters | |||
domain
|
string
Company's domain. |
||
Query Parameters | |||
categories
(optional)
|
array
Comma-separated (,) Job Opening categories. |
||
Items
|
string
"none", "administration", "chairmen", "health_care", "hospitality", "engineering", "education", "maintenance", "finance", "information_technology", "management", "operations", "partnerships", "human_resources", "publishing", "purchasing", "sales", "marketing", "transportation", "directors", "design", "software_development", "general_technology", "support", "data_analysis"
|
||
with_job_descriptions
(optional)
|
boolean
Set to true if you'd like returned Job Openings to include their descriptions. |
||
active_only
(optional)
|
boolean
Set to true if you'd like to receive Job Openings that are not closed, have last_seen_at more recent than 5 days and were found in the last year. |
||
not_closed
(optional)
|
boolean
Similar to |
||
first_seen_at_from
(optional)
|
string
Only return Job Openings first seen after given date.
date
|
||
first_seen_at_until
(optional)
|
string
Only return Job Openings first seen before given date.
date
|
||
last_seen_at_from
(optional)
|
string
Only return Job Openings last seen after given date.
date
|
||
last_seen_at_until
(optional)
|
string
Only return Job Openings last seen before given date.
date
|
||
with_description_only
(optional)
|
boolean
Only return Job Openings that have description. |
||
with_location_only
(optional)
|
boolean
Only return Job Openings that have location. |
||
page
(optional)
|
integer
Page number of shown items.
1
1
|
||
limit
(optional)
|
integer
Limit the number of shown items per page.
100
1000
|
Returns a single Job Opening.
Path Parameters | |||
id
|
uuid
Job Opening's id. |
Returns a list of Technologies ordered by creation date ascending.
Query Parameters | |||
page
(optional)
|
integer
Page number of shown items.
1
1
|
||
limit
(optional)
|
integer
Limit the number of shown items per page.
100
1000
|
Returns a single Technology.
Path Parameters | |||
id
|
uuid
Technology's id. |
Returns a list of Technologies ordered by creation date descending.
Query Parameters | |||
page
(optional)
|
integer
Page number of shown items.
1
1
|
||
limit
(optional)
|
integer
Limit the number of shown items per page.
100
1000
|
Returns a list of company's Technology Detections.
Path Parameters | |||
domain
|
string
Company's domain. |
||
Query Parameters | |||
page
(optional)
|
integer
Page number of shown items.
1
1
|
||
limit
(optional)
|
integer
Limit the number of shown items per page.
100
1000
|
Returns a single Technology Detection.
Path Parameters | |||
id
|
uuid
Technology Detection's id. |
Returns a list of Technology Detections for a given Technology ID, ordered by date found, descending.
Path Parameters | |||
id
|
uuid
Technology's id. |
||
Query Parameters | |||
page
(optional)
|
integer
Page number of shown items.
1
1
|
||
limit
(optional)
|
integer
Limit the number of shown items per page.
100
1000
|
Returns a list of company's Connections.
Path Parameters | |||
domain
|
string
Company's domain. |
||
Query Parameters | |||
page
(optional)
|
integer
Page number of shown items.
1
1
|
||
limit
(optional)
|
integer
Limit the number of shown items per page.
100
1000
|
Returns a list of company's Website Evolution.
Path Parameters | |||
domain
|
string
Company's domain. |
||
Query Parameters | |||
page
(optional)
|
integer
Page number of shown items.
1
1
|
||
limit
(optional)
|
integer
Limit the number of shown items per page.
100
1000
|
Returns a list of company's Github Repositories.
Path Parameters | |||
domain
|
string
Company's domain. |
||
Query Parameters | |||
page
(optional)
|
integer
Page number of shown items.
1
1
|
||
limit
(optional)
|
integer
Limit the number of shown items per page.
100
1000
|