NAV Navbar
Logo pl
curl

Introduction

The PredictLeads APIs are used to discover new companies or enrich company profiles with insights. Use cases range from CRM enrichment with account intelligence to lead generation using our set of buying signals.

Our APIs are RESTful with responses delivered in JSON and XML format.

In order to use this API, you must first register with PredictLeads to get an authentication token. Register here.

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 of data we’ll POST to your Webhook.

[
   {
      "data":{
         "id":"10044446",
         "type":"triggers",
         "attributes":{
            "type":"events",
            "domain":"amazon.com",
            "company_name":"Amazon Inc.",
            "categories":[
               "partners_with"
            ],
            "title":"Amazon Inc. partners with Panther Group",
            "url":"https://www.panthergroup.co.uk/amazon-selects-panther-to-support-its-heavy-and-large-delivery-programme/",
            "found_at":"2018-08-23T10:45:03Z",
            "importance":0.72,
            "additional_data":{
               "article_title":"Amazon selects Panther to support its 'heavy and large' delivery programme",
               "article_sentence":"Panther Warehousing, the pioneer of two-man, white-glove, next-day delivery, has been working with Amazon to support its new ‘Heavy and Large’ delivery programme for bulky goods such as sofas, beds and other large items.",
               "article_source":"panthergroup.co.uk",
               "article_author":"David Jenkins",
               "article_published_at":"2018-08-23T12:45:03.000Z",
               "confidence":"0.7596"
            }
         }
     }
   }
]

