Introduction
The PredictLeads APIs are used to discover net-new companies or enrich existing company profiles with new insights. Use cases range from CRM enrichment with account intelligence, lead generation using buying signals to identifying top performing companies for investment purposes.
Our APIs are RESTful with responses delivered in JSON and XML format. Data can also be delivered via flat files.
In order to use this API, you must first register with PredictLeads to get an authentication token. Register here. If you would like to receive data via flat files please get in touch.
Authentication
Authentication using Authorization header.
curl "https://predictleads.com/api/v1/followings" \
-H 'X-User-Email: miha@predictleads.com' \
-H 'X-User-Token: 1G8_s7P-V-4MGojaKD7a'
Alternatively pass email and token in query parameters.
curl "https://predictleads.com/api/v1/followings \
?user_token={key}&user_email=miha@predictleads.com"
Authentication is done via the API token which you can find in your account settings.
In order to use the API you need to call an endpoint URL with 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.
Pagination
curl -X GET "https://predictleads.com/api/v1/companies/discover \
?event_categories=hires&page=2"
Responses with a list of objects (like GET /companies/discover) are paginated. Use page parameter to get more results.
Total number of all possible results is displayed inside meta attributes as count.
Webhooks
Example data we’ll POST to your Webhook.
{
"data": [
{
"id": "b6018242-b971-42a9-9b9f-21217cd198db",
"type": "job_opening",
"attributes": {
"title": "Senior Software Development Engineer in Test",
"url": "https://boards.greenhouse.io/fitbit92",
"location": "Minsk, Belarus",
"first_seen_at": "2019-04-03T17:49:53Z",
"last_seen_at": "2020-03-23T19:23:27Z",
"last_processed_at": "2020-03-23T19:23:27Z",
"job_opening_closed": false,
"categories": [
"engineering"
],
"additional_data": {
"job_title_seniority": "senior",
"tags": []
}
},
"relationships": {
"company": {
"data": {
"id": "1428965",
"type": "company"
}
}
}
}
],
"included": [
{
"id": "1428965",
"type": "company",
"attributes": {
"domain": "fitbit.com",
"company_name": "Fitbit, Inc."
}
}
]
}
Example data we’ll POST to Segment subscription url.
{
"data":[
{
"domain":"acast.com",
"company_name":"Acast",
"events":[
{
"id":"7175c775-bdac-4a1e-b4d0-c8264a03baa2",
"type":"events",
"attributes":{
"categories":[
"launches"
],
"title":"Acast launches app for Windows 10 devices on Jul 14th 16'.",
"url":"http://mspoweruser.com/acast-for-windows-10-now-available/",
"found_at":"2016-07-14T15:58:07Z",
"additional_data":{
"product":"app for Windows 10 devices",
"product_tags":[
"mobile",
"online_technology"
],
"date":"2016-07-14"
}
},
"relationships":{
"companies":{
"data":[
{
"type":"companies",
"domain":"acast.com"
}
]
}
}
}
]
},
{
"domain":"breezie.com",
"company_name":"Breezie Inc.",
"events":[
{
"id":"671d0686-65a3-46d2-8047-c8b9f7dd6186",
"type":"events",
"attributes":{
"categories":[
"is_developing"
],
"title":"Breezie Inc. is developing tablet solution for seniors",
"url":"http://www.crn.com.au/news/samsung-australia-and-ethan-group-team-up-to-bring-tablets-to-seniors-442801",
"found_at":"2016-11-28T12:10:17Z",
"additional_data":{
"product":"tablet solution for seniors",
"product_tags":[
"mobile"
]
}
},
"relationships":{
"companies":{
"data":[
{
"type":"companies",
"domain":"breezie.com"
}
]
}
}
}
]
}
]
}
Webhooks enable our customers to receive data on a continuous basis without the need to issue unnecessary API requests.
Signals
Anytime 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 account settings 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.
Authentication
To validate 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 API key and the raw body of the request.
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.
Followed companies
curl -X GET "https://predictleads.com/api/v1/followings"
[
"hubspot.com",
"clearbit.com",
"segment.com",
"outreach.io",
"..."
]
Returns a list of followed companies.
HTTP Request
GET https://predictleads.com/api/v1/followings
Follow company
curl -X POST "https://predictleads.com/api/v1/companies/madkudu.com/follow"
{
"success": {
"type":"follow_successful",
"message":"Company with domain madkudu.com was successfully followed."
}
}
Enables the authenticated user to follow the company specified with the company domain parameter.
HTTP Request
POST https://predictleads.com/api/v1/companies/:domain/follow
Unfollow company
curl -X POST "https://predictleads.com/api/v1/companies/kitedesk.com/unfollow"
{
"success": {
"type":"unfollow_successful",
"message":"Company with domain kitedesk.com was successfully unfollowed."
}
}
Enables the authenticated user to unfollow the company specified with the domain parameter.
HTTP Request
POST https://predictleads.com/api/v1/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/segment.com/events"
{
"data": [
{
"id": "21639dd6-f560-4601-a787-fed275b29ec6",
"type": "event",
"attributes": {
"categories": [
"launches"
],
"title": "Segment launches Segment Select",
"found_at": "2019-01-23T14:35:53Z",
"additional_data": {
"product": "Segment Select",
"product_data": {
"full_text": "Segment Select",
"fuzzy_match": true
},
"article_title": "5 Channel Partner Updates: Wednesday 23 January 2019",
"article_sentence": "Partner Program – Data Infrastructure: Segment, a customer data infrastructure company, has launched Segment Select, a program for Channel and Technology Partners.",
"article_source": "channele2e.com",
"article_published_at": "2019-01-23T15:35:53.000Z",
"confidence": "1.0"
},
"url": "https://www.channele2e.com/news/5-channel-partner-updates-wednesday-23-january-2019/"
}
},
{
"id": "65b0a278-be9a-47b6-a9c4-ae7e7171dcbf",
"type": "event",
"attributes": {
"categories": [
"hires"
],
"title": "Segment hired Sandra Smith as Chief Financial Officer on Oct 25th 18'.",
"found_at": "2018-10-25T11:22:16Z",
"additional_data": {
"contact": "Sandra Smith",
"job_title": "Chief Financial Officer",
"date": "2018-10-25",
"article_title": "Segment Appoints Sandra Smith as Chief Financial Officer",
"article_sentence": "Segment, the customer data infrastructure company, today announced that Sandra Smith has joined the company as Chief Financial Officer, effective immediately.",
"article_source": "apnews.com",
"article_published_at": "2018-10-25T13:22:16.000Z",
"confidence": "0.8811"
},
"url": "https://www.apnews.com/d3b30ed40a41bcb36c1d71da096789ca"
}
},
{
"id": "612e4135-5277-4ae6-ae42-4ff86f59b41e",
"type": "event",
"attributes": {
"categories": [
"recognized_as"
],
"title": "Segment recognized as Forbes Cloud 100 on Sep 13th 18'.",
"found_at": "2018-09-13T18:10:00Z",
"additional_data": {
"recognition": "Forbes Cloud 100",
"date": "2018-09-13",
"article_title": "Segment Named to Forbes’ 2018 Cloud 100 List for Third Consecutive Year",
"article_sentence": "Segment, the customer data infrastructure company, today announced it has been named to the Forbes Cloud 100 list for the third year in a row.",
"article_source": "globenewswire.com",
"article_published_at": "2018-09-13T20:10:00.000Z",
"confidence": "0.7262"
},
"url": "https://globenewswire.com/news-release/2018/09/13/1570820/0/en/Segment-Named-to-Forbes-2018-Cloud-100-List-for-Third-Consecutive-Year.html"
}
},
{
"id": "e456949f-b62d-4912-9f24-1fb88fb244d8",
"type": "event",
"attributes": {
"categories": [
"partners_with"
],
"title": "Snowflake partnered with Segment on Mar 20th 18'.",
"found_at": "2018-03-19T22:00:00Z",
"additional_data": {
"date": "2018-03-20",
"article_title": "Snowflake and Segment partner to enable rapid analysis of customer data at scale | Snowflake",
"article_sentence": "Snowflake Computing, the data warehouse built for the cloud, today announced a strategic partnership with Segment, the customer data platform, to provide Snowflake’s cloud data warehouse on the Segment platform.",
"article_source": "snowflake.net",
"article_published_at": "2018-03-20T00:00:00.000Z",
"confidence": "0.798"
},
"url": "https://www.snowflake.net/news-items/snowflake-and-segment-partner-to-enable-rapid-analysis-of-customer-data-at-scale/"
},
"relationships": {
"company1": {
"data": {
"id": "3500291",
"type": "company"
}
},
"company2": {
"data": {
"id": "1474306",
"type": "company"
}
}
}
},
{
"id": "087b423b-ddd6-49f5-a263-d981fc24dc17",
"type": "event",
"attributes": {
"categories": [
"hires"
],
"title": "Segment hires Rowghani as board of directors",
"found_at": "2017-07-13T02:19:03Z",
"additional_data": {
"contact": "Rowghani",
"job_title": "board of directors",
"article_title": "Marketing data startup Segment raises $64M | TechCrunch",
"article_sentence": "As part of the deal, Rowghani will be joining Segment’s board of directors.",
"article_source": "techcrunch.com",
"article_published_at": "2017-07-13T14:19:03.000Z",
"confidence": "0.8392",
"human_approved": true
},
"url": "https://techcrunch.com/2017/07/13/segment-series-c/"
}
},
{
"id": "97e3c0bc-1eca-4c9b-906e-3a0e334c4b51",
"type": "event",
"attributes": {
"categories": [
"receives_financing"
],
"title": "Segment received financing of $64M in Series C funding on Jul 6th 17'.",
"found_at": "2017-07-12T18:19:00Z",
"additional_data": {
"financing_type": "Series C funding",
"funding_round": "Series C",
"financing_type_tags": [
"equity"
],
"amount": 64000000,
"date": "2017-07-06",
"article_title": "Looker and Segment hook up to improve marketing automation performance",
"article_sentence": "Looker completed an $81.5 million funding round in March and Segment closed a $64 million round earlier this month, bringing its total funding to more than $108 million.",
"article_source": "siliconangle.com",
"article_published_at": "2017-07-25T16:16:33.000Z",
"confidence": "0.7474"
},
"url": "https://siliconangle.com/blog/2017/07/25/looker-segment-hook-improve-marketing-automation-performance/"
}
},
...
],
"included": [
{
"id": "1474306",
"type": "company",
"attributes": {
"domain": "segment.com",
"company_name": "Segment"
}
},
{
"id": "3500291",
"type": "company",
"attributes": {
"domain": "snowflake.com",
"company_name": "Snowflake"
}
},
...
],
"meta": {
"count": 17
}
}
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.
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. |
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/zapier.com/job_openings"
{
"data": [
{
"id": "385fe616-07f8-42c9-9fdd-18b2de0eefaa",
"type": "job_opening",
"attributes": {
"categories": [],
"title": "Engineering - Test Automation Engineer",
"url": "https://boards.greenhouse.io/zapier/jobs/4138904002",
"first_seen_at": "2018-12-19T23:02:57Z",
"last_seen_at": "2019-01-17T22:01:20Z",
"job_opening_closed": null,
"additional_data": {
"job_title": "Engineering - Test Automation Engineer",
"job_title_seniority": "undefined",
"tags": []
}
}
},
{
"id": "47563292-587f-49c7-accc-b3e6057e110d",
"type": "job_opening",
"attributes": {
"categories": [
"directors",
"marketing"
],
"title": "Marketing - Director of Advertising and Paid Media",
"url": "https://boards.greenhouse.io/zapier/jobs/4136045002",
"first_seen_at": "2018-12-19T23:02:57Z",
"last_seen_at": "2019-01-18T03:08:52Z",
"job_opening_closed": null,
"additional_data": {
"job_title": "Marketing - Director of Advertising and Paid Media",
"job_title_seniority": "lower_management",
"tags": []
}
}
},
{
"id": "ce46a20e-ba8a-47ca-8cfd-1742fc991644",
"type": "job_opening",
"attributes": {
"categories": [
"marketing",
"management"
],
"title": "Marketing - Communications Manager",
"url": "https://boards.greenhouse.io/zapier/jobs/4139063002",
"first_seen_at": "2018-12-19T23:02:57Z",
"last_seen_at": "2019-01-19T17:58:42Z",
"job_opening_closed": null,
"additional_data": {
"job_title": "Marketing - Communications Manager",
"job_title_seniority": "management",
"tags": []
}
}
},
{
"id": "71c88f84-3628-41e8-863e-3a0332143ab0",
"type": "job_opening",
"attributes": {
"categories": [
"support"
],
"title": "International Support - Customer Champion - Wellington, New Zealand",
"url": "https://boards.greenhouse.io/zapier/jobs/4114586002",
"first_seen_at": "2018-11-09T20:57:25Z",
"last_seen_at": "2019-01-18T10:17:42Z",
"job_opening_closed": null,
"additional_data": {
"job_title": "International Support - Customer Champion - Wellington, New Zealand",
"job_title_seniority": "undefined",
"tags": []
}
}
},
{
"id": "483e272a-1dab-4d65-873c-e6538c6919e3",
"type": "job_opening",
"attributes": {
"categories": [],
"title": "Engineering - Application Security Engineer",
"url": "https://boards.greenhouse.io/zapier/jobs/4101757002",
"first_seen_at": "2018-11-09T20:57:25Z",
"last_seen_at": "2018-11-10T00:00:42Z",
"job_opening_closed": null,
"additional_data": {
"job_title": "Engineering - Application Security Engineer",
"job_title_seniority": "undefined",
"tags": []
}
}
},
{
"id": "fc3b8a03-9bdf-47e7-9b08-51fdd87f1284",
"type": "job_opening",
"attributes": {
"categories": [],
"title": "Marketing - Head of Decision Science and Analytics",
"url": "https://boards.greenhouse.io/zapier/jobs/4106769002",
"first_seen_at": "2018-11-09T20:57:25Z",
"last_seen_at": "2019-01-20T06:32:11Z",
"job_opening_closed": null,
"additional_data": {
"job_title": "Marketing - Head of Decision Science and Analytics",
"job_title_seniority": "undefined",
"tags": []
}
}
},
{
"id": "f6020040-da18-4c17-9dbc-95b2c69eaff1",
"type": "job_opening",
"attributes": {
"categories": [
"directors",
"design"
],
"title": "Design - Senior Director of Design",
"url": "https://zapier.com/jobs/4090341002/senior-director-of-design",
"first_seen_at": "2018-11-09T20:57:25Z",
"last_seen_at": "2018-11-10T00:00:42Z",
"job_opening_closed": null,
"additional_data": {
"job_title": "Design - Senior Director of Design",
"job_title_seniority": "lower_management",
"tags": []
}
}
},
...
],
"meta": {
"count": 26,
"total_jobs_count": 26
}
}
Returns a list of job openings for a given company. Job openings are found on companies’ career sites and job boards.
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 (,). |
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"
{
"data": [
{
"id": "382484d0-aa3a-4af1-8e68-d81df9506b2e",
"type": "technology",
"attributes": {
"categories": [
"customer_messaging_platform",
"chat_software"
],
"domain": null,
"title": "Intercom",
"url": "https://www.madkudu.com",
"first_seen_at": "2016-08-10T23:19:46Z",
"last_seen_at": "2019-01-14T21:06:07Z"
}
},
{
"id": "251c4ee7-7f27-47a2-8d2b-b1f3714cd0bd",
"type": "technology",
"attributes": {
"categories": [
"widgets"
],
"domain": "addthis.com",
"title": "AddThis",
"url": "https://www.madkudu.com",
"first_seen_at": "2018-01-26T11:27:47Z",
"last_seen_at": "2019-01-14T21:06:07Z"
}
},
{
"id": "9a22eeb8-9120-4869-98ff-584010058834",
"type": "technology",
"attributes": {
"categories": [
"ecommerce"
],
"domain": "shopify.com",
"title": "Shopify",
"url": "https://www.madkudu.com",
"first_seen_at": "2018-01-13T16:15:45Z",
"last_seen_at": "2018-02-19T21:10:31Z"
}
},
{
"id": "d108d45c-9553-4b89-a02c-9e1daff1ca20",
"type": "technology",
"attributes": {
"categories": [
"analytics"
],
"domain": "segment.com",
"title": "Segment",
"url": "https://www.madkudu.com",
"first_seen_at": "2017-01-26T01:30:38Z",
"last_seen_at": "2019-01-14T21:06:07Z"
}
},
{
"id": "6ff9b3b5-f58f-44cf-af9b-dc781f3e3528",
"type": "technology",
"attributes": {
"categories": [
"marketing_analytics",
"marketing_performance_measurement",
"marketing_automation",
"marketing",
"sales",
"inbound",
"crm"
],
"domain": "hubspot.com",
"title": "HubSpot",
"url": "https://www.madkudu.com",
"first_seen_at": "2016-12-01T00:55:22Z",
"last_seen_at": "2019-01-14T21:06:07Z"
}
},
{
"id": "30fe792f-c890-417f-97e0-3cf1440332f6",
"type": "technology",
"attributes": {
"categories": [
"system_analytics_&_monitoring",
"analytics",
"tools"
],
"domain": null,
"title": "Piwik",
"url": "https://www.madkudu.com",
"first_seen_at": "2016-12-01T00:55:22Z",
"last_seen_at": "2019-01-14T21:06:07Z"
}
},
{
"id": "030b9b69-aeef-4570-bfba-57b44e3e1974",
"type": "technology",
"attributes": {
"categories": [
"marketing_performance_measurement",
"retargeting",
"content_marketing",
"crm",
"marketing",
"tools"
],
"domain": "adroll.com",
"title": "AdRoll",
"url": "https://www.madkudu.com",
"first_seen_at": "2016-08-10T23:19:46Z",
"last_seen_at": "2017-01-12T01:21:53Z"
}
},
{
"id": "5cb4c066-ce11-418b-a827-a68ff5cd7032",
"type": "technology",
"attributes": {
"categories": [
"analytics"
],
"domain": "mixpanel.com",
"title": "Mixpanel",
"url": "https://www.madkudu.com",
"first_seen_at": "2016-08-10T23:19:47Z",
"last_seen_at": "2017-01-12T01:21:53Z"
}
},
{
"id": "7debb4ad-8ec5-443c-9deb-8c500ff939dd",
"type": "technology",
"attributes": {
"categories": [
"analytics"
],
"domain": "google.com",
"title": "Google Analytics",
"url": "https://www.madkudu.com",
"first_seen_at": "2016-08-10T23:19:46Z",
"last_seen_at": "2019-01-14T21:06:07Z"
}
},
{
"id": "751b1dfa-e5f9-4917-9dc7-636a6af7294f",
"type": "technology",
"attributes": {
"categories": [
"analytics"
],
"domain": "optimizely.com",
"title": "Optimizely",
"url": "https://www.madkudu.com",
"first_seen_at": "2016-08-10T23:19:47Z",
"last_seen_at": "2019-01-14T21:06:07Z"
}
},
{
"id": "cb95cd7f-59cc-4543-af11-e5eb7be98ca7",
"type": "technology",
"attributes": {
"categories": [
"widgets",
"marketing_automation"
],
"domain": null,
"title": "SumoMe",
"url": "https://www.madkudu.com",
"first_seen_at": "2018-01-26T11:27:47Z",
"last_seen_at": "2018-09-17T21:37:23Z"
}
},
{
"id": "1bceedf1-bb58-467a-af79-fd5fb53bf94c",
"type": "technology",
"attributes": {
"categories": [
"comment_systems"
],
"domain": "disqus.com",
"title": "Disqus",
"url": "https://www.madkudu.com",
"first_seen_at": "2018-01-26T11:27:47Z",
"last_seen_at": "2019-01-14T21:06:07Z"
}
},
...
],
"meta": {
"count": 29
}
}
Returns a list of technology providers for a given company.
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 (,). |
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.
To get more results use pagination.
Connections
curl -X GET "https://predictleads.com/api/v2/companies/pipedrive.com/connections"
{
"data": [
{
"id": "1272712",
"type": "connection",
"attributes": {
"category": "integration",
"first_seen_at": "2018-01-11T02:40:52Z",
"last_seen_at": "2019-02-16T19:19:45Z",
"source_category": "integration_page",
"source_url": "https://www.cluedin.net/integrations"
},
"relationships": {
"company1": {
"data": {
"id": "1620557",
"type": "company"
}
},
"company2": {
"data": {
"id": "1464778",
"type": "company"
}
}
}
},
{
"id": "3881276",
"type": "connection",
"attributes": {
"category": "partner",
"first_seen_at": "2018-02-28T14:59:48Z",
"last_seen_at": "2019-02-13T16:18:09Z",
"source_category": "partner_page",
"source_url": "https://www.monstrafestival.com/partners/"
},
"relationships": {
"company1": {
"data": {
"id": "3688114",
"type": "company"
}
},
"company2": {
"data": {
"id": "1464778",
"type": "company"
}
}
}
},
{
"id": "14166476",
"type": "connection",
"attributes": {
"category": "vendor",
"first_seen_at": "2018-09-22T05:07:46Z",
"last_seen_at": "2019-02-12T16:28:48Z",
"source_category": "vendor_page",
"source_url": "https://ambernettech.com/"
},
"relationships": {
"company1": {
"data": {
"id": "4655015",
"type": "company"
}
},
"company2": {
"data": {
"id": "1464778",
"type": "company"
}
}
}
},
{
"id": "18080500",
"type": "connection",
"attributes": {
"category": "integration",
"first_seen_at": "2019-02-12T13:35:02Z",
"last_seen_at": "2019-02-12T13:35:02Z",
"source_category": "integration_page",
"source_url": "https://timeon.io/integrations/"
},
"relationships": {
"company1": {
"data": {
"id": "11095796",
"type": "company"
}
},
"company2": {
"data": {
"id": "1464778",
"type": "company"
}
}
}
},
{
"id": "17793845",
"type": "connection",
"attributes": {
"category": "other",
"first_seen_at": "2019-02-11T18:13:49Z",
"last_seen_at": "2019-02-11T18:13:49Z",
"source_category": "undefined",
"source_url": "https://nbbadvisors.com/"
},
"relationships": {
"company1": {
"data": {
"id": "4372782",
"type": "company"
}
},
"company2": {
"data": {
"id": "1464778",
"type": "company"
}
}
}
},
{
"id": "16641677",
"type": "connection",
"attributes": {
"category": "investor",
"first_seen_at": "2019-02-08T10:09:11Z",
"last_seen_at": "2019-02-08T10:09:10Z",
"source_category": "investor_page",
"source_url": "https://www.bvp.com/companies"
},
"relationships": {
"company1": {
"data": {
"id": "1409780",
"type": "company"
}
},
"company2": {
"data": {
"id": "1464778",
"type": "company"
}
}
}
},
...
],
"included": [
{
"id": "1620557",
"type": "company",
"attributes": {
"domain": "cluedin.net",
"company_name": "CluedIn ApS"
}
},
{
"id": "1464778",
"type": "company",
"attributes": {
"domain": "pipedrive.com",
"company_name": "Pipedrive, Inc."
}
},
{
"id": "3688114",
"type": "company",
"attributes": {
"domain": "monstrafestival.com",
"company_name": "MONSTRA | Lisbon Animated Film Festival"
}
},
{
"id": "4655015",
"type": "company",
"attributes": {
"domain": "ambernettech.com",
"company_name": "AmberNet Technologies - Hybrid Cloud Management- Brokerage - Application Blueprinting & Migrations"
}
},
{
"id": "11095796",
"type": "company",
"attributes": {
"domain": "timeon.io",
"company_name": null
}
},
{
"id": "4372782",
"type": "company",
"attributes": {
"domain": "nbbadvisors.com",
"company_name": "NBB M&A Advisors"
}
},
{
"id": "1409780",
"type": "company",
"attributes": {
"domain": "bvp.com",
"company_name": "Bessemer Venture Partners"
}
},
{
"id": "1572978",
"type": "company",
"attributes": {
"domain": "bigroomstudios.com",
"company_name": "Big Room Studios, Inc."
}
},
{
"id": "2366886",
"type": "company",
"attributes": {
"domain": "leadliaison.com",
"company_name": "Leadliaison"
}
},
...
],
"meta": {
"count": 83
}
}
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 …
HTTP Request
GET https://predictleads.com/api/v2/companies/:domain/connections
Request Parameters
| Parameter | Description |
|---|---|
limit |
string Limit the number of shown events per page. Default is 30, maximum is 100. |
More information on the connection object is available here.
To get more results use pagination.
All
curl -X GET "https://predictleads.com/api/v2/companies/prisma.io"
{
"data": [
{
"id": "4364432",
"type": "company",
"attributes": {
"domain": "prisma.io",
"company_name": "Prisma",
"friendly_company_name": "Prisma"
},
"relationships": {
"connections": {
"data": [
{
"id": "9895269",
"type": "website_connection"
},
{
"id": "9895268",
"type": "website_connection"
},
{
"id": "15086607",
"type": "website_connection"
}
]
},
"events": {
"data": [
{
"id": "34c2be6f-8645-4724-a279-cb9f8640f51a",
"type": "event"
},
{
"id": "19973583-cac3-44f6-941d-5186e0f5601e",
"type": "event"
},
{
"id": "82272f3e-d1ea-456b-bd81-d08691518510",
"type": "event"
},
{
"id": "b7d0c109-aeca-49a9-b675-e842a8a02ede",
"type": "event"
}
]
},
"job_openings": {
"data": [
{
"id": "0e36da16-7853-42e6-a54f-b8dad42f0a11",
"type": "job_opening"
},
{
"id": "5b846e70-c211-4186-8e99-2c3058d114d8",
"type": "job_opening"
},
{
"id": "25c0badb-8d7f-489f-9b0a-7a9502418af4",
"type": "job_opening"
},
{
"id": "00d01b7e-7ea2-4362-8d03-419959b56070",
"type": "job_opening"
},
{
"id": "333d6d43-eb23-40bb-b131-1168063c8a4d",
"type": "job_opening"
},
{
"id": "284c6cb2-bc41-4bf8-83bd-b6bb1257b907",
"type": "job_opening"
},
{
"id": "62ec2b9f-f910-4e2f-861d-362a2806baf6",
"type": "job_opening"
},
{
"id": "4d74f676-2837-4907-a32b-7648353d8a35",
"type": "job_opening"
},
{
"id": "c92ff71d-bea4-4b1a-a251-c85d57278b6a",
"type": "job_opening"
},
{
"id": "328f0288-6311-4fc6-bb32-8dabdb643902",
"type": "job_opening"
},
{
"id": "14963b6d-b955-4376-87f4-667a30023117",
"type": "job_opening"
},
{
"id": "3a68ecf3-c8f3-45e8-8f64-15f16da0e866",
"type": "job_opening"
},
{
"id": "1f17c3c8-0fce-4d33-a55b-237c0c3a6fce",
"type": "job_opening"
},
{
"id": "1d4bd1bd-5d33-4e18-a728-ebef56189d76",
"type": "job_opening"
},
{
"id": "ee354507-faeb-46b8-a7d3-240afeb03de9",
"type": "job_opening"
}
]
},
"technologies": {
"data": [
{
"id": "331dd1e8-b6ef-4ae5-8f3f-2ff0eb4e6bc9",
"type": "technology"
},
{
"id": "1db191d8-61cb-4a92-883d-33f4fdde05aa",
"type": "technology"
},
{
"id": "5e1be515-35f9-4686-b198-84e138ca2752",
"type": "technology"
},
{
"id": "4bf78bb7-9081-4baf-920b-7c89f66264c2",
"type": "technology"
},
{
"id": "ad228ce9-934d-4981-8903-32fb4fdf7321",
"type": "technology"
},
{
"id": "1bf2a9e2-f9b3-462b-8c9b-b7143f3d7a8f",
"type": "technology"
},
{
"id": "56d4d36d-ec73-4512-840b-9635e29d1282",
"type": "technology"
},
{
"id": "4a45107e-22e4-4ed5-8cb5-53b69187079a",
"type": "technology"
},
{
"id": "42c17e76-355b-4ffd-bcbb-a88d7b74f26d",
"type": "technology"
},
{
"id": "d4e2c58e-bd43-4741-87e7-d086bef2ab3b",
"type": "technology"
}
]
}
}
}
],
"included": [
{
"id": "9895269",
"type": "connection",
"attributes": {
"id": 9895269,
"category": "other",
"source_category": "footer",
"source_url": "https://www.prisma.io/",
"first_seen_at": "2018-07-07T13:21:17Z",
"last_seen_at": "2018-11-03T14:56:34Z"
},
"relationships": {
"company1": {
"data": {
"id": "4364432",
"type": "company"
}
},
"company2": {
"data": {
"id": "1451947",
"type": "company"
}
}
}
},
{
"id": "9895268",
"type": "connection",
"attributes": {
"id": 9895268,
"category": "other",
"source_category": "footer",
"source_url": "https://www.prisma.io/",
"first_seen_at": "2018-07-07T13:21:17Z",
"last_seen_at": "2018-11-03T14:56:34Z"
},
"relationships": {
"company1": {
"data": {
"id": "4364432",
"type": "company"
}
},
"company2": {
"data": {
"id": "12460393",
"type": "company"
}
}
}
},
{
"id": "15086607",
"type": "connection",
"attributes": {
"id": 15086607,
"category": "other",
"source_category": "footer",
"source_url": "https://www.prisma.io/",
"first_seen_at": "2018-12-07T06:53:30Z",
"last_seen_at": "2019-02-16T21:39:23Z"
},
"relationships": {
"company1": {
"data": {
"id": "4364432",
"type": "company"
}
},
"company2": {
"data": {
"id": "17937243",
"type": "company"
}
}
}
},
{
"id": "4364432",
"type": "company",
"attributes": {
"domain": "prisma.io",
"company_name": "Prisma"
}
},
{
"id": "1451947",
"type": "company",
"attributes": {
"domain": "meetup.com",
"company_name": "MeetUp, Inc."
}
},
{
"id": "12460393",
"type": "company",
"attributes": {
"domain": "graphql-europe.org",
"company_name": null
}
},
{
"id": "17937243",
"type": "company",
"attributes": {
"domain": "graphqlconf.org",
"company_name": null
}
},
{
"id": "34c2be6f-8645-4724-a279-cb9f8640f51a",
"type": "event",
"attributes": {
"categories": [
"receives_financing"
],
"title": "Prisma received financing of $4.5M in seed round on May 24th 18'.",
"found_at": "2018-05-23T22:00:00Z",
"url": "https://www.prisma.io/blog/prisma-raises-4-5m-to-build-the-graphql-data-layer-for-all-databases-663484df0f60/",
"additional_data": {
"financing_type": "seed round",
"funding_round": "seed",
"financing_type_tags": [
"equity"
],
"amount": 4500000,
"date": "2018-05-24",
"article_title": "Prisma raises $4.5M to build the GraphQL data layer for all databases | Prisma",
"article_sentence": "Today, Prisma has some very exciting news to share: Prisma has raised a $4.5 million seed round led by Kleiner Perkins and are rebranding to Prisma.",
"article_source": "prisma.io",
"article_published_at": "2018-05-24T00:00:00.000Z",
"confidence": "0.9918"
}
},
"relationships": {}
},
{
"id": "19973583-cac3-44f6-941d-5186e0f5601e",
"type": "event",
"attributes": {
"categories": [
"launches"
],
"title": "Prisma launches lightweight process for turning REST into GraphQL APIs",
"found_at": "2018-02-28T23:00:00Z",
"url": "https://www.prisma.io/blog/how-to-wrap-a-rest-api-with-graphql-8bf3fb17547d/",
"additional_data": {
"product": "lightweight process for turning REST into GraphQL APIs",
"product_tags": [
"online_technology"
],
"product_data": {
"full_text": "lightweight process for turning REST into GraphQL APIs",
"fuzzy_match": true
},
"article_title": "How to wrap a REST API with GraphQL",
"article_sentence": "In this article, Prisma is going to introduce a lightweight process for turning REST into GraphQL APIs.",
"article_source": "prisma.io",
"article_published_at": "2018-03-01T00:00:00.000Z",
"confidence": "0.8455"
}
},
"relationships": {}
},
{
"id": "82272f3e-d1ea-456b-bd81-d08691518510",
"type": "event",
"attributes": {
"categories": [
"launches"
],
"title": "Prisma launches improved release process with a dedicated beta period",
"found_at": "2018-05-28T22:00:00Z",
"url": "https://www.prisma.io/blog/improving-prismas-release-process-yaey8deiwaex/",
"additional_data": {
"product": "improved release process with a dedicated beta period",
"product_data": {
"full_text": "improved release process with a dedicated beta period",
"fuzzy_match": true,
"release_type": "improved release"
},
"article_title": "New Release Process for Prisma | Prisma",
"article_sentence": "Prisma is introducing an improved release process with a dedicated beta period to ensure high quality while shipping new features fast.",
"article_source": "prisma.io",
"article_published_at": "2018-05-29T00:00:00.000Z",
"confidence": "0.9486"
}
},
"relationships": {}
},
{
"id": "b7d0c109-aeca-49a9-b675-e842a8a02ede",
"type": "event",
"attributes": {
"categories": [
"invests_into"
],
"title": "Kleiner Perkins invested into Prisma in $4.5M on May 24th 18'.",
"found_at": "2018-05-23T20:00:00Z",
"url": "https://www.prisma.io/blog/prisma-raises-4-5m-to-build-the-graphql-data-layer-for-all-databases-663484df0f60/",
"additional_data": {
"amount": 4500000,
"date": "2018-05-24",
"article_title": "Prisma raises $4.5M to build the GraphQL data layer for all databases | Prisma",
"article_sentence": "Today, Prisma has some very exciting news to share: Prisma has raised a $4.5 million seed round led by Kleiner Perkins and are rebranding to Prisma.",
"article_source": "prisma.io",
"article_published_at": "2018-05-24T00:00:00.000Z",
"confidence": "0.9892"
}
},
"relationships": {
"company1": {
"data": {
"id": "12462573",
"type": "company"
}
},
"company2": {
"data": {
"id": "4364432",
"type": "company"
}
}
}
},
{
"id": "12462573",
"type": "company",
"attributes": {
"domain": "kleinerperkins.com",
"company_name": "Kleiner Perkins"
}
},
{
"id": "0e36da16-7853-42e6-a54f-b8dad42f0a11",
"type": "job_opening",
"attributes": {
"title": "JavaScript Engineer",
"url": "https://boards.greenhouse.io/prisma/jobs/4127293002",
"first_seen_at": "2019-02-09T22:04:45Z",
"last_seen_at": "2019-02-09T22:04:45Z",
"job_opening_closed": false,
"categories": [
"engineering"
],
"additional_data": {
"job_title": "JavaScript Engineer",
"job_title_seniority": "undefined",
"tags": []
}
}
},
{
"id": "5b846e70-c211-4186-8e99-2c3058d114d8",
"type": "job_opening",
"attributes": {
"title": "Technical Writer",
"url": "https://boards.greenhouse.io/prisma/jobs/4138182002",
"first_seen_at": "2019-02-09T22:04:45Z",
"last_seen_at": "2019-02-09T22:04:45Z",
"job_opening_closed": false,
"categories": [
"engineering"
],
"additional_data": {
"job_title": "Technical Writer",
"job_title_seniority": "undefined",
"tags": []
}
}
},
{
"id": "25c0badb-8d7f-489f-9b0a-7a9502418af4",
"type": "job_opening",
"attributes": {
"title": "Technical Writer",
"url": "https://www.prisma.io/jobs",
"first_seen_at": "2018-12-29T17:32:42Z",
"last_seen_at": "2018-12-29T17:32:42Z",
"job_opening_closed": true,
"categories": [
"engineering"
],
"additional_data": {
"job_title": "Technical Writer",
"job_title_seniority": "undefined",
"tags": []
}
}
},
{
"id": "00d01b7e-7ea2-4362-8d03-419959b56070",
"type": "job_opening",
"attributes": {
"title": "JavaScript Engineer",
"url": "https://www.prisma.io/jobs",
"first_seen_at": "2018-12-29T17:32:42Z",
"last_seen_at": "2018-12-29T17:32:42Z",
"job_opening_closed": true,
"categories": [
"engineering"
],
"additional_data": {
"job_title": "JavaScript Engineer",
"job_title_seniority": "undefined",
"tags": []
}
}
},
{
"id": "333d6d43-eb23-40bb-b131-1168063c8a4d",
"type": "job_opening",
"attributes": {
"title": "Technical Writer",
"url": "https://www.prisma.io/jobs",
"first_seen_at": "2018-12-15T17:12:29Z",
"last_seen_at": "2018-12-15T17:12:29Z",
"job_opening_closed": true,
"categories": [
"engineering"
],
"additional_data": {
"job_title": "Technical Writer",
"job_title_seniority": "undefined",
"tags": []
}
}
},
{
"id": "284c6cb2-bc41-4bf8-83bd-b6bb1257b907",
"type": "job_opening",
"attributes": {
"title": "Engineering Manager",
"url": "https://boards.greenhouse.io/prisma/jobs/4110079002",
"first_seen_at": "2018-11-24T00:42:08Z",
"last_seen_at": "2018-11-24T00:42:08Z",
"job_opening_closed": false,
"categories": [
"management"
],
"additional_data": {
"job_title": "Engineering Manager",
"job_title_seniority": "management",
"tags": []
}
}
},
{
"id": "62ec2b9f-f910-4e2f-861d-362a2806baf6",
"type": "job_opening",
"attributes": {
"title": "Developer Support Engineer",
"url": "https://boards.greenhouse.io/prisma/jobs/4110594002",
"first_seen_at": "2018-11-24T00:42:08Z",
"last_seen_at": "2018-11-24T00:42:08Z",
"job_opening_closed": false,
"categories": [
"support",
"engineering",
"software_development"
],
"additional_data": {
"job_title": "Developer Support Engineer",
"job_title_seniority": "undefined",
"tags": []
}
}
},
{
"id": "4d74f676-2837-4907-a32b-7648353d8a35",
"type": "job_opening",
"attributes": {
"title": "Student Software Engineer",
"url": "https://boards.greenhouse.io/prisma/jobs/4110595002",
"first_seen_at": "2018-11-24T00:42:08Z",
"last_seen_at": "2018-11-24T00:42:08Z",
"job_opening_closed": false,
"categories": [
"engineering",
"software_development"
],
"additional_data": {
"job_title": "Student Software Engineer",
"job_title_seniority": "undefined",
"tags": []
}
}
},
{
"id": "c92ff71d-bea4-4b1a-a251-c85d57278b6a",
"type": "job_opening",
"attributes": {
"title": "JavaScript Engineer",
"url": "https://www.prisma.io/jobs",
"first_seen_at": "2018-11-24T00:42:08Z",
"last_seen_at": "2018-11-24T00:42:08Z",
"job_opening_closed": true,
"categories": [
"engineering"
],
"additional_data": {
"job_title": "JavaScript Engineer",
"job_title_seniority": "undefined",
"tags": []
}
}
},
{
"id": "328f0288-6311-4fc6-bb32-8dabdb643902",
"type": "job_opening",
"attributes": {
"title": "Solutions Engineer",
"url": "https://boards.greenhouse.io/prisma/jobs/4110593002",
"first_seen_at": "2018-11-24T00:42:08Z",
"last_seen_at": "2018-11-24T00:42:08Z",
"job_opening_closed": false,
"categories": [
"engineering"
],
"additional_data": {
"job_title": "Solutions Engineer",
"job_title_seniority": "undefined",
"tags": []
}
}
},
{
"id": "14963b6d-b955-4376-87f4-667a30023117",
"type": "job_opening",
"attributes": {
"title": "Frontend Engineer",
"url": "https://www.prisma.io/jobs",
"first_seen_at": "2018-10-28T17:20:51Z",
"last_seen_at": "2018-10-28T17:20:51Z",
"job_opening_closed": true,
"categories": [
"engineering"
],
"additional_data": {
"job_title": "Frontend Engineer",
"job_title_seniority": "undefined",
"tags": []
}
}
},
{
"id": "3a68ecf3-c8f3-45e8-8f64-15f16da0e866",
"type": "job_opening",
"attributes": {
"title": "Developer Advocate",
"url": "https://www.prisma.io/jobs",
"first_seen_at": "2018-10-28T17:20:51Z",
"last_seen_at": "2018-10-28T17:20:51Z",
"job_opening_closed": true,
"categories": [
"engineering",
"software_development"
],
"additional_data": {
"job_title": "Developer Advocate",
"job_title_seniority": "undefined",
"tags": []
}
}
},
{
"id": "1f17c3c8-0fce-4d33-a55b-237c0c3a6fce",
"type": "job_opening",
"attributes": {
"title": "Open Source Engineer",
"url": "https://www.prisma.io/jobs",
"first_seen_at": "2018-08-12T09:44:28Z",
"last_seen_at": "2018-08-12T09:44:28Z",
"job_opening_closed": true,
"categories": [
"engineering"
],
"additional_data": {
"job_title": "Open Source Engineer",
"job_title_seniority": "undefined",
"tags": []
}
}
},
{
"id": "331dd1e8-b6ef-4ae5-8f3f-2ff0eb4e6bc9",
"type": "technology",
"attributes": {
"categories": [
"programming_languages"
],
"domain": "nodejs.org",
"first_seen_at": "2018-07-07T13:21:17Z",
"last_seen_at": "2019-03-22T17:44:15Z",
"url": "https://www.prisma.io",
"title": "Node.js"
}
},
{
"id": "1db191d8-61cb-4a92-883d-33f4fdde05aa",
"type": "technology",
"attributes": {
"categories": [
"payment_processors"
],
"domain": "stripe.com",
"first_seen_at": "2018-12-07T06:53:30Z",
"last_seen_at": "2019-03-22T17:44:15Z",
"url": "https://www.prisma.io",
"title": "Stripe"
}
},
{
"id": "5e1be515-35f9-4686-b198-84e138ca2752",
"type": "technology",
"attributes": {
"categories": [
"java_script_frameworks"
],
"domain": "gatsbyjs.org",
"first_seen_at": "2018-12-07T06:53:30Z",
"last_seen_at": "2019-03-22T17:44:15Z",
"url": "https://www.prisma.io",
"title": "Gatsby"
}
},
{
"id": "4bf78bb7-9081-4baf-920b-7c89f66264c2",
"type": "technology",
"attributes": {
"categories": [
"web_frameworks",
"web_servers"
],
"domain": "zeit.co",
"first_seen_at": "2018-07-07T13:21:17Z",
"last_seen_at": "2019-03-22T17:44:15Z",
"url": "https://www.prisma.io",
"title": "Next.js"
}
},
{
"id": "ad228ce9-934d-4981-8903-32fb4fdf7321",
"type": "technology",
"attributes": {
"categories": [
"build_ci_systems"
],
"domain": null,
"first_seen_at": "2018-07-07T13:21:17Z",
"last_seen_at": "2019-03-22T17:44:15Z",
"url": "https://www.prisma.io",
"title": "webpack"
}
},
{
"id": "1bf2a9e2-f9b3-462b-8c9b-b7143f3d7a8f",
"type": "technology",
"attributes": {
"categories": [
"customer_messaging_platform",
"chat_software"
],
"domain": null,
"first_seen_at": "2018-07-07T13:21:17Z",
"last_seen_at": "2019-03-22T17:44:15Z",
"url": "https://www.prisma.io",
"title": "Intercom"
}
},
{
"id": "42c17e76-355b-4ffd-bcbb-a88d7b74f26d",
"type": "technology",
"attributes": {
"categories": [
"programming_languages",
"operating_systems_&_computing_languages"
],
"domain": null,
"first_seen_at": "2018-07-07T13:21:17Z",
"last_seen_at": "2019-03-22T17:44:15Z",
"url": "https://www.prisma.io",
"title": "React"
}
},
{"...": "..."}
]
}
Returns all data points you are subscribed to for the requested domain name. Eg.: Events, Job Openings, Technologies and Connections.
This format is also used when exporting via flat files. Returned is one JSON formatted file with one website per line. Each line contains all data related to the website. If you’d like us to export in a different format please do let us know, we are flexible.
HTTP Request
GET https://predictleads.com/api/v2/companies/:domain
Request Parameters
| Parameter | Description |
|---|---|
limit |
string Limit the number of shown events per page. Default is 30, maximum is 100. |
List of event categories and more information on event object is available here.
To get more results use pagination.
Discover
Find companies by querying our database by various parameters.
Discover companies
curl -X GET "https://predictleads.com/api/v2/companies/discover?event_categories=is_developing&locations=CA"
{
"data": [
{
"id": "348068",
"type": "company",
"attributes": {
"domain": "boozallen.com",
"company_name": "Booz Allen Hamilton",
"friendly_company_name": "Booz Allen Hamilton",
"ticker": "NYSE:BAH"
}
},
{
"id": "1483919",
"type": "company",
"attributes": {
"domain": "thermofisher.com",
"company_name": "Thermo Fisher Scientific",
"friendly_company_name": "Thermo Fisher Scientific",
"ticker": "NYSE:TMO"
}
},
{
"id": "368539",
"type": "company",
"attributes": {
"domain": "imagine-one.com",
"company_name": "Imagine One",
"friendly_company_name": "Imagine One",
"ticker": null
}
},
{
"id": "17263540",
"type": "company",
"attributes": {
"domain": "somarylandjobs.com",
"company_name": "Somarylandjobs",
"friendly_company_name": "Somarylandjobs",
"ticker": null
}
},
{
"id": "18781851",
"type": "company",
"attributes": {
"domain": "newjobpursuit.co.uk",
"company_name": null,
"friendly_company_name": null,
"ticker": null
}
},
{
"id": "18248710",
"type": "company",
"attributes": {
"domain": "wificorp.com",
"company_name": "Perfectwifi, Inc.",
"friendly_company_name": "Perfectwifi",
"ticker": null
}
},
{
"id": "17916431",
"type": "company",
"attributes": {
"domain": "waterdistrictjobs.com",
"company_name": null,
"friendly_company_name": null,
"ticker": null
}
},
{
"id": "17509347",
"type": "company",
"attributes": {
"domain": "pilotjobs.io",
"company_name": "Pilothiring",
"friendly_company_name": "Pilothiring",
"ticker": null
}
},
{
"id": "17252621",
"type": "company",
"attributes": {
"domain": "employmentquest.net",
"company_name": "Employmentquest",
"friendly_company_name": "Employmentquest",
"ticker": null
}
},
{
"id": "16807112",
"type": "company",
"attributes": {
"domain": "hellohayward.com",
"company_name": "Hellohayward",
"friendly_company_name": "Hellohayward",
"ticker": null
}
}
],
"meta": {
"count": 21251
}
}
Returns a list of companies that satisfy given query parameters.
HTTP Request
POST https://predictleads.com/api/v2/companies/discover
Request Parameters
| Parameter | Description |
|---|---|
locations |
string List of company locations split by comma (,). Ie.: CA, FL, France. |
event_categories |
string List of event categories split by comma (,). Ie.: hires, launches, invests_into. |
event_tags |
string List of event tags split by comma (,). Ie.: mobile, future_tech, energy. |
job_opening_categories |
string List of job categories split by comma (,). Ie.: marketing, education, software_development. |
technologies |
string List of technologies split 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. |
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 …
To get more results use pagination.
Discover via HN
Find companies that are hiring or launching new products via Hacker News (news.ycombinator.com).
curl -X GET "https://predictleads.com/api/v1/hacker_news_posts/jobs"
{
"data": [
{
"id": "16709",
"type": "hacker_news_posts",
"attributes": {
"company_domain": "irisonboard.com",
"company_name": "Iris Automation Inc.",
"hacker_news_url": "https://news.ycombinator.com/item?id=17635376",
"published_at": "2018-07-29 00:23:42 +0200",
"post_type": "job",
"post_score": 1
}
},
{
"id": "16323",
"type": "hacker_news_posts",
"attributes": {
"company_domain": "motivii.com",
"company_name": "Motivii",
"hacker_news_url": "https://news.ycombinator.com/item?id=17670358",
"published_at": "2018-08-02 12:07:50 +0200",
"post_type": "job",
"score": 7
}
}
],
"meta":{
"count": 37947
}
}
curl -X GET "https://predictleads.com/api/v1/hacker_news_posts/show_hn"
{
"data": [
{
"id": "14325",
"type": "companies",
"attributes": {
"company_domain": "humanapi.co",
"company_name": "Human API",
"hacker_news_url": "https://news.ycombinator.com/item?id=17524524",
"published_at": "2018-07-13 18:48:19 +0200",
"post_type": "show_hn",
"score": 71
}
}
],
"meta":{
"count":20176
}
}
HTTP Request
GET https://predictleads.com/api/v1/hacker_news_posts/jobs
Returns companies that have posted a job opening on Hacker News.
HTTP Request
GET https://predictleads.com/api/v1/hacker_news_posts/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
Company segments enable our customers to personalize outreach and messaging. Leverage buying signals to 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.
You can specify a webhook URL to which we’ll be sending newly found companies that match the segment’s criteria on a regular basis.
Create segment
curl -X POST "https://predictleads.com/api/v1/segments"
-d '{"name":"New segment", "event_categories":"launches", "event_tags":"mobile,online_technology"}'
-H "Content-Type: application/json"
{
"data": {
"id":"721",
"type": "segments",
"attributes": {
"name": "New segment"
}
},
"meta": {
"message": "Segment successfully created.",
"message_type": "segment_created"
}
}
Creates a segment of companies with a set of query parameters.
HTTP Request
POST https://predictleads.com/api/v1/segments
Request Parameters
| Parameter | Description |
|---|---|
name |
string Name of the segment. |
subscription_url |
string We’ll send the data to this URL. |
active |
string Set to “false” to deactivate the segment. |
All /discover parameters can be used to create a segment.
Update segment
curl -X PUT "https://predictleads.com/api/v1/segments/721"
-d '{"subscription_url":"https://requestb.in/2983cn"}'
-H "Content-Type: application/json"
{
"data":{
"id":"721",
"type":"segments",
"attributes":{
"name": "New segment"
}
},
"meta":{
"message": "Segment successfully updated.",
"message_type": "segment_updated"
}
}
Updates the segment.
HTTP Request
PUT https://predictleads.com/api/v1/segments/:id
Request Parameters
| Parameter | Description |
|---|---|
id |
string ID of the segment. |
name |
string Name of the segment. |
subscription_url |
string We’ll send the data to this URL. |
active |
string Set to “false” to deactivate the segment. |
All /discover parameters can be used to update a segment.
Send data
curl -X GET "https://predictleads.com/api/v1/segments/:id/send_data?test=true"
{
"data": {
"id":"21",
"type": "segments",
"attributes": {
"name": "New segment"
}
},
"meta": {
"message": "Segment data successfully sent.",
"message_type": "segment_data_sent"
}
}
Example of data sent to subscription url
{
"data":[
{
"domain":"acast.com",
"company_name":"Acast",
"events":[
{
"id": "7175c775-bdac-4a1e-b4d0-c8264a03baa2",
"type": "events",
"attributes":{
"categories":[
"launches"
],
"title": "Acast launches app for Windows 10 devices on Jul 14th 16'.",
"url": "http://mspoweruser.com/acast-for-windows-10-now-available/",
"found_at": "2016-07-14T15:58:07Z",
"additional_data": {
"product": "app for Windows 10 devices",
"product_tags": [
"mobile",
"online_technology"
],
"date":"2016-07-14"
}
},
"relationships":{
"companies":{
"data":[
{
"type":"companies",
"domain":"acast.com"
}
]
}
}
}
]
},
{
"domain":"breezie.com",
"company_name":"Breezie Inc.",
"events":[
{
"id":"671d0686-65a3-46d2-8047-c8b9f7dd6186",
"type":"events",
"attributes":{
"categories":[
"is_developing"
],
"title":"Breezie Inc. is developing tablet solution for seniors",
"url":"http://www.crn.com.au/news/samsung-australia-and-ethan-group-team-up-to-bring-tablets-to-seniors-442801",
"found_at":"2016-11-28T12:10:17Z",
"additional_data":{
"product":"tablet solution for seniors",
"product_tags":[
"mobile"
]
}
},
"relationships":{
"companies":{
"data":[
{
"type":"companies",
"domain":"breezie.com"
}
]
}
}
}
]
}
]
}
Sends a list of companies within the segment to the segment’s subscription url instantly. Set test to “true” in sandbox mode.
HTTP Request
GET https://predictleads.com/api/v1/segments/:id/send_data
Request Parameters
| Parameter | Description |
|---|---|
id |
string ID of the segment. |
test |
string Set to “true” for testing purposes. |
Get data
curl -X GET "https://predictleads.com/api/v1/segments/:id/get_data"
Returns the list of companies within the segment
HTTP Request
GET https://predictleads.com/api/v1/segments/:id/get_data
Request Parameters
| Parameter | Description |
|---|---|
id |
string ID of the segment. |
Signal objects
Listed here are all types of returned signal objects.
Event
Examples of event objects
{
"data": [
{
"id": "7fd6446e-d552-4115-86ed-fd43393228ef",
"type": "event",
"attributes": {
"categories": [
"receives_financing"
],
"title": "Aquasec received financing of $62M in Series C funding round on Apr 3rd 19'.",
"found_at": "2019-04-03T04:20:42Z",
"url": "https://techbizweb.com/code-execution-dos-flaws-patched-in-advantech-webaccess/",
"additional_data": {
"financing_type": "Series C funding round",
"funding_round": "Series C",
"financing_type_tags": [
"equity"
],
"amount": 62000000,
"date": "2019-04-03",
"article_title": "Code Execution, DoS Flaws Patched in Advantech WebAccess",
"article_sentence": "Long equipment life cycles and other factors expose manufacturing companies to a wide range of threats, according to a new report published on Wednesday... Aqua Security, a company that specializes in protecting container-based applications, on Wednesday announced that it raised $62 million in a Series C funding round.",
"article_source": "techbizweb.com",
"article_published_at": "2019-04-03T14:01:00.000Z",
"confidence": "0.3212"
}
},
"relationships": {}
},
{
"id": "7f494808-1131-4040-bfaa-b555b439b537",
"type": "event",
"attributes": {
"categories": [
"invests_into"
],
"title": "Insight Partners invested into Aquasec in $62M on Apr 3rd 19'.",
"found_at": "2019-04-03T08:20:42Z",
"url": "https://techcrunch.com/2019/04/03/container-security-startup-aqua-lands-62m-series-c/",
"additional_data": {
"amount": 62000000,
"date": "2019-04-03",
"article_title": "Container security startup Aqua lands $62M Series C – TechCrunch",
"article_sentence": "Aqua Security, a startup that helps customers launch containers securely, announced a $62 million Series C investment today led by Insight Partners.",
"article_source": "techcrunch.com",
"article_published_at": "2019-04-03T10:20:42.000Z",
"confidence": "0.6164"
}
},
"relationships": {
"company1": {
"data": {
"id": "5734658",
"type": "company"
}
},
"company2": {
"data": {
"id": "2680287",
"type": "company"
}
}
}
},
{
"id": "4cfea9f7-5d35-4b14-9377-7c933a2f88ed",
"type": "event",
"attributes": {
"categories": [
"partners_with"
],
"title": "Aquasec partners with Datadog, Inc.",
"found_at": "2019-01-15T06:00:17Z",
"url": "https://containerjournal.com/2019/01/15/aqua-security-partners-with-datadog-to-advance-container-security/",
"additional_data": {
"article_title": "Aqua Security Partners with Datadog to Advance Container Security",
"article_sentence": "With that goal in mind, Aqua Security has partnered with Datadog, a provider of IT monitoring services, to make it easier to consume security metrics alongside IT operational data.",
"article_source": "containerjournal.com",
"article_author": "Mike Vizard",
"article_published_at": "2019-01-15T07:00:17.000Z",
"confidence": "0.8278"
}
},
"relationships": {
"company1": {
"data": {
"id": "2680287",
"type": "company"
}
},
"company2": {
"data": {
"id": "653124",
"type": "company"
}
}
}
},
{
"id": "10ba1a05-b4d8-4b7f-832d-970249d665fc",
"type": "event",
"attributes": {
"categories": [
"launches"
],
"title": "Aquasec launches two offerings for ECS: a Pay as You Go",
"found_at": "2018-11-27T18:00:57Z",
"url": "https://blog.aquasec.com/security-for-amazon-ecs-workloads",
"additional_data": {
"product": "two offerings for ECS: a Pay as You Go",
"product_data": {
"full_text": "two offerings for ECS: a Pay as You Go",
"fuzzy_match": true
},
"article_title": "How to Secure Amazon ECS Workloads On Demand",
"article_sentence": "Aqua has launched two offerings for ECS: a Pay as You Go (PAYG) offering and a Bring Your Own License (BYOL) offering.",
"article_source": "aquasec.com",
"article_author": "John Michealson",
"article_published_at": "2018-11-27T19:00:57.000Z",
"confidence": "1.0"
}
},
"relationships": {}
},
{
"id": "a5f6d7f7-c82d-4fd2-b624-d5ce125170ab",
"type": "event",
"attributes": {
"categories": [
"recognized_as"
],
"title": "Aquasec recognized as 2018 CRN Tech Innovator Awards finalist on Nov 12th 18'.",
"found_at": "2018-11-12T14:05:38Z",
"url": "http://www.sys-con.com/node/4344659",
"additional_data": {
"recognition": "2018 CRN Tech Innovator Awards finalist",
"date": "2018-11-12",
"article_title": "Aqua Security Named Finalist in the 2018 CRN® Tech Innovator Awards | SYS-CON MEDIA",
"article_sentence": "Aqua Security, the leading platform provider for securing container-based and cloud native applications, today announced that CRN, ® a brand of The Channel Company, has recognized Aqua as a 2018 CRN Tech Innovator Awards finalist.",
"article_source": "sys-con.com",
"article_published_at": "2018-11-12T15:05:38.000Z",
"confidence": "0.6412"
}
},
"relationships": {}
},
{
"id": "edca99aa-09d3-45b2-9006-02e6aaf23a30",
"type": "event",
"attributes": {
"categories": [
"launches"
],
"title": "Aquasec launched upgraded version of security platform for cloud known as 3.5 on Nov 1st 18'.",
"found_at": "2018-06-20T00:00:00Z",
"url": "https://markets.businessinsider.com/news/stocks/aqua-introduces-runtime-protection-against-zero-day-vulnerabilities-for-containerized-applications-1027377890",
"additional_data": {
"product": "upgraded version of security platform for cloud known as 3.5",
"product_tags": [
"online_technology",
"general_technology",
"security"
],
"product_data": {
"full_text": "upgraded version of security platform for cloud known as 3.5",
"fuzzy_match": true,
"release_type": "upgraded version"
},
"date": "2018-11-01",
"article_title": "Aqua Introduces Runtime Protection Against \"Zero Day\" Vulnerabilities for Containerized Applications | Markets Insider",
"article_sentence": "Aqua Security, the market-leading platform provider for securing container-based and cloud-native applications, today announced version 3.2 of its cloud-native security platform, featuring deep runtime protection capabilities and extended security and compliance controls across the cloud-native stack.",
"article_source": "businessinsider.com",
"article_published_at": "2018-07-18T12:59:09.000Z",
"confidence": "0.9797"
}
},
"relationships": {}
},
{
"id": "bfa61308-c731-47d5-8b2e-4841da4e49cb",
"type": "event",
"attributes": {
"categories": [
"launches"
],
"title": "Aquasec launches Pivotal Cloud Foundry service",
"found_at": "2018-10-12T14:49:59Z",
"url": "https://www.sdxcentral.com/articles/news/sdxcentrals-weekly-roundup-october-12-2018/2018/10/",
"additional_data": {
"product": "Pivotal Cloud Foundry service",
"product_tags": [
"online_technology"
],
"product_data": {
"full_text": "Pivotal Cloud Foundry service",
"fuzzy_match": true
},
"article_title": "SDxCentral's Weekly Roundup — October 12, 2018",
"article_sentence": "Aqua Security released general availability of its integrated Pivotal Cloud Foundry service.",
"article_source": "sdxcentral.com",
"article_published_at": "2018-10-12T16:49:59.000Z",
"confidence": "0.5188"
}
},
"relationships": {}
},
{
"id": "5ab545e1-2134-447c-8bd0-af5545162681",
"type": "event",
"attributes": {
"categories": [
"partners_with"
],
"title": "Hitachi Vantara Corp. partners with Aquasec",
"found_at": "2018-09-26T03:01:27Z",
"url": "https://channellife.co.nz/story/hitachi-vantara-announces-improved-container-security-and-multicloud-support-for-devops-and-data-services",
"additional_data": {
"article_title": "ChannelLife New Zealand",
"article_sentence": "Hitachi Vantara is partnering with Aqua Security to add security capabilities to the HEC Container Platform service that enable customers to safely move their mission-critical applications to an agile, cloud-native platform.",
"article_source": "channellife.co.nz",
"article_published_at": "2018-09-27T23:26:15.000Z",
"confidence": "0.5758"
}
},
"relationships": {
"company1": {
"data": {
"id": "2773207",
"type": "company"
}
},
"company2": {
"data": {
"id": "2680287",
"type": "company"
}
}
}
}
],
"included": [
{
"id": "5734658",
"type": "company",
"attributes": {
"domain": "insightpartners.net",
"company_name": "Insight Partners"
}
},
{
"id": "2680287",
"type": "company",
"attributes": {
"domain": "aquasec.com",
"company_name": "Aquasec"
}
},
{
"id": "653124",
"type": "company",
"attributes": {
"domain": "datadoghq.com",
"company_name": "Datadog, Inc."
}
},
{
"id": "2773207",
"type": "company",
"attributes": {
"domain": "hitachivantara.com",
"company_name": "Hitachi Vantara Corp."
}
},
{
"id": "1709177",
"type": "company",
"attributes": {
"domain": "google.com",
"company_name": "Google Inc."
}
}
]
}
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. |
| 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. |
| 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. |
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
[
{
"id": "e1a7d41f-91cd-43d3-98c6-400ea57d98b7",
"type": "job_opening",
"attributes": {
"title": "Salesforce Developer",
"url": "https://segment.com/jobs/1318493-Salesforce-Developer/",
"first_seen_at": "2018-12-19T23:38:24Z",
"last_seen_at": "2019-03-21T05:10:18Z",
"job_opening_closed": false,
"categories": [
"engineering",
"software_development"
],
"additional_data": {
"job_title": "Salesforce Developer",
"job_title_seniority": "undefined",
"tags": []
}
}
},
{
"id": "91888346-e8ab-4b7a-bd22-7a72ad31bd0d",
"type": "job_opening",
"attributes": {
"title": "Strategic Customer Success Manager",
"url": "https://segment.com/jobs/1414761-Strategic-Customer-Success-Manager/",
"first_seen_at": "2018-12-19T23:38:24Z",
"last_seen_at": "2019-03-20T03:16:39Z",
"job_opening_closed": false,
"categories": [
"sales",
"management"
],
"additional_data": {
"job_title": "Strategic Customer Success Manager",
"job_title_seniority": "management",
"tags": []
}
}
},
{
"id": "dd3f183e-85db-4290-9b3f-92dacd3d115b",
"type": "job_opening",
"attributes": {
"title": "Data Engineer",
"url": "https://segment.com/jobs/1409549-Data-Engineer/",
"first_seen_at": "2018-12-19T23:38:24Z",
"last_seen_at": "2018-12-19T23:38:24Z",
"job_opening_closed": false,
"categories": [
"engineering",
"information_technology",
"data_analysis"
],
"additional_data": {
"job_title": "Data Engineer",
"job_title_seniority": "undefined",
"tags": []
}
}
}
]
| 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. |
| categories | array Array of categories - full list below. |
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. |
Job opening can be deemed closed if “job_opening_closed” attribute is set to true or if last_seen_at data is over 3 months old. We check job websites once per month or even more frequently but sometimes website content might not load fully if eg. website is under load or if some other network error happens. We then retry them up to five times with ever longer retry delays. That is why we suggest a number as high as 3 months to be taken for the job to be deemed closed.
Job opening categories
["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", "business_analysis", "support", "data_analysis"]
Job opening seniority
["undefined", "president", "upper_management", "middle_management", "lower_management", "management", "senior"]
Below keywords need to appear in the job title to return a seniority match.
president: President, CEO, Chairman
upper_management: Chief #{Something} Officer, Superintendent, Treasurer, Chief of Staff …
middle_management: VP, Vice President
lower_management: Director
management: Manager
senior: Senior, Sr.
Technology
Examples of technology objects
[
{
"id": "b0b2f9e9-faa0-418a-9de4-b2210a34c55a",
"type": "technology",
"attributes": {
"categories": [
"marketing",
"marketing_automation"
],
"domain": "pardot.com",
"first_seen_at": "2017-07-04T12:50:23Z",
"last_seen_at": "2017-07-04T12:50:23Z",
"url": "https://www.marketo.com",
"title": "Pardot"
}
},
{
"id": "c6d12857-d96c-4a80-a2b9-c40ce2206e31",
"type": "technology",
"attributes": {
"categories": [
"marketing_analytics",
"marketing_performance_measurement",
"marketing_automation",
"marketing",
"sales",
"inbound",
"crm"
],
"domain": "hubspot.com",
"first_seen_at": "2017-07-04T12:50:23Z",
"last_seen_at": "2017-07-04T12:50:23Z",
"url": "https://www.marketo.com",
"title": "HubSpot"
}
},
{
"id": "3cd39b75-3a68-4241-918b-5c070c7dd2f1",
"type": "technology",
"attributes": {
"categories": [
"programming_languages",
"operating_systems_&_computing_languages"
],
"domain": "scala-lang.org",
"first_seen_at": "2017-07-04T12:50:17Z",
"last_seen_at": "2017-07-04T12:50:17Z",
"url": "https://www.marketo.com",
"title": "Scala"
}
}
]
| 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. |
Technology categories
["cms", "ecommerce", "miscellaneous", "web_servers", "analytics", "advertising_networks", "widgets", "web_frameworks", "editors", "documentation_tools", "blogs", "cdn", "search_engines", "javascript_frameworks", "databases", "wikis", "message_boards", "dev_tools", "programming_languages", "issue_trackers", "database_managers", "video_players", "printers", "rich_text_editors", "operating_systems", "lms", "photo_galleries", "font_scripts", "javascript_graphics", "hosting_panels", "comment_systems", "marketing_automation", "mobile_frameworks", "build_ci_systems", "payment_processors", "maps", "cache_tools", "web_server_extensions", "tag_managers", "webcams", "network_devices", "remote_access", "document_management_systems", "media_servers", "captchas", "web_mail", "paywalls", "feed_readers", "control_systems", "network_storage", "landing_page_builders"]
Connection
Examples of connection objects
{
"data": [
{
"id": "14726429",
"type": "connection",
"attributes": {
"id": 14726429,
"category": "partner",
"source_category": "partner_page",
"source_url": "https://www.aquasec.com/partners/",
"first_seen_at": "2018-11-03T06:51:50Z",
"last_seen_at": "2019-03-26T22:47:37Z"
},
"relationships": {
"company1": {
"data": {
"id": "2680287",
"type": "company"
}
},
"company2": {
"data": {
"id": "1113576",
"type": "company"
}
}
}
},
{
"id": "15420791",
"type": "connection",
"attributes": {
"id": 15420791,
"category": "integration",
"source_category": "integration_page",
"source_url": "https://www.aquasec.com/integrations/",
"first_seen_at": "2019-01-17T18:41:50Z",
"last_seen_at": "2019-03-26T22:47:36Z"
},
"relationships": {
"company1": {
"data": {
"id": "2680287",
"type": "company"
}
},
"company2": {
"data": {
"id": "1399238",
"type": "company"
}
}
}
},
{
"id": "15420792",
"type": "connection",
"attributes": {
"id": 15420792,
"category": "other",
"source_category": "undefined",
"source_url": "https://www.aquasec.com/integrations/",
"first_seen_at": "2019-01-17T18:41:50Z",
"last_seen_at": "2019-03-26T22:47:36Z"
},
"relationships": {
"company1": {
"data": {
"id": "2680287",
"type": "company"
}
},
"company2": {
"data": {
"id": "1408745",
"type": "company"
}
}
}
},
...
],
"included": [
{
"id": "2680287",
"type": "company",
"attributes": {
"domain": "aquasec.com",
"company_name": "Aquasec"
}
},
{
"id": "1113576",
"type": "company",
"attributes": {
"domain": "accenture.com",
"company_name": "Accenture Inc."
}
},
{
"id": "1399238",
"type": "company",
"attributes": {
"domain": "amazon.com",
"company_name": "Amazon Inc."
}
},
{
"id": "1408745",
"type": "company",
"attributes": {
"domain": "brighttalk.com",
"company_name": "BrightTALK Ltd."
}
},
...
],
"meta": {
"count": 14
}
}
| Attribute | Description |
|---|---|
| id | integer Unique connection identifier (unique across all trigger types). |
| category | string Connection category. 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", "sponsor", "holding", "parent", "rebranding", "other"
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! Get your sh** together boys!!!’”
{
"meta": "Event flagged"
}
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 |
|---|---|
| 200 | SUCCESS - Request was successfully processed. |
| 400 | BAD REQUEST - Request message framing was invalid. The server cannot or will not process the request. |
| 401 | UNAUTHORIZED ACCESS - Authentication failed. Check again your credentials or contact us. |
| 404 | NOT FOUND - Specified company is not in our database. Check again in 24h. |
| 500 | INTERNAL SERVER ERROR – We had a problem with our server. Try again later. |