Introduction
The PredictLeads API is used to discover net-new companies or enrich existing company profiles with insights. Use cases range from enriching CRM with account intelligence, lead generation using buying signals and identifying top performing companies for investment purposes.
Our API is RESTful with responses delivered in JSON or XML format. Data can also be delivered as flat files, via APIs or Webhooks.
In order to use our API, you must first register with PredictLeads to get an authentication token.
You can see live status of our API services here
If you would like to receive data as flat files or via webhooks, please get in touch with our sales.
Authentication
Authentication using Authorization header.
curl "https://predictleads.com/api/v2/followings" \
-H 'X-User-Email: <email>' \
-H 'X-User-Token: <token>'
Alternatively pass email and token in query parameters.
curl "https://predictleads.com/api/v2/followings \
?user_token={token}&user_email={email}"
Authentication is done via the authentication token which you can find on Your subscription page.
In order to use the API you need to call an endpoint URL with both your API token and chosen email.
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. In all the examples, we’ll use the header authentication model.
Pagination
curl -X GET "https://predictleads.com/api/v2/discover/startup_platform/show_hn?page=2" \
-H 'X-User-Email: <email>' \
-H 'X-User-Token: <token>'
Responses with a list of objects (like GET /startup_platform_posts/show_hn) are paginated. Use page
parameter to get more results.
Total number of all possible results is displayed inside meta
attributes as count
.
{
"data": [{...}],
"meta": {
"count": 10
}
}
Webhooks
Example data we’ll POST to your Webhook.
{
"data": [
{
"id": "41e1f820-9e0f-46b3-a2e0-49dbe4175859",
"type": "event",
"attributes": {
"categories": [
"hires"
],
"title": "Domo, Inc. hires Vita Shannon as vice president of demand center",
"found_at": "2021-03-01T16:15:12Z",
"url": "https://aithority.com/it-and-devops/cloud/domo-invests-for-growth-welcoming-new-executives-to-lead-companys-demand-engines/",
"additional_data": {
"contact": "Vita Shannon",
"job_title": "vice president of demand center",
"article_title": "Domo Invests for Growth, Welcoming New Executives to Lead Company’s Demand Engines",
"article_sentence": "Vita Shannon joins Domo from KPMG as vice president of partnerships and ecosystem, and Shelley Morrison joins from Accenture Interactive as Domo’s vice president of demand center.",
"article_body": "Domo announced that it has welcomed two new executives to support and accelerate its growth initiatives. Vita Shannon joins Domo from KPMG as vice president of partnerships and ecosystem, and Shelley Morrison joins from Accenture Interactive as Domo’s vice president of demand center. “I’m thrilled to welcome Vita and Shelley and their global expertise in growth strategies and execution to our team,” said Josh James, founder and CEO, Domo. “The need for speed in putting data to work has never been more important and I’m looking forward to building on our business momentum with the addition of these proven executives.” Shannon brings years of experience in business development and partner strategy, most recently serving as the senior director of advisory services at KPMG.",
"article_source": "aithority.com",
"article_published_at": "2021-03-01T17:15:12.000Z",
"confidence": "0.7243"
}
},
"relationships": {
"company1": {
"data": {
"id": "1422300",
"type": "company"
}
}
}
}
],
"included": [
{
"id": "1422300",
"type": "company",
"attributes": {
"domain": "domo.com",
"company_name": "Domo, Inc.",
"ticker": null
}
},
...
],
"meta": {
"followed_company_ids": [
"1422300"
]
}
}
{
"data": [
{
"id": "e18484de-8f68-4dec-8403-03df2b315321",
"type": "job_opening",
"attributes": {
"title": "Full Stack Engineer",
"url": "https://www.ycombinator.com/companies/terra/jobs/3NbdZp6-full-stack-engineer",
"salary": "$50000 - $120000",
"salary_data": {
"salary_low": 50000.0,
"salary_high": 120000.0,
"salary_currency": "USD",
"salary_low_usd": 50000.0,
"salary_high_usd": 120000.0,
"salary_time_unit": "year"
},
"contract_types": [
"full time"
],
"first_seen_at": "2021-08-02T03:36:38Z",
"last_seen_at": "2021-10-30T06:52:51Z",
"last_processed_at": "2021-10-30T06:52:51Z",
"job_opening_closed": false,
"location": "London, England, United Kingdom",
"categories": [
"engineering",
"software_development"
],
"additional_data": {
"job_title_seniority": null,
"tags": [
"Growth",
"Customer success",
"Android",
"Node.js",
"PHP",
"Python",
"Ruby",
"Flask",
"Stripe",
"Cloudflare CDN",
"Doppler",
"Onesignal",
"Taplytics",
"Workramp"
],
"location_data": {
"country": "United Kingdom",
"city": "London",
"fuzzy_match": false
}
}
},
"relationships": {
"company": {
"data": {
"id": "1487151",
"type": "company"
}
}
}
}
],
"included": [
{
"id": "1487151",
"type": "company",
"attributes": {
"domain": "tylertech.com",
"company_name": "Tyler Technologies Inc",
"ticker": "NYSE:TYL"
}
},
...
]
}
{
"data": [
{
"id": "86816ac0-e43f-42b0-82d9-720b22dc7c78",
"type": "connection",
"attributes": {
"category": "parent",
"source_category": "domain_redirect",
"source_url": null,
"first_seen_at": "2021-03-04T11:56:04Z",
"last_seen_at": "2021-03-04T11:56:04Z"
},
"relationships": {
"company1": {
"data": {
"id": "324979",
"type": "company"
}
},
"company2": {
"data": {
"id": "18612203",
"type": "company"
}
}
}
}
],
"included": [
{
"id": "324979",
"type": "company",
"attributes": {
"domain": "saucony.com",
"company_name": "Saucony, Inc.",
"ticker": null
}
},
...
],
"meta": {
"followed_company_ids": [
"324979"
]
}
}
Example data we’ll POST to Segment Webhook URL.
{
"data": [
{
"id": "41e1f820-9e0f-46b3-a2e0-49dbe4175859",
"type": "event",
"attributes": {
"categories": [
"hires"
],
"title": "Domo, Inc. hires Vita Shannon as vice president of demand center",
"found_at": "2021-03-01T16:15:12Z",
"url": "https://aithority.com/it-and-devops/cloud/domo-invests-for-growth-welcoming-new-executives-to-lead-companys-demand-engines/",
"additional_data": {
"contact": "Vita Shannon",
"job_title": "vice president of demand center",
"article_title": "Domo Invests for Growth, Welcoming New Executives to Lead Company’s Demand Engines",
"article_sentence": "Vita Shannon joins Domo from KPMG as vice president of partnerships and ecosystem, and Shelley Morrison joins from Accenture Interactive as Domo’s vice president of demand center.",
"article_body": "Domo announced that it has welcomed two new executives to support and accelerate its growth initiatives. Vita Shannon joins Domo from KPMG as vice president of partnerships and ecosystem, and Shelley Morrison joins from Accenture Interactive as Domo’s vice president of demand center. “I’m thrilled to welcome Vita and Shelley and their global expertise in growth strategies and execution to our team,” said Josh James, founder and CEO, Domo. “The need for speed in putting data to work has never been more important and I’m looking forward to building on our business momentum with the addition of these proven executives.” Shannon brings years of experience in business development and partner strategy, most recently serving as the senior director of advisory services at KPMG.",
"article_source": "aithority.com",
"article_published_at": "2021-03-01T17:15:12.000Z",
"confidence": "0.7243"
}
},
"relationships": {
"company1": {
"data": {
"id": "1422300",
"type": "company"
}
}
}
}
],
"included": [
{
"id": "1422300",
"type": "company",
"attributes": {
"domain": "domo.com",
"company_name": "Domo, Inc.",
"ticker": null
}
}
],
"meta": {
"followed_company_ids": [
"1422300"
]
}
}
Webhooks enable our customers to receive data on a continuous basis without the need to issue unnecessary API requests.
If your server does not respond with a 200 OK (or 201, 202, 204) response within a 5 second window or responds with another error code (4XX, 5XX), we will consider the POST request faulty. We will retry the request until we detect that 5 out out of 50 requests in the last hour have had a non-OK response. After reaching this limit we will disable the webhook and send email messages notifying the user and our admins of this. When in this state the webhook has to be re-enabled manually and upon request we can provide some data on why the requests were failing. For any additional information about webhooks, you can write to our support email.
Signals
Whenever we find a new buying signal for one of the companies you’re tracking, we’ll send a POST request to your general Webhook URL with the Signal object. Go to Your subscription page to enter your general Webhook URL.
Companies
When creating a segment of companies you can set a Webhook URL optionally.
Every week we’ll send a POST request to that Webhook URL with new companies in your segment. Under relationships
we’ll include Signal objects corresponding to Segment parameters.
In case no new companies are found in your segment, we won’t send anything.
Webhook Authentication
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.
Errors
Our API returns standard HTTP success or error status codes. For errors, we also include extra information about what went wrong encoded in the response as JSON.
Status Code | Meaning | Counts towards limit |
---|---|---|
200 | SUCCESS - Request was successfully processed. | Yes |
400 | BAD REQUEST - Request message framing was invalid. The server cannot or will not process the request. | Yes |
401 | UNAUTHORIZED ACCESS - Authentication failed. Check again your credentials or contact us. | Yes |
403 | FORBIDDEN - Request rate over limit. | No |
404 | NOT FOUND - Specified company is not in our database. Check again in 24h. | Yes |
422 | UNPROCESSABLE ENTITY - Malformed domain name | Yes |
500 | INTERNAL SERVER ERROR – We had a problem with our server. Try again later. | No |
Request Limits
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 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.
Track
Track companies to receive buying signals data when found. We’ll issue a POST request with the data to your general Webhook URL. More on webhooks here.
Follow company
curl -X POST "https://predictleads.com/api/v2/companies/hubspot.com/follow" \
-H 'X-User-Email: <email>' \
-H 'X-User-Token: <token>'
Enables the authenticated user to follow the company specified with the company domain parameter.
{
"success": {
"type": "follow_successful",
"message": "Company with domain hubspot.com was successfully followed."
}
}
HTTP Request
POST https://predictleads.com/api/v2/companies/:domain/follow
Followed companies
curl -X GET "https://predictleads.com/api/v2/followings" \
-H 'X-User-Email: <email>' \
-H 'X-User-Token: <token>'
Returns a list of followed companies.
[
{"domain": "hubspot.com"},
{"domain": "clearbit.com"},
{"domain": "segment.com"},
{"domain": "outreach.com"},
...
]
HTTP Request
GET https://predictleads.com/api/v2/followings
Unfollow company
curl -X POST "https://predictleads.com/api/v2/companies/hubspot.com/unfollow" \
-H 'X-User-Email: <email>' \
-H 'X-User-Token: <token>'
Enables the authenticated user to unfollow the company specified with the domain parameter.
{
"success": {
"type": "unfollow_successful",
"message": "Company with domain hubspot.com was successfully unfollowed."
}
}
If you are trying to remove a company that is not followed, you will get the following response
{
"error": {
"type": "unfollow_unsuccessful",
"message": "Are you sure you're following this company? We couldn't find it in our database."
}
}
HTTP Request
POST https://predictleads.com/api/v2/companies/:domain/unfollow
Enrich
Access all recent signals for a given company by providing its domain. Each signal type has its own endpoint: /events, /job_openings and /technologies. Every call returns most recent 10 signals. In case the company isn’t in our database, the system will immediately start searching for signals and return them to the specified Webhook URL when finished. Alternatively, you can call the endpoint again in 48 hours.
Events
curl -X GET "https://predictleads.com/api/v2/companies/klasha.com/events" \
-H 'X-User-Email: <email>' \
-H 'X-User-Token: <token>'
Returns a list of events from news for a given company. Events are found in press releases, industry news, blogs and other text based media.
{
"data": [{
"id": "f096ea55-f81b-4f6a-83bd-d5c1cdc10143",
"type": "event",
"attributes": {
"categories": [
"expands_offices_in"
],
"title": "Klasha expands offices in Ghana",
"found_at": "2021-10-19T22:00:00Z",
"url": "https://www.electronicpaymentsinternational.com/news/company-news/",
"additional_data": {
"location": "Ghana",
"location_data": {
"country": "Ghana",
"fuzzy_match": false
},
"article_title": "Company news Archives",
"article_sentence": "San Francisco and Lagos-based cross-border technology company Klasha is further expanding its presence in Africa with the launch of its services in Ghana.",
"article_body": "Payfare, which offers banking solutions for gig workforce, has announced that it is integrating with Plaid, a data transfer network that powers fintech and digital finance products. The integration will… Technology company TraQiQ has introduced its online payment solution 'TraQPayments' in Latin America. TraQPayments is… American Express has partnered with Goldman Sachs Transaction Banking (TxB) to offer an integrated payments solution to large corporate clients. Barclaycard Payments and SAP is expanding their cooperation in a bid to boost payment acceptance capabilities and enhance procure-to-pay processes. UK-based fintech firm Previse has tapped Mastercard to provide instant payments to suppliers in more than 100 markets globally. Latin America-based payment processor PayRetailers has entered into an alliance with European payment giant Worldline. Buy now pay later (BNPL) firm Klarna has introduced ‘pay now’ option in the UK. Western Union International Bank (WUIB) has expanded its real-time payment capabilities in Europe by joining the Single Euro Payments Area (SEPA) Instant Credit Transfer scheme (SCT Inst). San Francisco and Lagos-based cross-border technology company Klasha is further expanding its presence in Africa with the launch of its services in Ghana.",
"article_source": "electronicpaymentsinternational.com",
"article_published_at": "2021-10-20T00:00:00.000Z",
"confidence": "0.6872"
}
},
"relationships": {}
},
...,
],
"meta": {
"count": 8
}
}
HTTP Request
GET https://predictleads.com/api/v2/companies/:domain/events
Request Parameters
Parameter | Description |
---|---|
categories |
string All event categories are listed below. Split by a comma (,). |
found_at_from |
date (ISO 8601) Signals found from specified date. |
found_at_until |
date (ISO 8601) Signals found until specified date. |
limit |
string Limit the number of shown events per page. Default is 30, maximum is 100. |
with_news_article_bodies |
boolean Set to true if you’d like news articles returned with their descriptions. |
List of event categories and more information on event object is available here.
To get more results use pagination.
Job openings
curl -X GET "https://predictleads.com/api/v2/companies/tryterra.co/job_openings" \
-H 'X-User-Email: <email>' \
-H 'X-User-Token: <token>'
Returns a list of job openings for a given company. Job openings are found on companies’ career sites and job boards.
{
"data": [{
"id": "e18484de-8f68-4dec-8403-03df2b315321",
"type": "job_opening",
"attributes": {
"title": "Full Stack Engineer",
"url": "https://www.ycombinator.com/companies/terra/jobs/3NbdZp6-full-stack-engineer",
"salary": "$50000 - $120000",
"salary_data": {
"salary_low": 50000.0,
"salary_high": 120000.0,
"salary_currency": "USD",
"salary_low_usd": 50000.0,
"salary_high_usd": 120000.0,
"salary_time_unit": "year"
},
"contract_types": [
"full time"
],
"first_seen_at": "2021-08-02T03:36:38Z",
"last_seen_at": "2021-10-30T06:52:51Z",
"last_processed_at": "2021-10-30T06:52:51Z",
"job_opening_closed": false,
"location": "London, England, United Kingdom",
"categories": [
"engineering",
"software_development"
],
"additional_data": {
"job_title_seniority": null,
"tags": [
"Growth",
"Customer success",
"Android",
"Node.js",
"PHP",
"Python",
"Ruby",
"Flask",
"Stripe",
"Cloudflare CDN",
"Doppler",
"Onesignal",
"Taplytics",
"Workramp"
],
"location_data": {
"country": "United Kingdom",
"city": "London",
"fuzzy_match": false
}
}
},
"relationships": {}
},
...,
],
"meta": {
"count": 16,
"total_jobs_count": 16
}
}
Job openings endpoint returns a number of jobs via "meta" > "count"
property.
The total number of jobs a company advertises you can get via "meta" > "total_jobs_count"
.
HTTP Request
GET https://predictleads.com/api/v2/companies/:domain/job_openings
Request Parameters
Parameter | Description |
---|---|
categories |
string All job opening categories are listed below. Split by a comma (,). |
with_job_descriptions |
boolean Set to true if you’d like jobs returned with their descriptions. |
active_only |
boolean Set to true if you’d like to receive jobs that are not closed and last_seen_at more recent than 3 weeks. |
limit |
string Limit the number of shown events per page. Default is 30, maximum is 100. |
List of job openings categories and more information on job opening object is available here.
To get more results use pagination.
Technologies
curl -X GET "https://predictleads.com/api/v2/companies/madkudu.com/technologies" \
-H 'X-User-Email: <email>' \
-H 'X-User-Token: <token>'
Returns a list of technology providers for a given company.
{
"data": [
{
"id": "344f5e7c-4dae-4814-8f45-ded70b2baa6a",
"type": "technology",
"attributes": {
"categories": [
"content_delivery_network"
],
"domain": "google.com",
"first_seen_at": "2022-12-08T10:40:41Z",
"last_seen_at": "2023-03-08T10:48:08Z",
"url": "https://developers.google.com/speed/libraries",
"title": "Google Hosted Libraries",
"behind_firewall": false,
"score": 0.5
},
"relationships": {
"company": {
"data": {
"id": "1595944",
"type": "company"
}
},
"seen_on_job_openings": {
"data": [
...
]
},
"seen_on_subpages": {
"data": [
{
"id": "093ad986-ab24-4a50-a9d9-0acf411dd50b",
"type": "subpages"
},
...,
]
}
}
},
...,
],
"included": [
{
"id": "093ad986-ab24-4a50-a9d9-0acf411dd50b",
"type": "subpage",
"attributes": {
"url": "https://www.madkudu.com",
"first_seen_at": "2018-07-09T21:35:33Z",
"last_seen_at": "2023-03-08T10:48:08Z"
}
},
...
],
"meta": {
"count": 29
}
}
HTTP Request
GET https://predictleads.com/api/v2/companies/:domain/technologies
Request Parameters
Parameter | Description |
---|---|
categories |
string All technology categories are listed below. Split by a comma (,). |
score |
float Technology confidence score tables can found below. |
limit |
string Limit the number of shown events per page. Default is 30, maximum is 100. |
List of technology categories and more information on technology object is available here.
Tables for technology confidence scores can be found here.
To get more results use pagination.
Connections
curl -X GET "https://predictleads.com/api/v2/companies/pipedrive.com/connections" \
-H 'X-User-Email: <email>' \
-H 'X-User-Token: <token>'
Returns a list of categorized business connections. Business connections can be found via backlinks or logos on /our-customers, /case-studies, /portfolio, /clients etc. pages. Business connections enable you to eg. calculate network health of a company, to build systems when new high value connections are made… Connections can be of many types: partner, vendor, investor, parent…
{
"data": [{
"id": "168d9d73-3a8b-492f-b5bc-35564a5ff1fe",
"type": "connection",
"attributes": {
"category": "vendor",
"source_category": "vendor_page",
"source_url": "https://funnel.io/customers",
"first_seen_at": "2021-08-23T09:08:38Z",
"last_seen_at": "2021-10-18T11:30:23Z"
},
"relationships": {
"company1": {
"data": {
"id": "1828101",
"type": "company"
}
},
"company2": {
"data": {
"id": "1464778",
"type": "company"
}
}
}
},
{
"id": "d76d778a-06be-470f-b7f2-937a81b4b7d5",
"type": "connection",
"attributes": {
"category": "partner",
"source_category": "partner_page",
"source_url": "https://1wirefiber.com",
"first_seen_at": "2021-07-15T10:50:55Z",
"last_seen_at": "2021-10-23T15:10:12Z"
},
"relationships": {
"company1": {
"data": {
"id": "4965363",
"type": "company"
}
},
"company2": {
"data": {
"id": "1464778",
"type": "company"
}
}
}
},
...,
],
"included": [{
"id": "1828101",
"type": "company",
"attributes": {
"domain": "funnel.io",
"company_name": "Funnel",
"ticker": null
}
},{
"id": "1464778",
"type": "company",
"attributes": {
"domain": "pipedrive.com",
"company_name": "Pipedrive, Inc.",
"ticker": null
}
},{
"id": "4965363",
"type": "company",
"attributes": {
"domain": "1wirefiber.com",
"company_name": "1Wire Communications",
"ticker": null
}
}
...,
],
"meta": {
"count": 83
}
}
HTTP Request
GET https://predictleads.com/api/v2/companies/:domain/connections
Request Parameters
Parameter | Description |
---|---|
categories |
string All connection categories are listed below. Split by a comma (,). |
limit |
string Limit the number of shown website subpages per page. Default is 30, maximum is 100. |
More information on the connection object is available here.
More information on the connection categories can be found here.
To get more results use pagination.
Website Evolution
curl -X GET "https://predictleads.com/api/v2/companies/snowflake.com/website_evolution" \
-H 'X-User-Email: <email>' \
-H 'X-User-Token: <token>'
Website Evolution gives insights to how website is chronologically developing eg. when pages like “Blog”, “Privacy policy”, “Pricing”, “Product”, “API Docs”, “Team”, “Support pages” etc. were added. This can serve as a proxy to how quickly a website is growing, to determine the growth stage they are at and also to help segment websites.
{
"data": [
{
"id": "00000000-0000-0000-0000-000020202026",
"type": "subpage",
"attributes": {
"category": "blog",
"url": "https://prisma.io/blog",
"first_seen_at": "2018-07-07T15:21:17.765+02:00",
"last_seen_at": "2019-10-19T12:45:24.804+02:00"
},
"relationships": {}
},
...
],
"meta": {
"count": 24
}
}
HTTP Request
GET https://predictleads.com/api/v2/companies/:domain/website_evolution
Request Parameters
Parameter | Description |
---|---|
limit |
string Limit the number of shown events per page. Default is 30, maximum is 100. |
More information on the website_evolution object is available here.
To get more results use pagination.
Github repositories
curl -X GET "https://predictleads.com/api/v2/companies/prisma.io/github_repositories" \
-H 'X-User-Email: <email>' \
-H 'X-User-Token: <token>'
GitHub repositories gives insight into how frequently a website is contributing to its public GitHub repository.
{
"data": [
{
"id": "0711177c-0dfd-4d09-b5fd-9e661a2f5503",
"type": "github_repository",
"attributes": {
"url": "https://github.com/prisma/cuid-java"
},
"relationships": {
"timeseries_datapoints": {
"data": [
{
"id": "7e1f240d-3977-4503-801a-83198467fe14",
"type": "timeseries_datapoint"
},
...
]
}
}
},
...
],
"included": [
{
"id": "7e1f240d-3977-4503-801a-83198467fe14",
"type": "timeseries_datapoint",
"attributes": {
"timestamp": "2021-03-04T10:07:11.006+01:00",
"data": {
"forks": 10,
"stars": 52,
"watches": 8,
"last_update_at": "2020-07-28T14:12:37Z"
}
}
},
...
],
"meta": {
"count": 24
}
}
HTTP Request
GET https://predictleads.com/api/v2/companies/:domain/github_repositories
Request Parameters
Parameter | Description |
---|---|
limit |
string Limit the number of shown events per page. Default is 30, maximum is 100. |
More information on the github_repository object is available here.
To get more results use pagination.
Products
curl -X GET "https://predictleads.com/api/v2/companies/accountablehq.com/products" \
-H 'X-User-Email: <email>' \
-H 'X-User-Token: <token>'
GitHub repositories gives insight into how frequently a website is contributing to its public GitHub repository.
{
"data": [
{
"id": "56452a8a-6c41-49a2-aed7-35c14043782d",
"type": "product",
"attributes": {
"name": "SSO/SAML",
"sources": [
"pricing"
],
"url": "https://www.accountablehq.com/pricing",
"first_seen_at": "2022-03-19T09:39:51Z",
"last_seen_at": "2022-03-19T09:39:51Z"
},
"relationships": {}
},
...
],
"included": [],
"meta": {
"count": 32
}
}
HTTP Request
GET https://predictleads.com/api/v2/companies/:domain/products
Request Parameters
Parameter | Description |
---|---|
limit |
string Limit the number of shown events per page. Default is 30, maximum is 100. |
sources |
string comma separated . |
More information on the product object is available here.
To get more results use pagination.
Company
curl -X GET "https://predictleads.com/api/v2/companies/hubspot.com/company" \
-H 'X-User-Email: <email>' \
-H 'X-User-Token: <token>'
Returns basic information about the company like company location, company name, ticker, meta description…
{
"data": [
{
"id": "1438333",
"type": "company",
"attributes": {
"domain": "hubspot.com",
"location": "California, United States",
"location_data": {
"state": "California",
"country": "United States"
},
"company_name": "HubSpot, Inc.",
"friendly_company_name": "HubSpot",
"ticker": "NYSE:HUBS",
"meta_title": "HubSpot | Software, Tools, Resources for Your Business",
"meta_description": "HubSpot's CRM platform contains the marketing, sales, service, operations, and website-building software you need to grow your business."
},
"relationships": {}
}
],
"included": [],
"meta": {}
}
DEPRECATION WARNING
On June 1st, 2023 we will deprecate the endpoint
GET https://predictleads.com/api/v2/companies/:domain/company
and replace it with
GET https://predictleads.com/api/v2/companies/:domain
HTTP Request
GET https://predictleads.com/api/v2/companies/:domain/company
Redirects
curl -X GET "https://predictleads.com/api/v2/discover/companies/close.io" \
-H 'X-User-Email: <email>' \
-H 'X-User-Token: <token>'
Sometimes companies undergo rebranding or get acquired and thus the domain of their website changes, which means we need to start tracking them as a different entity. This would be inconvenient if there were no link between the old and new company, which we solve with an extra field when querying the domain.
{
"data": [
{
"id": "1414950",
"type": "company",
"attributes": {
"domain": "close.io",
"location": null,
"location_data": null,
"company_name": "Close",
"friendly_company_name": "Close",
"ticker": null,
"meta_title": "Close CRM | Inside Sales Software CRM with Calling & Emailing",
"meta_description": "Close is the inside sales CRM of choice for startups and SMBs. Make more calls, send more emails and close more deals starting today."
},
"relationships": {
"redirects_to": {
"data": {
"id": "48402",
"type": "company"
},
"meta": {
"reason": "rebranding"
}
},
...
}
}
],
"included": [
{
"id": "48402",
"type": "company",
"attributes": {
"domain": "close.com",
"company_name": "Close CRM",
"ticker": null
}
},
...
{
"id": "b1be1ef8-d67c-4e9a-a417-f89483b803f8",
"type": "connection",
"attributes": {
"category": "rebranding",
"source_category": "domain_redirect",
"source_url": null,
"first_seen_at": "2022-03-02T17:53:04Z",
"last_seen_at": "2022-03-02T17:53:04Z"
},
"relationships": {
"company1": {
"data": {
"id": "48402",
"type": "company"
}
},
"company2": {
"data": {
"id": "1414950",
"type": "company"
}
}
}
},
...
]
}
Discover
Discover via StartupPlatform
curl -X GET "https://predictleads.com/api/v2/discover/startup_platform/latest" \
-H 'X-User-Email: <email>' \
-H 'X-User-Token: <token>'
Find companies that are hiring or launching new products via Hacker News (news.ycombinator.com) and similar platforms.
{
"data": [{
"id": "247825",
"type": "startup_platform_post",
"attributes": {
"published_at": "2020-08-12 00:24:30 +0200",
"post_type": "job_hn",
"post_url": "https://news.ycombinator.com/item?id=24126709",
"company_domain": "repl.it",
"company_name": "Repl",
"fuzzy_match": false
}
},
...
],
"meta": {
"count": 180013
}
}
curl -X GET "https://predictleads.com/api/v2/discover/startup_platform/jobs_hn" \
-H 'X-User-Email: <email>' \
-H 'X-User-Token: <token>'
{
"data": [{
"id": "247782",
"type": "startup_platform_post",
"attributes": {
"published_at": "2020-08-11 16:28:16 +0200",
"post_type": "job_hn",
"post_url": "https://news.ycombinator.com/item?id=24120589",
"company_domain": "forma.ai",
"company_name": "Forma AI, Inc.",
"fuzzy_match": false
}
},
...
],
"meta": {
"count": 65106
}
}
HTTP Request
GET https://predictleads.com/api/v2/discover/startup_platform/jobs_hn
HTTP Request
GET https://predictleads.com/api/v2/discover/startup_platform/show_hn
Returns companies that have posted in Show HN format on Hacker News.
Request Parameters
Parameter | Description |
---|---|
post_datetime_from |
date (ISO 8601) Found HN posts from specified date. |
post_datetime_until |
date (ISO 8601) Found HN posts from specified date. |
min_score |
date (ISO 8601) Minimum required HN score (Coming soon …). |
limit |
string Limit the number of shown events per page. Default is 30, maximum is 100. |
Segments
Returns a list of companies matching your segment criteria. Companies are sent on a periodic basis eg. weekly, bi-weekly, monthly.
Matching companies are sent onto segment webhook URL. If webhook URL is not set, companies are sent to your email.
Company segments enable you to personalize outreach and messaging. Leverage buying signals and identify new sets of companies. Eg.: you can create a segment of companies that use Salesforce and recently posted a job opening for iOS Developers.
Create segment
curl -X POST "https://predictleads.com/api/v2/segments"
-d '{"technologies":"Salesforce", "job_categories":"sales"}'
-H "Content-Type: application/json" \
-H 'X-User-Email: <email>' \
-H 'X-User-Token: <token>'
Creates a segment of companies with a set of query parameters.
{
"data": {
"id": "1093",
"type": "segment",
"attributes": {
"name": null,
"webhook_url": null,
"active": null,
"recurrence": "onetime",
"job_categories": [
"sales"
],
"locations": null,
"event_relationship_type_names": null,
"event_tags": null,
"found_at_from": "2021-03-29T15:18:37.237+02:00",
"found_at_until": null,
"technology_names": [
"Salesforce"
]
}
},
"meta": {
"message": "Segment successfully created.",
"message_type": "segment_created"
}
}
HTTP Request
POST https://predictleads.com/api/v2/segments
Request Parameters
Parameter | Description |
---|---|
webhook_url |
string We’ll send the data to this URL. |
locations |
string List of company locations separated by comma (,). Ie.: CA, FL, France. |
headquarters_locations |
string List of company headquarters locations separated by comma (,). Ie.: CA, FL, France. |
job_categories |
string List of job categories separated by comma (,). Ie.: marketing, education, software_development. |
technologies |
string List of technologies separated by comma (,). Ie.: Salesforce, Gitlab, Slack. |
found_at_from |
date (ISO 8601) Signals found from specified date. |
found_at_until |
date (ISO 8601) Signals found until specified date. |
active |
string Set to “false” to deactivate the segment. |
limit |
string Limit the number of shown events per page. Default is 10, maximum is 100. |
Use abbreviations for US states ie.: CA, FL and countries for other locations: Germany, China, Japan …
All /segment parameters can be used to create a segment.
List of job opening categories is available here.
For getting a list of technologies please contact us at founders@predictleads.com.
Sample segment Webhook payload
{
"data": [{
"id": "348068",
"type": "company",
"attributes": {
"domain": "boozallen.com",
"company_name": "Booz Allen Hamilton",
"friendly_company_name": "Booz Allen Hamilton",
"ticker": "NYSE:BAH"
}
},
...
],
"meta": {
"count": 21251
}
}
Returns a list of companies that satisfy given Segment parameters.
Update segment
curl -X PUT "https://predictleads.com/api/v2/segments/721"
-d '{"webhook_url":"https://requestb.in/2940cn"}'
-H "Content-Type: application/json" \
-H 'X-User-Email: <email>' \
-H 'X-User-Token: <token>'
Updates the segment.
{
"data": {
"id": "721",
"type": "segments",
"attributes": {
"name": null,
"webhook_url": "https://requestb.in/2940cn",
"active": true,
"recurrence": "onetime",
"job_categories": [
"Sales"
],
"locations": [
"United States"
],
"event_relationship_type_names": null,
"company_partnered_with_stock_exchange_company": null,
"company_not_on_stock_exchange": null,
"event_tags": null,
"found_at_from": null,
"found_at_until": null,
"technology_names": [
"Salesforce",
"Outreach.io"
]
},
"meta": {
"message": "Segment successfully updated.",
"message_type": "segment_updated"
}
}
}
HTTP Request
PUT https://predictleads.com/api/v2/segments/:id
Request Parameters
Parameter | Description |
---|---|
id |
string ID of the segment. |
webhook_url |
string We’ll send the data to this URL. |
active |
string Set to “false” to deactivate the segment. |
All /segment parameters can be used to update a segment.
Show segment
curl -X GET "https://predictleads.com/api/v2/segments/721"
-H "Content-Type: application/json" \
-H 'X-User-Email: <email>' \
-H 'X-User-Token: <token>'
Show segment attributes.
{
"data": {
"id": "1060",
"type": "segment",
"attributes": {
"name": null,
"webhook_url": null,
"active": true,
"recurrence": "onetime",
"job_categories": [
"Sales"
],
"locations": [
"United States"
],
"event_relationship_type_names": null,
"company_partnered_with_stock_exchange_company": null,
"company_not_on_stock_exchange": null,
"event_tags": null,
"found_at_from": null,
"found_at_until": null,
"technology_names": [
"Salesforce",
"Outreach.io"
]
}
}
}
HTTP Request
GET https://predictleads.com/api/v2/segments/:id
Show all segments
curl -X GET "https://predictleads.com/api/v2/segments"
-H "Content-Type: application/json" \
-H 'X-User-Email: <email>' \
-H 'X-User-Token: <token>'
Returns a list of all your segments.
{
"data": [{
"id": "1060",
"type": "segment",
"attributes": {
"name": null,
"webhook_url": null,
"active": true,
"recurrence": "onetime",
"job_categories": [
"Sales"
],
"locations": [
"United States"
],
"event_relationship_type_names": null,
"company_partnered_with_stock_exchange_company": null,
"company_not_on_stock_exchange": null,
"event_tags": null,
"found_at_from": null,
"found_at_until": null,
"technology_names": [
"Salesforce",
"Outreach.io"
]
}
},
...
]
}
HTTP Request
POST https://predictleads.com/api/v2/segments
Signal objects
Listed here are all types of returned signal objects.
Event
Examples of event objects
{
"data": [{
"id": "998e1763-8a7e-4ad8-836d-053d0d0c67ac",
"type": "event",
"attributes": {
"categories": [
"invests_into"
],
"title": "Greycroft Partners invests into Klasha, Inc. in $2.4M",
"found_at": "2021-10-13T02:21:50Z",
"url": "https://www.techinafrica.com/africa-cross-border-commerce-platform-klasha-raises-2-4m-expands-to-ghana/",
"additional_data": {
"location": "San Francisco, California, United States",
"location_data": {
"country": "United States",
"city": "San Francisco",
"fuzzy_match": false,
"state": "California"
},
"amount": 2400000,
"article_title": "Africa cross-border commerce platform Klasha raises $2.4M, expands to Ghana",
"article_sentence": "San Francisco and Nigeria-based Klasha has raised $2.4 million in a round led by Greycroft to scale its offering.",
"article_source": "techinafrica.com",
"article_published_at": "2021-10-13T04:21:50.000Z",
"confidence": "0.7269"
}
},
"relationships": {
"company1": {
"data": {
"id": "444790",
"type": "company"
}
},
"company2": {
"data": {
"id": "8333660",
"type": "company"
}
}
}
},,
...
],
"included": [
{
"id": "444790",
"type": "company",
"attributes": {
"domain": "greycroft.com",
"company_name": "Greycroft Partners",
"ticker": null
}
},
{
"id": "8333660",
"type": "company",
"attributes": {
"domain": "klasha.com",
"company_name": "Klasha, Inc.",
"ticker": null
}
},
],
"meta": {
"count": 9
}
}
Event signals are structured pieces of data found in press releases, news articles, blogs and other public documents.
Attribute | Description |
---|---|
id | UUID Unique signal identifier (unique across signal types). |
categories | array Type of the event - full list below. |
title | string Autogenerated title from the data. |
url | string Most relevant source URL. |
found_at | datetime Time & date (ISO 8601) of the published document. |
additional_data | hash Additional data regarding the signal. See attributes below. |
relationships | hash Associated Company information: Company IDs and connection order. IDs are referenced in the included object. |
included | array Includes references to the relationships object. It enables you to connect company IDs with related company domain name. |
Additional data
Attribute | Description |
---|---|
relationships > companies | array Array of company domains in the signal (max 2) When category involves two companies ie.: acquires. The order of the companies in the array is guaranteed so that the first company in the array is the acquirer and the second is the acquiree. Same goes for other categories like sells_assets_to, integrates_with … |
date | date Date (ISO 8601) of when the event happened. |
location | string Location of where the event happened or where the organization has expanded/relocated. |
location_data | hash Structured location data. Can include the following location attributes: city , state , country , fuzzy_match |
contact | string Full name of the person in the personnel change. |
job_title | string Full job title of the person in the personnel change. |
product | string Name of the product that was launched. |
product_tags | array List of tags regarding the product. |
amount | integer Total amount of the deal in $ (investments, acquisitions, new clients). |
recognition | string Name of recognition the company received. |
assets | string Company’s assets. |
asset_tags | array List of tags regarding the assets. |
headcount | integer Number of employees hired or let go. |
award | string Name of award the company received. |
financing_type | string Stage of the funding round (seed, Series A, Series B, …, Angel funding, …). |
financing_type_tags | array List of tags regarding the financing. |
funding_round | string Funding round type (Angel, Seed, Accelerator, Series A, Series B …) |
division | string Whether event concerns a specific division. |
conference | string Conference where the company received award or recognition. |
vulnerability | string Company issue |
planning | boolean Event is not set in stone. |
article_title | string Article title. |
article_sentence | string Excerpt from an article. |
article_body | string Article body. |
article_source | string Where the article was found. |
article_published_at | string Date (ISO 8601) of when the article was published. |
Event categories
Signal | Group | Description |
---|---|---|
hires |
leadership | Company hired new executive or senior personnel. |
promotes |
leadership | Company promoted existing executive or senior personnel. |
leaves |
leadership | Executive or senior personnel left the company. |
retires |
leadership | Executive or senior personnel retires from the company. |
acquires |
acquisition | Company acquired other company. |
merges_with |
acquisition | Company merges with other company. |
sells_assets_to |
acquisition | Company sells assets (like properties or warehouses) to other company. |
expands_offices_to |
expansion | Company opens new offices in another town, state, country or continent. |
expands_offices_in |
expansion | Company expands existing offices. |
expands_facilities |
expansion | Company opens new or expands existing facilities like warehouses, data centers, manufacturing plants etc. |
opens_new_location |
expansion | Company opens new service location like hotels, restaurants, bars, hospitals etc. |
increases_headcount_by |
expansion | Company offers new job vacancies. |
launches |
new_offering | Company launches new offering. |
integrates_with |
new_offering | Company integrates with other company. |
is_developing |
new_offering | Company begins development of a new offering. |
receives_financing |
investment | Company receives investment like venture funding, loan, grant etc. |
invests_into |
investment | Company invests into other company. |
invests_into_assets |
investment | Company invests into assets like property, trucks, facilities etc. |
goes_public |
investment | Company issues shares to the public for the first time. |
closes_offices |
cost_cutting | Company closes existing offices. |
decreases_headcount_by |
cost_cutting | Company lays off employees. |
partners_with |
partnership | Company partners with other company. |
receives_award |
recognition | Company or person at the company receives an award. |
recognized_as |
recognition | Company or person at the company receives recognition. |
signs_new_client |
contract | Company signs new client. |
files_suit_against |
corporate_challenges | Company files suit against other company. |
has_issues_with |
corporate_challenges | Company has vulnerability problems. |
identified_as_competitor_of |
relational | New or existing competitor was identified. |
Job opening
Examples of job_opening objects
{
"data": [{
"id": "e18484de-8f68-4dec-8403-03df2b315321",
"type": "job_opening",
"attributes": {
"title": "Full Stack Engineer",
"url": "https://www.ycombinator.com/companies/terra/jobs/3NbdZp6-full-stack-engineer",
"salary": "$50000 - $120000",
"salary_data": {
"salary_low": 50000.0,
"salary_high": 120000.0,
"salary_currency": "USD",
"salary_low_usd": 50000.0,
"salary_high_usd": 120000.0,
"salary_time_unit": "year"
},
"contract_types": [
"full time"
],
"first_seen_at": "2021-08-02T03:36:38Z",
"last_seen_at": "2021-10-30T06:52:51Z",
"last_processed_at": "2021-10-30T06:52:51Z",
"job_opening_closed": false,
"location": "London, England, United Kingdom",
"categories": [
"engineering",
"software_development"
],
"additional_data": {
"job_title_seniority": null,
"tags": [
"Growth",
"Customer success",
"Android",
"Node.js",
"PHP",
"Python",
"Ruby",
"Flask",
"Stripe",
"Cloudflare CDN",
"Doppler",
"Onesignal",
"Taplytics",
"Workramp"
],
"location_data": {
"country": "United Kingdom",
"city": "London",
"fuzzy_match": false
}
}
},
"relationships": {}
},
...,
],
"included": [],
"meta": {
"count": 14,
"total_jobs_count": 14
}
}
Attribute | Description |
---|---|
id | UUID Unique signal identifier (unique across signal types). |
type | string Signal type: “job_opening”. |
attributes | hash Includes different job opening attributes. |
title | string Job title |
url | string URL of the web page where the data was found. |
first_seen_at | datetime Time & date (ISO 8601) of when the job opening was first seen. |
last_seen_at | datetime Time & date (ISO 8601) of when the job opening was last seen. |
job_opening_closed | boolean True if keyword eg.: “job no longer available”, “vacancy listing expired”, “position filled” … is found on job opening site. Please also deem job opening as closed if last_seen_at is greater than 3 weeks ago. Job openings are crawled every 36 hours though it might happen that we cannot access the job opening with every crawl. |
categories | array Array of categories - full list below. |
salary | string String eg.: “£40000 - £50000 GBP”. |
salary_data | hash Additional data regarding the salary. See attributes below. |
contract_types | array Array of strings eg.: [“full time”, “remote”] |
location | string Location |
Additional data
Attribute | Description |
---|---|
job_title_seniority | string Seniority inferred from job opening title. Possible values listed below. |
tags | array Includes keywords found under job opening descriptions. |
description | string Job opening description in a more raw form to enable searching by keywords. Unicode normalization form NFKD is used. |
location_data | hash Can include the following location attributes: city , state , country , fuzzy_match . |
Salary data
Attribute | Description |
---|---|
salary_low | string Salary range lower bound. If salary is not a range both low and high values will be the same. |
salary_high | string Salary range upper bound. |
salary_currency | string Salary currency. |
salary_low_usd | string Salary range lower bound, converted to USD. |
salary_high_usd | string Salary range upper bound, converted to USD. |
salary_time_unit | string possible values: “hour”, “day”, “week”, “month”, “year” |
Job openings are crawled every 36 hours though it might happen that we cannot access the job opening with every crawl.
Job opening can be deemed closed if job_opening_closed
attribute is set to true or if last_seen_at
data is eg. over 2-3 weeks old.
If you want to only include super fresh job openings then simply only include those that have last_seen_at
timestamp eg. younger than 24h.
Job ID will persist and remain the same through the job opening lifespan.
Job opening categories
["administration", "consulting", "data_analysis", "design", "directors", "education", "engineering", "finance", "food", "healthcare_services", "human_resources", "information_technology", "internship", "legal", "management", "manual_work", "marketing", "military_and_protective_services", "operations", "purchasing", "product_management", "quality_assurance", "real_estate", "research", "sales", "software_development", "support"]
Job opening seniority
["owner", "founder", "c_level", "partner", "president", "vice_president", "head", "director", "manager", "non_manager"]
Technology
Examples of technology objects
{
"data": [{
"id": "31b5ef46-606e-4bf9-9b03-e2f030b72b10",
"type": "technology",
"attributes": {
"categories": [
"miscellaneous"
],
"domain": "ogp.me",
"first_seen_at": "2022-12-08T10:40:41Z",
"last_seen_at": "2023-03-08T10:48:08Z",
"url": "https://ogp.me",
"title": "Open Graph",
"behind_firewall": false,
"score": 1.0
},
"relationships": {
"company": {
"data": {
"id": "1595944",
"type": "company"
}
},
"seen_on_job_openings": {
"data": [
{
"id": "868cb5ac-355b-4e68-a811-1e630502ba1a",
"type": "job_opening"
},
...,
]
},
"seen_on_subpages": {
"data": [
{
"id": "093ad986-ab24-4a50-a9d9-0acf411dd50b",
"type": "subpages"
},
...,
]
}
}
},
...,
],
"included": [
{
"id": "868cb5ac-355b-4e68-a811-1e630502ba1a",
"type": "job_opening",
"attributes": {
"url": "https://jobs.lever.co/madkudu/01cdaa90-3d4b-47b5-bf29-5c04eb96f726",
"first_seen_at": "2022-12-19T09:29:54Z",
"last_seen_at": "2023-01-30T21:12:14Z"
}
},
{
"id": "093ad986-ab24-4a50-a9d9-0acf411dd50b",
"type": "subpage",
"attributes": {
"url": "https://www.madkudu.com",
"first_seen_at": "2018-07-09T21:35:33Z",
"last_seen_at": "2023-03-08T10:48:08Z"
}
}
{
"id": "1595944",
"type": "company",
"attributes": {
"domain": "madkudu.com",
"company_name": "Madkudu",
"ticker": null
}
},
...,
],
"meta": {
"count": 83
}
}
Attribute | Description |
---|---|
id | integer Unique trigger identifier (unique across all trigger types). |
categories | array Array of categories - full list below. |
title | string Technology name. |
url | string URL of the web page where the data was found. |
first_seen_at | datetime Time & date (ISO 8601) of when the technology was first seen. |
last_seen_at | datetime Time & date (ISO 8601) of when the technology was last seen. |
score | float Technology usage confidence score. |
relationships | hash Company website and job openings and subpages where technology signal was found. IDs are referenced in the included object. |
Technology categories
['A/B Testing', 'API Management', 'Accessibility', 'Account-Based Marketing', 'Accounting', 'Accounting and Finance', 'Ad Creative Management', 'Ad Exchanges', 'Ad Servers', 'Ad Verification and Optimization', 'Advanced Analytics and Data Science', 'Advertising', 'Advertising Networks', 'Advocacy Marketing', 'Affiliate Advertising Networks', 'Analytics', 'Applicant Tracking Systems', 'Application Development & Management', 'Application Security Testing', 'Appointment Scheduling', 'Archiving', 'Association Management', 'Audio, Video, Graphics', 'Augmented Reality', 'Automotive Marketing', 'Automotive Website Design and Development Services', 'Backup and Recovery', 'Big Data Processing', 'Blockchain', 'Blogs', 'Brand Protection Software', 'Build Automation', 'Business Intelligence', 'Business Process Management', 'CAD & Graphics', 'CAPTCHA', 'Cache Tools', 'Caching', 'Call Tracking', 'Camp Management', 'Charting', 'Click-to-Call', 'Cloud Hosting', 'Cloud Infrastructure Computing', 'Comment Systems', 'Communication and Collaboration', 'Communications Technology', 'Configuration Management', 'Configure Price Quote', 'Consent Management', 'Contact Center Solutions', 'Containerization', 'Content Delivery Network', 'Content Management System', 'Content Marketing', 'Continuous Integration', 'Control Systems', 'Cookie Compliance', 'Corporate Learning Management Systems', 'Corporate Performance Management', 'Cross-border E-Commerce', 'Cryptominers', 'Customer Communication Management', 'Customer Data Platforms', 'Customer Experience Management', 'Customer Feedback Management', 'Customer Relationship Management', 'Customer Self-Service', 'Customer Service', 'DDoS and Bot Protection', 'Data Integration', 'Data Management', 'Data Management Platforms', 'Data Quality Management', 'Data Security', 'Data Warehousing', 'Database', 'Database Management', 'Database Management Software', 'Demand Side Platforms', 'Deployment', 'Design', 'Dev Tools', 'DevOps', 'Development', 'Digital Asset Management', 'Document Management Systems', 'Documentation Tools', 'Domain Name Services', 'E-Commerce', 'E-Commerce Analytics Software', 'E-Commerce Platforms', 'Editors', 'Education Management', 'Electronic Health Records', 'Electronic Signatures', 'Email', 'Email Delivery', 'Email Hosting', 'Email Marketing', 'Email Security', 'Email Tracking', 'Endpoint Protection', 'Enterprise', 'Enterprise Content Management', 'Enterprise Data Storage', 'Enterprise Mobility Management', 'Enterprise Resource Planning', 'Enterprise Search', 'Error and Exception Monitoring', 'Event Management', 'Facilities Management', 'File Sharing', 'Fitness and Gym Management', 'Font Scripts', 'Food Ordering and Delivery', 'Frameworks and Libraries', 'Fraud Detection and Prevention', 'Fundraising and Donation Management', 'Governance, Risk and Compliance', 'HRIS Management', 'Header Bidding', 'Health Platform', 'Healthcare Marketing', 'Help Desk Management', 'Help Desk Software', 'Hospitality Marketing', 'Hosting Panels', 'Hotel Management', 'Hotel Reservations', 'Human Capital Management', 'Human Resource', 'Human Resource Management System', 'IT', 'IT Infrastructure', 'IT Infrastructure & Operations Management', 'IT Infrastructure Monitoring', 'IT Service Management', 'Identity Verification', 'Identity and Access Management', 'Influencer Marketing Software', 'Infrastructure as a Service', 'Integrated Development Environments', 'Intelligence and Analytics', 'Inventory and Order Management', 'Issue Trackers', 'Javascript Frameworks', 'Javascript Graphics', 'Javascript Libraries', 'Job Board Software', 'Lead Generation', 'Learning Management System', 'Legal Solutions', 'Live Blogging', 'Live Chat', 'Live Streaming Platforms', 'Load Balancers', 'Local Marketing', 'Logging', 'Logistics', 'Loyalty and Gamification', 'Machine Learning', 'Mapping and GIS', 'Maps', 'Marketing', 'Marketing Analytics', 'Marketing Automation', 'Marketing Data Providers', 'Marketing Performance Measurement', 'Message Boards', 'Middleware Software', 'Miscellaneous', 'Mobile Application Development Platforms', 'Mobile Frameworks', 'Multichannel Retail Software', 'Network Hardware', 'Network Management', 'Network Management (Software)', 'Network Security', 'Office Suites', 'Online Banking', 'Online Community Software', 'Online Form Builders', 'Online Review Management', 'Online Video Platforms', 'Open Source', 'Operating Systems', 'Operating Systems & Computing Languages', 'Operations', 'Page Builders', 'Partner Management Software', 'Payment Processing', 'Payroll Management and Benefits Administration', 'Payroll Processing', 'Performance', 'Personalization', 'Photo Galleries', 'Platform as a Service', 'Points of Sale', 'Pre-Employment Assessment', 'Predictive Analytics', 'Printers', 'Procurement', 'Product Information Management', 'Programming', 'Programming Languages', 'Project Management', 'Push Notifications', 'Real Estate Marketing', 'Real Estate Property Management', 'Real User Monitoring', 'Realty', 'Recruitment Marketing', 'Recurring Billing', 'Referral Marketing', 'Release Management', 'Restaurant Reservations', 'Retail Analytics Software', 'Retail Operations Software', 'Retargeting', 'Rich Text Editors', 'Risk and Compliance', 'SSL Certificate', 'Sales', 'Sales Enablement', 'Sales Performance Management', 'Search Engines', 'Search Marketing', 'Security', 'Security Information and Event Management', 'Server Hardware', 'Servers', 'Shopping Cart', 'Site Search', 'Site and Cart Abandonment', 'Size and Fit Prediction', 'Social Login', 'Social Media Analytics and Monitoring', 'Social Media Marketing Software', 'Social Sharing', 'Software Development', 'Software Framework', 'Software as a Service', 'Source Code Management', 'Spa and Salon Management', 'Sports Management', 'Sports Website Design and Development Services', 'Static Site Generator', 'Stock Images Providers', 'Storage', 'Supply Chain Management', 'Supply Side Platforms', 'System Analytics & Monitoring', 'System Security Services', 'Tag Management', 'Team Collaboration', 'Testing and QA', 'Threat Intelligence', 'Ticket Booking', 'Time Tracking', 'Tours and Activities Reservations', 'Translation', 'Transportation and Fleet Management', 'Travel and Expense Management', 'UI Frameworks', 'Unified Communications', 'User onboarding', 'Video Advertising Networks', 'Video Players', 'Virtual Private Networks', 'Virtualisation Software', 'Visitor Counters', 'Visual and User Generated Content Marketing', 'Visualisation Software', 'Warehouse Management', 'Web & Portal Technology', 'Web Accelerators', 'Web Analytics', 'Web Application Firewalls', 'Web Conferencing', 'Web Design and Development Services', 'Web Fonts', 'Web Frameworks', 'Web Hosting', 'Web Platform Extensions', 'Web Server Extensions', 'Web Servers', 'Web Tools and Plugins', 'Web and Application Servers', 'Website Builders', 'Widgets', 'Wikis', 'eDiscovery, Insurance Software']
Technology scores
If detected directly on website
No. of hits | Score |
---|---|
1 | 0.5 |
2 | 0.75 |
3 | 0.88 |
4 | 0.94 |
5 | 0.97 |
6 | 0.98 |
7 | 0.99 |
8+ | 1.00 |
If detected behind firewall
No. of hits | Score |
---|---|
1 | 0.25 |
2 | 0.39 |
3 | 0.47 |
4 | 0.52 |
5 | 0.57 |
6 | 0.61 |
7 | 0.66 |
8 | 0.70 |
9 | 0.75 |
10 | 0.79 |
11 | 0.84 |
12 | 0.88 |
13 | 0.93 |
14 | 0.97 |
15+ | 1.00 |
Connection
Examples of connection objects
{
"data": [{
"id": "168d9d73-3a8b-492f-b5bc-35564a5ff1fe",
"type": "connection",
"attributes": {
"category": "vendor",
"source_category": "vendor_page",
"source_url": "https://funnel.io/customers",
"first_seen_at": "2021-08-23T09:08:38Z",
"last_seen_at": "2021-10-18T11:30:23Z"
},
"relationships": {
"company1": {
"data": {
"id": "1828101",
"type": "company"
}
},
"company2": {
"data": {
"id": "1464778",
"type": "company"
}
}
}
},
{
"id": "d76d778a-06be-470f-b7f2-937a81b4b7d5",
"type": "connection",
"attributes": {
"category": "partner",
"source_category": "partner_page",
"source_url": "https://1wirefiber.com",
"first_seen_at": "2021-07-15T10:50:55Z",
"last_seen_at": "2021-10-23T15:10:12Z"
},
"relationships": {
"company1": {
"data": {
"id": "4965363",
"type": "company"
}
},
"company2": {
"data": {
"id": "1464778",
"type": "company"
}
}
}
},
...,
],
"included": [{
"id": "1828101",
"type": "company",
"attributes": {
"domain": "funnel.io",
"company_name": "Funnel",
"ticker": null
}
},{
"id": "1464778",
"type": "company",
"attributes": {
"domain": "pipedrive.com",
"company_name": "Pipedrive, Inc.",
"ticker": null
}
},{
"id": "4965363",
"type": "company",
"attributes": {
"domain": "1wirefiber.com",
"company_name": "1Wire Communications",
"ticker": null
}
}
...,
],
"meta": {
"count": 83
}
}
Attribute | Description |
---|---|
id | integer Unique connection identifier (unique across all trigger types). |
category | string Connection category. See full list below. |
source_category | string Describes where the category was found. See full list below. |
companies > data | string Order of companies under data is guaranteed to be such that fits the category . |
source_url | string URL where connection was found. |
first_seen_at | datetime Time & date (ISO 8601) of when the connection was first seen. |
last_seen_at | datetime Time & date (ISO 8601) of when the connection was last seen. |
relationships | hash Company information: Company IDs and connection order. IDs are referenced in the included object. |
included | array Includes references to the relationships object. It enables you to connect company IDs with related company domain name. |
Connection category
Can be one of the following:
"partner", "vendor", "purchaser", "integration", "investor", "holding", "parent", "rebranding", "published_in", "other"
Connection source_category
Can show us more info on how the connection was found. This is the full list: “` "undefined”,
“footer”, “manual_input”, “domain_redirect”, “same_subpage”,
“partner_page”, “vendor_page”, “purchaser_page”, “integration_page”, “investor_page”, “sponsor_page”, “parent_page”, “case_study_page”, “testimonial_page”, “social_page”,
“partner_section”, “vendor_section”, “purchaser_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” “`
Subpage
Examples of website evolution objects
{
"data": [{
"id": "c626a256-e9e6-461b-9d28-b9a1d0f67d71",
"type": "subpage",
"attributes": {
"category": "about",
"url": "https://fly.io/docs/hands-on/start",
"first_seen_at": "2020-07-05T18:25:39.792+02:00",
"last_seen_at": "2022-03-02T07:11:27.031+01:00"
},
"relationships": {}
},
...,
],
"included": [],
"meta": {
"count": 17
}
}
Attribute | Description |
---|---|
id | integer Unique connection identifier (unique across all trigger types). |
type | string Type is: "subpage”. |
category | string Subpage category. See full list below. |
url | string Subpage URL. |
first_seen_at | datetime Time & date (ISO 8601) of when the subpage was first seen. |
last_seen_at | datetime Time & date (ISO 8601) of when the subpage was last seen. |
relationships | hash Since there are not relationships between companies in this dataset it will be blank. |
Subpage category
Can be one of the following:
'jobs', 'blog', 'news', 'press', 'pricing', 'case_studies', 'customers', 'testimonials', 'suppliers', 'partners', 'integrations',
'portfolio', 'contact', 'investors', 'leadership', 'support', 'login', 'products', 'solutions', 'status', 'demo',
'resources', 'events', 'developers', 'API', 'terms', 'privacy', 'trust', 'feedback', 'marketplace', 'store', 'community',
'retail', 'about'
GitHub repository
Examples of GitHub repository objects
{
"data": [
{
"id": "0711177c-0dfd-4d09-b5fd-9e661a2f5503",
"type": "github_repository",
"attributes": {
"url": "https://github.com/prisma/cuid-java"
},
"relationships": {
"timeseries_datapoints": {
"data": [
{
"id": "7e1f240d-3977-4503-801a-83198467fe14",
"type": "timeseries_datapoint"
},
...
]
}
}
},
...
],
"included": [
{
"id": "7e1f240d-3977-4503-801a-83198467fe14",
"type": "timeseries_datapoint",
"attributes": {
"timestamp": "2021-03-04T10:07:11.006+01:00",
"data": {
"forks": 10,
"stars": 52,
"watches": 8,
"last_update_at": "2020-07-28T14:12:37Z"
}
}
},
...
],
"meta": {
"count": 21
}
}
Attribute | Description |
---|---|
id | uuid Unique repository identifier (unique across all trigger types). |
type | string Type is: “github_repository”. |
attributes | hash Additional repository data |
relationships | string Links to timeseries datapoints |
Attributes data
Attribute | Description |
---|---|
description | url URL pointing to the repository on GitHub. |
Timeseries datapoint
Attribute | Description |
---|---|
id | uuid Unique datapoint identifier (unique across all trigger types). |
type | string Type is: “timeseries_datapoint”. |
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 | datetime Time & date (ISO 8601) of the last update to the repository that was detected at the creation of this datapoint. |
Product
Examples of Product objects
{
"data": [{
"id": "b5b12b0c-40eb-472d-b1cf-21863cc48201",
"type": "product",
"attributes": {
"name": "Supply Chain Data Management",
"sources": [
"menu"
],
"url": "https://www.logility.com",
"first_seen_at": "2022-04-22T06:56:43Z",
"last_seen_at": "2022-05-13T06:58:59Z"
},
"relationships": {}
},
...
],
"included": [],
"meta": {
"count": 21
}
}
Attribute | Description |
---|---|
id | uuid Unique repository identifier (unique across all trigger types). |
type | string Type is: “product”. |
attributes | hash Additional repository data |
url | url URL where this product was found on |
first_seen_at | datetime Time & date (ISO 8601) when this product was first seen |
last_seen_at | datetime Time & date (ISO 8601) when this product’s page was last visited |
Attributes data
Attribute | Description |
---|---|
name | string Product name as found on the website. |
sources | array Array of source types this product has been found at. |
Source types
Can be one of the following:
'pricing, menu'
Flag
If you come across any signal that seems wrong you can simply call the flag endpoint.
Optionally you can also append a message with the signal ID. The message can include info about why you flagged the product.
Our quality assurance analysts will review the signal and correct it.
curl -X POST “https://predictleads.com/api/v1/events/:id/flag?message=‘Just … plain … wrong!!!’”
{
"meta": "Event flagged"
}