Example of 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": "events",
            "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": "events",
            "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": "2e556693-350a-49a0-a9b6-9037398d3724",
            "type": "events",
            "attributes": {
                "categories": [
                    "launches"
                ],
                "title": "Segment launched Customer Data Infrastructure on Sep 20th 18'.",
                "found_at": "2018-09-20T12:41:59Z",
                "additional_data": {
                    "product": "Customer Data Infrastructure",
                    "product_tags": [
                        "data"
                    ],
                    "product_data": {
                        "full_text": "Customer Data Infrastructure",
                        "fuzzy_match": true
                    },
                    "date": "2018-09-20",
                    "article_title": "Segment Introduces Customer Data Infrastructure",
                    "article_sentence": "Today at Synapse, Segment introduced Customer Data Infrastructure (CDI), a new software category that gives companies the data foundation they need to put their customers at the heart of every decision.",
                    "article_source": "globenewswire.com",
                    "article_published_at": "2018-09-20T16:41:59.000Z",
                    "confidence": "0.8164"
                },
                "url": "https://globenewswire.com/news-release/2018/09/20/1573965/0/en/Segment-Introduces-Customer-Data-Infrastructure.html"
            }
        },
        {
            "id": "612e4135-5277-4ae6-ae42-4ff86f59b41e",
            "type": "events",
            "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": "d014b611-8e37-4355-a689-e46e42aa8b6e",
            "type": "events",
            "attributes": {
                "categories": [
                    "partners_with"
                ],
                "title": "MoEngage partners with Segment",
                "found_at": "2018-07-03T05:48:03Z",
                "additional_data": {
                    "article_title": "MoEngage partners with Sengrid's email delivery platform",
                    "article_sentence": "MoEngage has been working with partners like Branch and Segment to create engagement and growth platform for marketers.",
                    "article_source": "crn.in",
                    "article_published_at": "2018-07-03T07:48:03.000Z",
                    "confidence": "0.7743",
                    "human_approved": true
                },
                "url": "https://www.crn.in/news/moengage-partners-with-sengrids-email-delivery-platform/"
            },
            "relationships": {
                "company1": {
                    "data": {
                        "id": "1588376",
                        "type": "companies"
                    }
                },
                "company2": {
                    "data": {
                        "id": "1474306",
                        "type": "companies"
                    }
                }
            }
        },
        {
            "id": "6abdd948-93d9-4bea-8c4c-65db155f7249",
            "type": "events",
            "attributes": {
                "categories": [
                    "launches"
                ],
                "title": "Segment launches Snowflake to the Segment platform",
                "found_at": "2018-04-18T22:00:00Z",
                "additional_data": {
                    "product": "Snowflake to the Segment platform",
                    "product_tags": [
                        "online_technology",
                        "general_technology"
                    ],
                    "product_data": {
                        "full_text": "Snowflake to the Segment platform",
                        "fuzzy_match": true
                    },
                    "article_title": "Snowflake is now available on Segment · Segment Blog",
                    "article_sentence": "To help you access your data without the extra leg work, Segment has added Snowflake to the Segment platform as a new data warehouse Destination.",
                    "article_source": "segment.com",
                    "article_published_at": "2018-04-19T00:00:00.000Z",
                    "confidence": "0.9578"
                },
                "url": "https://segment.com/blog/snowflake-is-now-available-on-segment/"
            }
        },
        {
            "id": "e456949f-b62d-4912-9f24-1fb88fb244d8",
            "type": "events",
            "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": "companies"
                    }
                },
                "company2": {
                    "data": {
                        "id": "1474306",
                        "type": "companies"
                    }
                }
            }
        },
        {
            "id": "eba75978-2ab6-47fe-9292-be8aa806c738",
            "type": "events",
            "attributes": {
                "categories": [
                    "partners_with"
                ],
                "title": "Swrve partnered with Segment on Jan 11th 18'.",
                "found_at": "2018-01-09T21:00:00Z",
                "additional_data": {
                    "date": "2018-01-11",
                    "article_title": "Swrve Team Up With Segment! | Swrve",
                    "article_sentence": "That’s the kind of insight you can really act on - and that’s why Swrve is delighted to partner with Segment to help make it happen.",
                    "article_source": "swrve.com",
                    "article_published_at": "2018-01-15T00:00:00.000Z",
                    "confidence": "0.742",
                    "human_approved": true
                },
                "url": "https://www.swrve.com/weblog/swrve-team-up-with-segment"
            },
            "relationships": {
                "company1": {
                    "data": {
                        "id": "124107",
                        "type": "companies"
                    }
                },
                "company2": {
                    "data": {
                        "id": "1474306",
                        "type": "companies"
                    }
                }
            }
        },
        {
            "id": "5ced1d9a-3974-407c-851e-2f207177c477",
            "type": "events",
            "attributes": {
                "categories": [
                    "launches"
                ],
                "title": "Segment launched Looker Source on Jul 28th 17'.",
                "found_at": "2017-07-28T00:49:31Z",
                "additional_data": {
                    "product": "Looker Source",
                    "product_data": {
                        "full_text": "Looker Source",
                        "fuzzy_match": true
                    },
                    "date": "2017-07-28",
                    "article_title": "Customer data platform Segment adds Looker Source to define audiences from multiple tools",
                    "article_sentence": "This week, Segment and business intelligence provider Looker have announced a new product called Looker Source.",
                    "article_source": "martechtoday.com",
                    "article_published_at": "2017-07-28T02:49:31.000Z",
                    "confidence": "1.0"
                },
                "url": "https://martechtoday.com/segment-adds-looker-source-define-audiences-multiple-tools-201615"
            }
        },
        {
            "id": "087b423b-ddd6-49f5-a263-d981fc24dc17",
            "type": "events",
            "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": "10a64ea3-0756-4cec-8efb-a51fbf1ab026",
            "type": "events",
            "attributes": {
                "categories": [
                    "invests_into"
                ],
                "title": "Y Combinator invested into Segment in $64M on Jul 13th 17'.",
                "found_at": "2017-07-13T10:19:00Z",
                "additional_data": {
                    "amount": 64000000,
                    "date": "2017-07-13",
                    "article_title": "Segment Raises $64 Million to Set the Standard for Customer Data Infrastructure",
                    "article_sentence": "Segment, the customer data platform, today announced it raised $64 million in Series C funding led by the Y Combinator Continuity Fund and GV.",
                    "article_source": "marketwired.com",
                    "article_published_at": "2017-07-13T14:19:03.000Z",
                    "confidence": "0.567"
                },
                "url": "http://www.marketwired.com/press-release/segment-raises-64-million-to-set-the-standard-for-customer-data-infrastructure-2225996.htm"
            },
            "relationships": {
                "company1": {
                    "data": {
                        "id": "1494294",
                        "type": "companies"
                    }
                },
                "company2": {
                    "data": {
                        "id": "1474306",
                        "type": "companies"
                    }
                }
            }
        },
        {
            "id": "97e3c0bc-1eca-4c9b-906e-3a0e334c4b51",
            "type": "events",
            "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/"
            }
        },
        {
            "id": "adb2bc0d-5516-414d-a82f-68a2638ed35e",
            "type": "events",
            "attributes": {
                "categories": [
                    "launches"
                ],
                "title": "Segment launched Cross-Domain Analytics on Jun 7th 17'.",
                "found_at": "2017-06-07T05:32:31Z",
                "additional_data": {
                    "product": "Cross-Domain Analytics",
                    "product_tags": [
                        "data"
                    ],
                    "product_data": {
                        "full_text": "Cross-Domain Analytics",
                        "fuzzy_match": true
                    },
                    "date": "2017-06-07",
                    "article_title": "Segment Unveils Cross-Domain Analytics, Now Brands Can Understand Customer Activity Across Their Digital Properties, Without Exposing User Data to Third Parties | 06/06/17 | Markets Insider",
                    "article_sentence": "Segment, the customer data platform, today introduced Cross-Domain Analytics, a new feature that enables brands to unify user data across all of their domains without using third-party data aggregators.",
                    "article_source": "businessinsider.com",
                    "article_published_at": "2017-06-07T07:32:31.000Z",
                    "confidence": "1.0"
                },
                "url": "http://markets.businessinsider.com/news/stocks/Segment-Unveils-Cross-Domain-Analytics-Now-Brands-Can-Understand-Customer-Activity-Across-Their-Digital-Properties-Without-Exposing-User-Data-to-Third-Parties-1002071555"
            }
        },
        {
            "id": "bf1d95b7-2e14-49f9-8df4-b455c676e417",
            "type": "events",
            "attributes": {
                "categories": [
                    "partners_with"
                ],
                "title": "Iterable, Inc. partners with Segment",
                "found_at": "2017-03-23T15:01:12Z",
                "additional_data": {
                    "article_title": "Optimize Your Marketing Messaging With Smarter Metrics",
                    "article_sentence": "To enable this 360-degree customer view, Iterable has teamed up with Segment on its whitepaper, “Optimize Your Marketing Messaging With Smarter Metrics.”",
                    "article_source": "iterable.com",
                    "article_published_at": "2017-03-23T16:01:12.000Z",
                    "confidence": "1.0"
                },
                "url": "https://blog.iterable.com/optimize-your-marketing-messaging-with-smarter-metrics-b75b21f1b08b?source=rss----53cf10fda248---4"
            },
            "relationships": {
                "company1": {
                    "data": {
                        "id": "1442041",
                        "type": "companies"
                    }
                },
                "company2": {
                    "data": {
                        "id": "1474306",
                        "type": "companies"
                    }
                }
            }
        },
        {
            "id": "3aac5bb7-aa47-4a9f-be0c-5dad601c4e34",
            "type": "events",
            "attributes": {
                "categories": [
                    "receives_financing"
                ],
                "title": "Segment receives financing of $64M in Series C funding",
                "found_at": "2016-04-03T14:00:00Z",
                "additional_data": {
                    "financing_type": "Series C funding",
                    "funding_round": "Series C",
                    "financing_type_tags": [
                        "equity"
                    ],
                    "amount": 64000000,
                    "article_title": "Segment Raises $64m · Segment Blog",
                    "article_sentence": "Segment is excited to share that Segment has raised $64 million in Series C funding, led by Y Combinator Continuity and joined by GV.",
                    "article_source": "segment.com",
                    "article_published_at": "2016-04-04T00:00:00.000Z",
                    "confidence": "1.0"
                },
                "url": "https://segment.com/blog/segment-raises-64m/"
            }
        },
        ...
    ],
    "included": [
        {
            "id": "1588376",
            "type": "companies",
            "attributes": {
                "domain": "moengage.com",
                "company_name": "MoEngage"
            }
        },
        {
            "id": "1474306",
            "type": "companies",
            "attributes": {
                "domain": "segment.com",
                "company_name": "Segment"
            }
        },
        {
            "id": "3500291",
            "type": "companies",
            "attributes": {
                "domain": "snowflake.com",
                "company_name": "Snowflake"
            }
        },
        {
            "id": "124107",
            "type": "companies",
            "attributes": {
                "domain": "swrve.com",
                "company_name": "Swrve"
            }
        },
        {
            "id": "1494294",
            "type": "companies",
            "attributes": {
                "domain": "ycombinator.com",
                "company_name": "Y Combinator"
            }
        },
        {
            "id": "1442041",
            "type": "companies",
            "attributes": {
                "domain": "iterable.com",
                "company_name": "Iterable, Inc."
            }
        }
    ],
    "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.

Note: when event type is eg. “partners_with” when you have two companies involved, you can get the connected company2 domain name and friendly name under key “included” in json results - by matching company2 id.

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 (,).
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_openings",
            "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_openings",
            "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": "ab41cba8-1ab6-4684-bf0a-b818c22b84a7",
            "type": "job_openings",
            "attributes": {
                "categories": [
                    "marketing",
                    "directors"
                ],
                "title": "Marketing - Director of Marketing",
                "url": "https://boards.greenhouse.io/zapier/jobs/4136044002",
                "first_seen_at": "2018-12-19T23:02:57Z",
                "last_seen_at": "2019-01-19T06:07:54Z",
                "job_opening_closed": null,
                "additional_data": {
                    "job_title": "Marketing - Director of Marketing",
                    "job_title_seniority": "lower_management",
                    "tags": []
                }
            }
        },
        {
            "id": "ce46a20e-ba8a-47ca-8cfd-1742fc991644",
            "type": "job_openings",
            "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": "f0e3aa39-6bd2-40bd-a4e8-0593835c9d5b",
            "type": "job_openings",
            "attributes": {
                "categories": [
                    "management"
                ],
                "title": "Marketing - Partner Manager - Launches",
                "url": "https://boards.greenhouse.io/zapier",
                "first_seen_at": "2018-11-09T20:57:25Z",
                "last_seen_at": "2019-01-20T05:04:19Z",
                "job_opening_closed": null,
                "additional_data": {
                    "job_title": "Marketing - Partner Manager - Launches",
                    "job_title_seniority": "management",
                    "tags": []
                }
            }
        },
        {
            "id": "71c88f84-3628-41e8-863e-3a0332143ab0",
            "type": "job_openings",
            "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": "94001c25-c24e-4423-9872-738c04afbb9e",
            "type": "job_openings",
            "attributes": {
                "categories": [
                    "support"
                ],
                "title": "North American Support - Customer Champion - Weekend Warrior",
                "url": "https://boards.greenhouse.io/zapier/jobs/4101880002",
                "first_seen_at": "2018-11-09T20:57:25Z",
                "last_seen_at": "2019-01-18T16:47:07Z",
                "job_opening_closed": null,
                "additional_data": {
                    "job_title": "North American Support - Customer Champion - Weekend Warrior",
                    "job_title_seniority": "undefined",
                    "tags": []
                }
            }
        },
        {
            "id": "483e272a-1dab-4d65-873c-e6538c6919e3",
            "type": "job_openings",
            "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_openings",
            "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_openings",
            "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": []
                }
            }
        },
        {
            "id": "a1debe50-29c4-41a0-b432-49ded6e050d7",
            "type": "job_openings",
            "attributes": {
                "categories": [
                    "information_technology",
                    "data_analysis"
                ],
                "title": "Data Scientist - Growth",
                "url": "https://zapier.com/jobs/data-scientist-growth-Q1-2018/",
                "first_seen_at": "2018-03-05T01:02:30Z",
                "last_seen_at": "2018-03-05T01:05:51Z",
                "job_opening_closed": null,
                "additional_data": {
                    "job_title": "Data Scientist - Growth",
                    "job_title_seniority": "undefined",
                    "tags": [
                        "Python",
                        "AddThis",
                        "Visual Basic .NET",
                        "Growth",
                        "Google Analytics",
                        "GitHub",
                        "Planet",
                        "Twitter"
                    ]
                }
            }
        },
        {
            "id": "fdc3bea6-9c01-45a2-8ead-6498ae432806",
            "type": "job_openings",
            "attributes": {
                "categories": [
                    "design",
                    "management"
                ],
                "title": "Design - Platform Design Manager",
                "url": "https://zapier.com/jobs/design_manager_q1-2018",
                "first_seen_at": "2018-03-05T01:02:30Z",
                "last_seen_at": "2018-03-05T01:05:38Z",
                "job_opening_closed": null,
                "additional_data": {
                    "job_title": "Design - Platform Design Manager",
                    "job_title_seniority": "management",
                    "tags": [
                        "Visual Basic .NET",
                        "AddThis",
                        "GitHub",
                        "Planet",
                        "Business Development"
                    ]
                }
            }
        },
        {
            "id": "997e467e-9e6b-4afa-a7fb-16a3b5ba3a92",
            "type": "job_openings",
            "attributes": {
                "categories": [
                    "management",
                    "marketing"
                ],
                "title": "Marketing - Contributed Content Manager",
                "url": "https://zapier.com/jobs/contributed-content-manager-Q1-2018",
                "first_seen_at": "2018-01-23T03:33:10Z",
                "last_seen_at": "2018-03-23T03:51:01Z",
                "job_opening_closed": null,
                "additional_data": {
                    "job_title": "Marketing - Contributed Content Manager",
                    "job_title_seniority": "management",
                    "tags": []
                }
            }
        },
        {
            "id": "fa43db72-ec01-4528-ac90-238cc9ae98ba",
            "type": "job_openings",
            "attributes": {
                "categories": [
                    "support",
                    "management"
                ],
                "title": "Support Manager",
                "url": "https://zapier.com/blog/welcome-joshmohland-hoonpark-fokkezanderbergen-zenren",
                "first_seen_at": "2018-01-23T03:33:10Z",
                "last_seen_at": "2018-03-23T03:50:57Z",
                "job_opening_closed": null,
                "additional_data": {
                    "job_title": "Support Manager",
                    "job_title_seniority": "management",
                    "tags": []
                }
            }
        },
        {
            "id": "5528e468-4888-4084-944f-e2833304e08e",
            "type": "job_openings",
            "attributes": {
                "categories": [
                    "information_technology",
                    "data_analysis"
                ],
                "title": "Product - Data Scientist",
                "url": "https://zapier.com/jobs/data-scientist-Q1-2018",
                "first_seen_at": "2018-01-23T03:33:10Z",
                "last_seen_at": "2018-01-23T03:39:55Z",
                "job_opening_closed": null,
                "additional_data": {
                    "job_title": "Product - Data Scientist",
                    "job_title_seniority": "undefined",
                    "tags": []
                }
            }
        },
        {
            "id": "75ae800f-0c76-45eb-90dd-0f4afae97b31",
            "type": "job_openings",
            "attributes": {
                "categories": [
                    "management",
                    "marketing"
                ],
                "title": "Contributed Content Manager",
                "url": "https://zapier.com/jobs/contributed-content-manager-Q1-2018/",
                "first_seen_at": "2018-01-23T03:33:10Z",
                "last_seen_at": "2018-03-23T03:50:56Z",
                "job_opening_closed": null,
                "additional_data": {
                    "job_title": "Contributed Content Manager",
                    "job_title_seniority": "management",
                    "tags": []
                }
            }
        },
        {
            "id": "862f529b-b905-419f-b207-b2f777323e31",
            "type": "job_openings",
            "attributes": {
                "categories": [
                    "engineering",
                    "software_development"
                ],
                "title": "Software Engineer",
                "url": "https://www.linkedin.com/in/mariyadiminsky/?utm_source=zapier.com&utm_medium=referral&utm_campaign=zapier",
                "first_seen_at": "2017-12-05T19:24:26Z",
                "last_seen_at": "2017-12-05T20:12:18Z",
                "job_opening_closed": null,
                "additional_data": {
                    "job_title": "Software Engineer",
                    "job_title_seniority": "undefined",
                    "tags": []
                }
            }
        },
        {
            "id": "78068ba3-b109-4f63-ad26-e837ab7c0d7c",
            "type": "job_openings",
            "attributes": {
                "categories": [
                    "support",
                    "management"
                ],
                "title": "Support Manager - Non-US Timezones",
                "url": "https://zapier.com/jobs/support-manager-non-us/",
                "first_seen_at": "2017-10-08T14:09:53Z",
                "last_seen_at": "2018-09-04T00:37:54Z",
                "job_opening_closed": null,
                "additional_data": {
                    "job_title": "Support Manager - Non-US Timezones",
                    "job_title_seniority": "management",
                    "tags": [
                        "Visual Basic .NET",
                        "AddThis"
                    ]
                }
            }
        },
        {
            "id": "37cfd004-44bd-4aca-8153-e4eb6d88af13",
            "type": "job_openings",
            "attributes": {
                "categories": [],
                "title": "Tax Accountant",
                "url": "https://www.linkedin.com/in/evan-danals-cpa-macc-30122229/?utm_source=zapier.com&utm_medium=referral&utm_campaign=zapier",
                "first_seen_at": "2017-07-14T12:19:28Z",
                "last_seen_at": "2017-07-14T13:16:19Z",
                "job_opening_closed": null,
                "additional_data": {
                    "job_title": "Tax Accountant",
                    "job_title_seniority": "undefined",
                    "tags": []
                }
            }
        },
        {
            "id": "190a8393-8b9b-45cf-9730-69e05d2cceba",
            "type": "job_openings",
            "attributes": {
                "categories": [
                    "engineering",
                    "management"
                ],
                "title": "Product Manager - Developer Platform",
                "url": "https://zapier.com/jobs/product_manager_developer_platform/",
                "first_seen_at": "2017-02-24T05:11:48Z",
                "last_seen_at": "2019-01-17T14:11:50Z",
                "job_opening_closed": null,
                "additional_data": {
                    "job_title": "Product Manager - Developer Platform",
                    "job_title_seniority": "management",
                    "tags": [
                        "Visual Basic .NET",
                        "Slack",
                        "Planet"
                    ]
                }
            }
        },
        {
            "id": "7b2207da-1514-47d6-aa0e-577a69f452bc",
            "type": "job_openings",
            "attributes": {
                "categories": [
                    "engineering",
                    "information_technology",
                    "data_analysis"
                ],
                "title": "Senior Data Engineer",
                "url": "https://zapier.com/jobs/data-engineer-november-2016",
                "first_seen_at": "2017-02-09T01:27:29Z",
                "last_seen_at": "2017-03-04T11:40:16Z",
                "job_opening_closed": null,
                "additional_data": {
                    "job_title": "Senior Data Engineer",
                    "job_title_seniority": "senior",
                    "tags": []
                }
            }
        },
        {
            "id": "bdc03e5e-e14a-4042-bd1e-7e1eea77b13e",
            "type": "job_openings",
            "attributes": {
                "categories": [
                    "support",
                    "engineering"
                ],
                "title": "Platform Support Engineer",
                "url": "https://www.linkedin.com/in/cassandra-hill-1446a4a5/?utm_source=zapier.com&utm_medium=referral&utm_campaign=zapier",
                "first_seen_at": "2017-02-09T01:27:29Z",
                "last_seen_at": "2018-03-05T01:05:36Z",
                "job_opening_closed": null,
                "additional_data": {
                    "job_title": "Platform Support Engineer",
                    "job_title_seniority": "undefined",
                    "tags": [
                        "Visual Basic .NET",
                        "GitHub"
                    ]
                }
            }
        },
        {
            "id": "612471c2-e0b5-4e61-88e5-0b66bada6c71",
            "type": "job_openings",
            "attributes": {
                "categories": [
                    "information_technology",
                    "management",
                    "data_analysis"
                ],
                "title": "Data Team Manager",
                "url": "https://zapier.com/jobs/data-team-manager-2017/",
                "first_seen_at": "2017-02-09T01:27:29Z",
                "last_seen_at": "2019-01-21T06:42:48Z",
                "job_opening_closed": null,
                "additional_data": {
                    "job_title": "Data Team Manager",
                    "job_title_seniority": "management",
                    "tags": [
                        "Visual Basic .NET",
                        "Planet"
                    ]
                }
            }
        },
    ],
    "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 number of individual 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": "technologies",
            "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": "technologies",
            "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": "technologies",
            "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": "technologies",
            "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": "technologies",
            "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": "technologies",
            "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": "technologies",
            "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": "technologies",
            "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": "technologies",
            "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": "technologies",
            "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": "technologies",
            "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": "technologies",
            "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": "connections",
            "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": "companies"
                    }
                },
                "company2": {
                    "data": {
                        "id": "1464778",
                        "type": "companies"
                    }
                }
            }
        },
        {
            "id": "3881276",
            "type": "connections",
            "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": "companies"
                    }
                },
                "company2": {
                    "data": {
                        "id": "1464778",
                        "type": "companies"
                    }
                }
            }
        },
        {
            "id": "14166476",
            "type": "connections",
            "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": "companies"
                    }
                },
                "company2": {
                    "data": {
                        "id": "1464778",
                        "type": "companies"
                    }
                }
            }
        },
        {
            "id": "18080500",
            "type": "connections",
            "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": "companies"
                    }
                },
                "company2": {
                    "data": {
                        "id": "1464778",
                        "type": "companies"
                    }
                }
            }
        },
        {
            "id": "17793845",
            "type": "connections",
            "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": "companies"
                    }
                },
                "company2": {
                    "data": {
                        "id": "1464778",
                        "type": "companies"
                    }
                }
            }
        },
        {
            "id": "16641677",
            "type": "connections",
            "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": "companies"
                    }
                },
                "company2": {
                    "data": {
                        "id": "1464778",
                        "type": "companies"
                    }
                }
            }
        }, 
        ...
    ],
    "included": [
        {
            "id": "1620557",
            "type": "companies",
            "attributes": {
                "domain": "cluedin.net",
                "company_name": "CluedIn ApS"
            }
        },
        {
            "id": "1464778",
            "type": "companies",
            "attributes": {
                "domain": "pipedrive.com",
                "company_name": "Pipedrive, Inc."
            }
        },
        {
            "id": "3688114",
            "type": "companies",
            "attributes": {
                "domain": "monstrafestival.com",
                "company_name": "MONSTRA | Lisbon Animated Film Festival"
            }
        },
        {
            "id": "4655015",
            "type": "companies",
            "attributes": {
                "domain": "ambernettech.com",
                "company_name": "AmberNet Technologies - Hybrid Cloud Management- Brokerage - Application Blueprinting & Migrations"
            }
        },
        {
            "id": "11095796",
            "type": "companies",
            "attributes": {
                "domain": "timeon.io",
                "company_name": null
            }
        },
        {
            "id": "4372782",
            "type": "companies",
            "attributes": {
                "domain": "nbbadvisors.com",
                "company_name": "NBB M&A Advisors"
            }
        },
        {
            "id": "1409780",
            "type": "companies",
            "attributes": {
                "domain": "bvp.com",
                "company_name": "Bessemer Venture Partners"
            }
        },
        {
            "id": "1572978",
            "type": "companies",
            "attributes": {
                "domain": "bigroomstudios.com",
                "company_name": "Big Room Studios, Inc."
            }
        },
        {
            "id": "2366886",
            "type": "companies",
            "attributes": {
                "domain": "leadliaison.com",
                "company_name": "Leadliaison"
            }
        },
        ...
    ],
    "meta": {
        "count": 83
    }
}

Returns a list of categorized business connections.

HTTP Request

GET https://predictleads.com/api/v2/companies/:domain/connections

More information on the connection 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/v/companies/discover?event_categories=is_developing&headquarter_locations=CA"
{
   "data":[
      {
         "id":"1442551",
         "type":"companies",
         "attributes":{
            "domain":"jauntvr.com",
            "company_name":"Jaunt VR"
         },
         "relationships":{
            "events":{
               "data":[
                  {
                     "type":"events",
                     "id":"90542583-657f-46fa-85f4-a1a5c5f24798",
                     "link":"https://predictleads.com/api/v1/events/90542583-657f-46fa-85f4-a1a5c5f24798",
                     "url":"http://gadgets.ndtv.com/tv/news/xiaomi-partners-jaunt-for-virtual-reality-content-1641113"
                  },
                  {
                     "type":"events",
                     "id":"a223e6c7-159a-411f-9486-fa1c194744d5",
                     "link":"https://predictleads.com/api/v1/events/a223e6c7-159a-411f-9486-fa1c194744d5",
                     "url":"http://www.businesswire.com/news/home/20160714005292/en/Dolby-Laboratories-Jaunt-Launch-World%25E2%2580%2599s-Cinematic-VR"
                  }
               ]
            }
         }
      },
      {
         "id":"1445022",
         "type":"companies",
         "attributes":{
            "domain":"kitepharma.com",
            "company_name":"Kite Pharma, Inc."
         },
         "relationships":{
            "events":{
               "data":[
                  {
                     "type":"events",
                     "id":"0d104175-0310-41a5-9c17-8bcae0b0424c",
                     "link":"https://predictleads.com/api/v1/events/0d104175-0310-41a5-9c17-8bcae0b0424c",
                     "url":"http://www.benchmarkmonitor.com/2016/12/17/investors-alert-kite-pharma-inc-nasdaqkite-adtran-inc-nasdaqadtn-mattel-inc-nasdaqmat-cisco-systems-inc-nasdaqcsco/"
                  }
               ]
            }
         }
      },
      {
         "id":"1447882",
         "type":"companies",
         "attributes":{
            "domain":"liquid-robotics.com",
            "company_name":"Liquid Robotics Inc."
         },
         "relationships":{
            "events":{
               "data":[
                  {
                     "type":"events",
                     "id":"a0730a04-d9e5-4d90-8411-15266b55cbca",
                     "link":"https://predictleads.com/api/v1/events/a0730a04-d9e5-4d90-8411-15266b55cbca",
                     "url":"http://www.upi.com/Business_News/Security-Industry/2016/12/07/Boeing-to-acquire-Liquid-Robotics/7141481118466/"
                  },
                  {
                     "type":"events",
                     "id":"f02bd5e6-6776-4114-8136-be9a525207ce",
                     "link":"https://predictleads.com/api/v1/events/f02bd5e6-6776-4114-8136-be9a525207ce",
                     "url":"http://www.marinetechnologynews.com/news/boeing-acquire-liquid-robotics-542269"
                  }
               ]
            }
         }
      },
      {
         "id":"1448113",
         "type":"companies",
         "attributes":{
            "domain":"llnl.gov",
            "company_name":"Lawrence Livermore National Laboratory"
         },
         "relationships":{
            "events":{
               "data":[
                  {
                     "type":"events",
                     "id":"40ea781f-e1c8-4372-8d2e-619bc1a653c2",
                     "link":"https://predictleads.com/api/v1/events/40ea781f-e1c8-4372-8d2e-619bc1a653c2",
                     "url":"http://www.newswise.com/articles/department-of-energy-selects-llnl-to-lead-development-of-manufacturing-training-program-for-energy-entrepreneurs"
                  }
               ]
            }
         }
      },
      {
         "id":"1449284",
         "type":"companies",
         "attributes":{
            "domain":"machinima.com",
            "company_name":"Machinima, Inc."
         },
         "relationships":{
            "events":{
               "data":[
                  {
                     "type":"events",
                     "id":"fc6f1302-29aa-4a62-bf35-559e506cd39f",
                     "link":"https://predictleads.com/api/v1/events/fc6f1302-29aa-4a62-bf35-559e506cd39f",
                     "url":"http://www.denofgeek.com/us/tv/prime-wars-trilogy/260322/machinima-and-hasbro-team-to-continue-transformers-animated-web-series"
                  },
                  {
                     "type":"events",
                     "id":"9b88abd7-5728-4df2-af49-b6521bd6b6b0",
                     "link":"https://predictleads.com/api/v1/events/9b88abd7-5728-4df2-af49-b6521bd6b6b0",
                     "url":"http://www.hollywoodreporter.com/news/warner-bros-confirms-acquisition-digital-network-machinima-948329"
                  }
               ]
            }
         }
      }
   ],
   "meta":{
      "count":134
   }
}

Returns a list of companies that satisfy given query parameters.

HTTP Request

GET https://predictleads.com/api/v1/companies/discover

Request Parameters

Parameter Description
headquarters_locations string List of company headquarters locations split by a comma (,). Ie.: CA, FL, France.
event_locations string List of event locations split by a comma (,). Ie.: CA, FL, France.
job_opening_locations string List of job opening locations split by a comma (,). Ie.: CA, FL, France.
event_categories string List of event categories split by a comma (,). Ie.: hires, launches, invests_into.
event_tags string List of event tags split by a comma (,). Ie.: mobile, future_tech, energy.
job_opening_categories string List of job categories split by a comma (,). Ie.: marketing, education, software_development.
job_opening_tags string List of keywords found on career sites split by a comma (,). Ie.: SalesForce, Customer succes, SAP.
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) Minum 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 companies. Ie.: 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

[
  {
           "id":"28ac963d-2f04-4060-b54e-014cc0898417",
           "type":"events",
           "attributes":{
              "categories":[
                 "expands_offices_to"
              ],
              "title":"Array Technologies, Inc. expands offices to Sydney",
              "url":"http://www.solarnovus.com/array-technologies-expands-to-australia_N10767.html",
              "found_at":"2017-03-29T12:12:50Z",
              "additional_data":{
                 "assets":"office",
                 "location":"Sydney",
                 "location_data":{
                    "country":"Australia",
                    "fuzzy_match":false
                 }
              }
           },
           "relationships":{
              "companies":{
                 "data":[
                    {
                       "type":"companies",
                       "domain":"arraytechinc.com",
                       "name":"Array Technologies, Inc.",
                       "friendly_name":"Array Technologies"
                    }
                 ]
              }
           }
        },
  {
         "id":"cab04bfc-2661-4896-b933-051591d70fc1",
         "type":"events",
         "attributes":{
            "categories":[
               "partners_with"
            ],
            "title":"YourMembership partners with Aptify Corporation",
            "url":"http://www.thenonprofittimes.com/news-articles/software-deal-marries-yourmembership-abila-aptify/",
            "found_at":"2017-04-07T14:42:10Z",
            "additional_data":{

            }
         },
         "relationships":{
            "companies":{
               "data":[
                  {
                     "type":"companies",
                     "domain":"yourmembership.com",
                     "name":"YourMembership",
                     "friendly_name":"YourMembership"
                  },
                  {
                     "type":"companies",
                     "domain":"aptify.com",
                     "name":"Aptify Corporation",
                     "friendly_name":"Aptify"
                  }
               ]
            }
         }
      },
  {
     "id":"ff100453-2cbb-45d5-968b-fa07d3076f5b",
     "type":"events",
     "attributes":{
        "categories":[
           "hires"
        ],
        "title":"Decision Resources Group hires Peter Hempshall as Senior Vice President, Global Consulting Services",
        "url":"http://www.prnewswire.co.uk/news-releases/decision-resources-group-appoints-peter-hempshall-as-senior-vice-president-global-consulting-services-612888543.html",
        "found_at":"2017-02-06T13:45:11Z",
        "additional_data":{
           "contact":"Peter Hempshall",
           "job_title":"Senior Vice President, Global Consulting Services"
        }
     },
     "relationships":{
        "companies":{
           "data":[
              {
                 "type":"companies",
                 "domain":"decisionresourcesgroup.com"
              }
           ]
        }
     }
  },
  {
     "id":"fffd28f2-03ae-4f66-bc73-cc9b4b3b163a",
     "type":"events",
     "attributes":{
        "categories":[
           "expands_facilities"
        ],
        "title":"8minutenergy Renewables expands facilities to Texas, United States",
        "url":"http://www.pv-tech.org/news/8minutenergy-targeting-over-2gw-of-pv-projects-in-texas",
        "found_at":"2016-10-05T09:07:54Z",
        "additional_data":{
           "assets":"2GW of utility-scale PV power plant",
           "assets_tags":[
              "energy",
              "production"
           ],
           "location":"Texas, United States",
           "location_data":{
              "country":"United States",
              "fuzzy_match":false,
              "state":"Texas"
           }
        }
     },
     "relationships":{
        "companies":{
           "data":[
              {
                 "type":"companies",
                 "domain":"8minutenergy.com"
              }
           ]
        }
     }
  },
  {
     "id":"fff5147a-8346-4796-a26f-5bcd234a3686",
     "type":"events",
     "attributes":{
        "categories":[
           "expands_offices_to"
        ],
        "title":"Sisense Inc. expands offices to New York, United States",
        "url":"http://rew-online.com/2016/09/28/analytics-firm-sisense-relocating-to-esrts-1359-broadway/",
        "found_at":"2016-09-28T19:09:03Z",
        "additional_data":{
           "location":"New York, United States",
           "location_data":{
              "country":"United States",
              "fuzzy_match":false,
              "state":"New York"
           }
        }
     },
     "relationships":{
        "companies":{
           "data":[
              {
                 "type":"companies",
                 "domain":"sisense.com"
              }
           ]
        }
     }
  },
  {
     "id":"ffdeb82f-39f1-4b39-9b01-5c31ad2c0b96",
     "type":"events",
     "attributes":{
        "categories":[
           "promotes"
        ],
        "title":"Del Monte Foods, Inc. promotes Robert Long as Chief Information Officer on Jul 13th 16'.",
        "url":"http://blogs.wsj.com/cio/2016/07/20/del-monte-picks-insider-as-new-cio/",
        "found_at":"2016-07-20T17:56:56Z",
        "additional_data":{
           "contact":"Robert Long",
           "job_title":"Chief Information Officer",
           "date":"2016-07-13"
        }
     },
     "relationships":{
        "companies":{
           "data":[
              {
                 "type":"companies",
                 "domain":"delmontefoods.com"
              }
           ]
        }
     }
  },
  {
     "id":"ffddcc25-8efc-48c2-ac50-8f3d1a2edd57",
     "type":"events",
     "attributes":{
        "categories":[
           "increases_headcount_by"
        ],
        "title":"McLaren Group Limited increases headcount by 250",
        "url":"http://www.autocar.co.uk/car-news/industry/mclaren-adds-second-shift-production-line-recruits-250-new-staff",
        "found_at":"2016-01-07T11:02:14Z",
        "additional_data":{
           "headcount":250
        }
     },
     "relationships":{
        "companies":{
           "data":[
              {
                 "type":"companies",
                 "domain":"mclaren.com"
              }
           ]
        }
     }
  },

]

Event signals are structured pieces of data found in press releases, news articles, blogs and other public documents.

Attribute Description
id integer
Unique trigger identifier (unique across all trigger 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.

Companies

Associated company objects are listed in order under relationships.

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.
receives_award recognition Company or person at the company receives an award.
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 relational New or existing competitor was identified.

Job opening

Examples of job_opening objects

[
  {
     "id":"f9393f49-6c60-4e26-87c3-fc4ed8d52950",
     "type":"job_openings",
     "attributes":{
        "categories":[
           "engineering",
           "software_development"
        ],
        "title":"Software Engineer - McLean, VA",
        "url":"http://doveltech.catsone.com/careers/index.php?m=portal&a=details&jobOrderID=8590658",
        "first_seen_at":"2017-01-24T13:53:36Z",
        "last_seen_at":"2018-03-22T14:02:25Z",
        "additional_data":{
           "job_title":"Software Engineer - McLean, VA",
           "job_title_seniority":"undefined",
           "tags":[
             "Oracle",
             "Ruby",
             "Python",
             "Java"
           ]
        }
     }
  },
  {
     "id":"5dc16955-4e96-407b-9ee3-392281bef757",
     "type":"job_openings",
     "attributes":{
        "categories":[
           "engineering"
        ],
        "title":"Senior Electrical Engineer",
        "url":"http://careers.mineralresources.com.au/cw/en/job/493697/senior-electrical-engineer",
        "first_seen_at":"2017-04-08T21:32:00Z",
        "last_seen_at":"2017-06-21T22:12:33Z",
        "additional_data":{
           "job_title":"Senior Electrical Engineer",
           "job_title_seniority":"senior",
           "tags":[
              "Growth"
           ]
        }
     }
  },
  {
     "id":"fecfa918-2a7c-4a1b-8455-967dcaadfe40",
     "type":"job_openings",
     "attributes":{
        "categories":[],
        "title":"Pay-Per-Click (PPC) Specialist",
        "url":"https://chengbao.com.hk/jobs/ppc-specialist.html",
        "first_seen_at":"2017-01-25T01:55:05Z",
        "last_seen_at":"2017-05-12T03:22:18Z",
        "additional_data":{
           "job_title":"Pay-Per-Click (PPC) Specialist",
           "job_title_seniority":"undefined",
           "tags":[ 
             "AdWords"
           ]
        }
     }
  }
]
Attribute Description
id integer
Unique trigger identifier (unique across all trigger types).
categories array
Array of categories - full list below.
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 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"]

Technology

Examples of technology objects

[
  {
     "id":"ffcf3998-a073-428b-87dd-70b97d1641a3",
     "type":"technologies",
     "attributes":{
        "categories":[
           "marketing_automation"
        ],
        "title":"Pardot",
        "url":"http://www.wpowerproducts.com",
        "found_at":"2016-04-29T20:21:46Z"
     }
  },
  {
     "id":"ff0f6039-74c4-4403-bdf0-0beef3b8b1d9",
     "type":"technologies",
     "attributes":{
        "categories":[
           "analytics"
        ],
        "title":"Segment",
        "url":"http://www.tapbookauthor.com",
        "found_at":"2017-02-03T10:43:42Z"
     }
  },
  {
     "id":"ffd24665-04b1-456c-953e-464d5dcbceef",
     "type":"technologies",
     "attributes":{
        "categories":[
           "analytics"
        ],
        "title":"Intercom",
        "url":"http://www.lifehappens.org",
        "found_at":"2016-10-21T13:33:17Z"
     }
  }
]
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": "1367004",
           "type": "connections",
           "attributes": {
               "category": "other",
               "first_seen_at": "2018-01-11T13:23:12Z",
               "last_seen_at": "2018-07-09T07:11:09Z",
               "source_category": "undefined",
               "source_url": "https://www.9lenses.com/customers/"
           },
           "relationships": {
               "companies": {
                   "data": [
                       {
                           "type": "companies",
                           "domain": "9lenses.com",
                           "name": "9Lenses, LLC",
                           "friendly_name": "9Lenses"
                       },
                       {
                           "type": "companies",
                           "domain": "ritatrehan.com"
                       }
                   ]
               }
           }
       },
       {
           "id": "1022233",
           "type": "connections",
           "attributes": {
               "category": "investor",
               "first_seen_at": "2018-01-08T23:44:01Z",
               "last_seen_at": "2018-07-09T02:56:58Z",
               "source_category": "investor_page",
               "source_url": "http://www.kineticventures.com/portfolio"
           },
           "relationships": {
               "companies": {
                   "data": [
                       {
                           "type": "companies",
                           "domain": "kineticventures.com",
                           "name": "Kinetic Ventures",
                           "friendly_name": "Kinetic Ventures"
                       },
                       {
                           "type": "companies",
                           "domain": "9lenses.com",
                           "name": "9Lenses, LLC",
                           "friendly_name": "9Lenses"
                       }
                   ]
               }
           }
       },
       {
           "id": "5265070",
           "type": "connections",
           "attributes": {
               "category": "other",
               "first_seen_at": "2018-05-02T23:31:31Z",
               "last_seen_at": "2018-06-21T23:37:13Z",
               "source_category": "undefined",
               "source_url": "http://www.edwinmiller.com/"
           },
           "relationships": {
               "companies": {
                   "data": [
                       {
                           "type": "companies",
                           "domain": "edwinmiller.com",
                           "name": "(i)SAGE",
                           "friendly_name": "(i)SAGE"
                       },
                       {
                           "type": "companies",
                           "domain": "9lenses.com",
                           "name": "9Lenses, LLC",
                           "friendly_name": "9Lenses"
                       }
                   ]
               }
           }
       },
       {
           "id": "8702177",
           "type": "connections",
           "attributes": {
               "category": "partner",
               "first_seen_at": "2018-06-11T09:08:09Z",
               "last_seen_at": "2018-07-10T23:41:43Z",
               "source_category": "partner_page",
               "source_url": "https://www.webufacture.com/"
           },
           "relationships": {
               "companies": {
                   "data": [
                       {
                           "type": "companies",
                           "domain": "webufacture.com",
                           "name": "Webufacture",
                           "friendly_name": "Webufacture"
                       },
                       {
                           "type": "companies",
                           "domain": "9lenses.com",
                           "name": "9Lenses, LLC",
                           "friendly_name": "9Lenses"
                       }
                   ]
               }
           }
       }
   ],
   "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.
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.

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. Our quality assurance analysts will review the signal and correct it.

Optionally you can also append a message with the signal ID. The message can include info about why you flagged the product.

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.