NAV Navbar
Logo pl
curl

Introduction

The PredictLeads API is used to discover net-new companies or enrich existing company profiles with insights. Use cases range from enriching CRM with account intelligence, lead generation using buying signals and identifying top performing companies for investment purposes.

Our API is RESTful with responses delivered in JSON or XML format. Data can also be delivered as flat files, via APIs or Webhooks.

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

You can see live status of our API services here

If you would like to receive data as flat files or via webhooks, please get in touch with our sales.

Authentication

Authentication using Authorization header.

curl "https://predictleads.com/api/v2/followings" \
  -H 'X-Api-Key: <key>' \
  -H 'X-Api-Token: <token>'

Alternatively pass your api key and token in query parameters.

curl "https://predictleads.com/api/v2/followings \
    ?api_token={token}&api_key={key}"

Authentication is done via the authentication token which you can find on Your subscription plans page.

In order to use the API you need to call an endpoint URL with both your API token and API key.

The primary and recommended method for authenticating with PredictLeads is to specify the API key in the HTTP request header using an extended header field. In all the examples, we’ll use the header authentication model.

Pagination

curl -X GET "https://predictleads.com/api/v2/discover/startup_platform/show_hn?page=2" \
  -H 'X-Api-Key: <key>' \
  -H 'X-Api-Token: <token>'

Responses with a list of objects (like GET /startup_platform_posts/show_hn) are paginated. Use page parameter to get more results. Total number of all possible results is displayed inside meta attributes as count. 

{
    "data": [{...}],
    "meta": {
        "count": 10
    }
}

Webhooks

Example data we’ll POST to your Webhook.


    {
      "data": [
        {
          "id": "41e1f820-9e0f-46b3-a2e0-49dbe4175859",
          "type": "event",
          "attributes": {
            "categories": [
              "hires"
            ],
            "title": "Domo, Inc. hires Vita Shannon as vice president of demand center",
            "found_at": "2021-03-01T16:15:12Z",
            "url": "https://aithority.com/it-and-devops/cloud/domo-invests-for-growth-welcoming-new-executives-to-lead-companys-demand-engines/",
            "additional_data": {
              "contact": "Vita Shannon",
              "job_title": "vice president of demand center",
              "article_title": "Domo Invests for Growth, Welcoming New Executives to Lead Company’s Demand Engines",
              "article_sentence": "Vita Shannon joins Domo from KPMG as vice president of partnerships and ecosystem, and Shelley Morrison joins from Accenture Interactive as Domo’s vice president of demand center.",
              "article_body": "Domo announced that it has welcomed two new executives to support and accelerate its growth initiatives. Vita Shannon joins Domo from KPMG as vice president of partnerships and ecosystem, and Shelley Morrison joins from Accenture Interactive as Domo’s vice president of demand center. “I’m thrilled to welcome Vita and Shelley and their global expertise in growth strategies and execution to our team,” said Josh James, founder and CEO, Domo. “The need for speed in putting data to work has never been more important and I’m looking forward to building on our business momentum with the addition of these proven executives.” Shannon brings years of experience in business development and partner strategy, most recently serving as the senior director of advisory services at KPMG.",
              "article_source": "aithority.com",
              "article_published_at": "2021-03-01T17:15:12.000Z",
              "confidence": "0.7243"
            }
          },
          "relationships": {
            "company1": {
              "data": {
                "id": "1422300",
                "type": "company"
              }
            }
          }
        }
      ],
      "included": [
        {
          "id": "1422300",
          "type": "company",
          "attributes": {
            "domain": "domo.com",
            "company_name": "Domo, Inc.",
            "ticker": null
          }
        },
        ...
      ],
      "meta": {
        "followed_company_ids": [
          "1422300"
        ]
      }
    }

    {
      "data": [
        {
          "id": "e18484de-8f68-4dec-8403-03df2b315321",
          "type": "job_opening",
          "attributes": {
            "title": "Full Stack Engineer",
            "url": "https://www.ycombinator.com/companies/terra/jobs/3NbdZp6-full-stack-engineer",
            "salary": "$50000 - $120000",
            "salary_data": {
              "salary_low": 50000.0,
              "salary_high": 120000.0,
              "salary_currency": "USD",
              "salary_low_usd": 50000.0,
              "salary_high_usd": 120000.0,
              "salary_time_unit": "year"
            },
            "contract_types": [
              "full time"
            ],
            "first_seen_at": "2021-08-02T03:36:38Z",
            "last_seen_at": "2021-10-30T06:52:51Z",
            "last_processed_at": "2021-10-30T06:52:51Z",
            "job_opening_closed": false,
            "location": "London, England, United Kingdom",
            "categories": [
              "engineering",
              "software_development"
            ],
            "additional_data": {
              "job_title_seniority": null,
              "tags": [
                "Growth",
                "Customer success",
                "Android",
                "Node.js",
                "PHP",
                "Python",
                "Ruby",
                "Flask",
                "Stripe",
                "Cloudflare CDN",
                "Doppler",
                "Onesignal",
                "Taplytics",
                "Workramp"
              ],
              "location_data": {
                "country": "United Kingdom",
                "city": "London",
                "fuzzy_match": false
              }
            }
          },
          "relationships": {
            "company": {
              "data": {
                "id": "1487151",
                "type": "company"
              }
            }
          }
        }
      ],
      "included": [
        {
          "id": "1487151",
          "type": "company",
          "attributes": {
            "domain": "tylertech.com",
            "company_name": "Tyler Technologies Inc",
            "ticker": "NYSE:TYL"
          }
        },
        ...
      ]
    }

    {
      "data": [
        {
          "id": "86816ac0-e43f-42b0-82d9-720b22dc7c78",
          "type": "connection",
          "attributes": {
            "category": "parent",
            "source_category": "domain_redirect",
            "source_url": null,
            "first_seen_at": "2021-03-04T11:56:04Z",
            "last_seen_at": "2021-03-04T11:56:04Z"
          },
          "relationships": {
            "company1": {
              "data": {
                "id": "324979",
                "type": "company"
              }
            },
            "company2": {
              "data": {
                "id": "18612203",
                "type": "company"
              }
            }
          }
        }
      ],
      "included": [
        {
          "id": "324979",
          "type": "company",
          "attributes": {
            "domain": "saucony.com",
            "company_name": "Saucony, Inc.",
            "ticker": null
          }
        },
        ...
      ],
      "meta": {
        "followed_company_ids": [
          "324979"
        ]
      }
    }

Example data we’ll POST to Segment Webhook URL.

    {
      "data": [
        {
          "id": "41e1f820-9e0f-46b3-a2e0-49dbe4175859",
          "type": "event",
          "attributes": {
            "categories": [
              "hires"
            ],
            "title": "Domo, Inc. hires Vita Shannon as vice president of demand center",
            "found_at": "2021-03-01T16:15:12Z",
            "url": "https://aithority.com/it-and-devops/cloud/domo-invests-for-growth-welcoming-new-executives-to-lead-companys-demand-engines/",
            "additional_data": {
              "contact": "Vita Shannon",
              "job_title": "vice president of demand center",
              "article_title": "Domo Invests for Growth, Welcoming New Executives to Lead Company’s Demand Engines",
              "article_sentence": "Vita Shannon joins Domo from KPMG as vice president of partnerships and ecosystem, and Shelley Morrison joins from Accenture Interactive as Domo’s vice president of demand center.",
              "article_body": "Domo announced that it has welcomed two new executives to support and accelerate its growth initiatives. Vita Shannon joins Domo from KPMG as vice president of partnerships and ecosystem, and Shelley Morrison joins from Accenture Interactive as Domo’s vice president of demand center. “I’m thrilled to welcome Vita and Shelley and their global expertise in growth strategies and execution to our team,” said Josh James, founder and CEO, Domo. “The need for speed in putting data to work has never been more important and I’m looking forward to building on our business momentum with the addition of these proven executives.” Shannon brings years of experience in business development and partner strategy, most recently serving as the senior director of advisory services at KPMG.",
              "article_source": "aithority.com",
              "article_published_at": "2021-03-01T17:15:12.000Z",
              "confidence": "0.7243"
            }
          },
          "relationships": {
            "company1": {
              "data": {
                "id": "1422300",
                "type": "company"
              }
            }
          }
        }
      ],
      "included": [
        {
          "id": "1422300",
          "type": "company",
          "attributes": {
            "domain": "domo.com",
            "company_name": "Domo, Inc.",
            "ticker": null
          }
        }
      ],
      "meta": {
        "followed_company_ids": [
          "1422300"
        ]
      }
    }

Webhooks enable our customers to receive data on a continuous basis without the need to issue unnecessary API requests.

If your server does not respond with a 200 OK (or 201, 202, 204) response within a 5 second window or responds with another error code (4XX, 5XX), we will consider the POST request faulty. We will retry the request until we detect that 5 out out of 50 requests in the last hour have had a non-OK response. After reaching this limit we will disable the webhook and send email messages notifying the user and our admins of this. When in this state the webhook has to be re-enabled manually and upon request we can provide some data on why the requests were failing. For any additional information about webhooks, you can write to our support email.

Signals

Whenever we find a new buying signal for one of the companies you’re tracking, we’ll send a POST request to your general Webhook URL with the Signal object. Go to Your subscription plans page to enter your Webhook URL.

Companies

When creating a segment of companies you can set a Webhook URL optionally. Every week we’ll send a POST request to that Webhook URL with new companies in your segment. Under relationships we’ll include Signal objects corresponding to Segment parameters. In case no new companies are found in your segment, we won’t send anything.

Webhook Authentication

To validate whether the webhook came from PredictLeads we suggest verifying the webhook payloads with the X-Predict-Signature header (which we pass with every webhook). Header payload is a SHA1 HMAC hexdigest computed with your token and the raw body of the request.

Errors

Our API returns standard HTTP success or error status codes. For errors, we also include extra information about what went wrong encoded in the response as JSON.

Status Code Meaning Counts towards limit
200 SUCCESS - Request was successfully processed. Yes
400 BAD REQUEST - Request message framing was invalid. The server cannot or will not process the request. Yes
401 UNAUTHORIZED ACCESS - Authentication failed. Check again your credentials or contact us. Yes
403 FORBIDDEN - Request rate over limit. No
404 NOT FOUND - Specified company is not in our database. Check again in 24h. Yes
422 UNPROCESSABLE ENTITY - Malformed domain name Yes
500 INTERNAL SERVER ERROR – We had a problem with our server. Try again later. No

Request Limits

Each account using the API has request limits implemented. The amount of requests one can do each month is limited by the chosen plan. You can track your monthly usage on Your subscription plans page.

Once the account reaches the limit, all further requests will produce a 403 HTTP error, notifying the user of the reached limit. If you have any further questions regarding the limits, feel free to contact us via support.

Track

Track companies to receive buying signals data when found. We’ll issue a POST request with the data to your general Webhook URL. More on webhooks here.

Follow company

curl -X POST "https://predictleads.com/api/v2/companies/hubspot.com/follow" \
  -H 'X-Api-Key: <key>' \
  -H 'X-Api-Token: <token>'

Enables the authenticated user to follow the company specified with the company domain parameter.

{
  "success": {
    "type": "follow_successful",
    "message": "Company with domain hubspot.com was successfully followed."
  }
}

HTTP Request

POST https://predictleads.com/api/v2/companies/:domain/follow

Followed companies

curl -X GET "https://predictleads.com/api/v2/followings" \
  -H 'X-Api-Key: <key>' \
  -H 'X-Api-Token: <token>'

Returns a list of followed companies.

[
  {"domain": "hubspot.com"},
  {"domain": "clearbit.com"},
  {"domain": "segment.com"},
  {"domain": "outreach.com"},
  ...
]

HTTP Request

GET https://predictleads.com/api/v2/followings

Unfollow company

curl -X POST "https://predictleads.com/api/v2/companies/hubspot.com/unfollow" \
  -H 'X-Api-Key: <key>' \
  -H 'X-Api-Token: <token>'

Enables the authenticated user to unfollow the company specified with the domain parameter.

{
  "success": {
    "type": "unfollow_successful",
    "message": "Company with domain hubspot.com was successfully unfollowed."
  }
}

If you are trying to remove a company that is not followed, you will get the following response

{
  "error": {
    "type": "unfollow_unsuccessful",
    "message": "Are you sure you're following this company? We couldn't find it in our database."
  }
}

HTTP Request

POST https://predictleads.com/api/v2/companies/:domain/unfollow

Enrich

Access all recent signals for a given company by providing its domain. Each signal type has its own endpoint: /events, /job_openings and /technologies. Every call returns most recent 10 signals. In case the company isn’t in our database, the system will immediately start searching for signals and return them to the specified Webhook URL when finished. Alternatively, you can call the endpoint again in 48 hours.

For the endpoint to return total number of records please add a page parameter to your query eg. page=1.

Events

curl -X GET "https://predictleads.com/api/v2/companies/klasha.com/events" \
  -H 'X-Api-Key: <key>' \
  -H 'X-Api-Token: <token>'

Returns a list of events from news for a given company. Events are found in press releases, industry news, blogs and other text based media.

{
  "data": [{
    "id": "f096ea55-f81b-4f6a-83bd-d5c1cdc10143",
    "type": "event",
    "attributes": {
      "categories": [
        "expands_offices_in"
      ],
      "title": "Klasha expands offices in Ghana",
      "found_at": "2021-10-19T22:00:00Z",
      "url": "https://www.electronicpaymentsinternational.com/news/company-news/",
      "additional_data": {
        "location": "Ghana",
        "location_data": {
          "country": "Ghana",
          "fuzzy_match": false
        },
        "article_title": "Company news Archives",
        "article_sentence": "San Francisco and Lagos-based cross-border technology company Klasha is further expanding its presence in Africa with the launch of its services in Ghana.",
        "article_body": "Payfare, which offers banking solutions for gig workforce, has announced that it is integrating with Plaid, a data transfer network that powers fintech and digital finance products. The integration will… Technology company TraQiQ has introduced its online payment solution 'TraQPayments' in Latin America. TraQPayments is… American Express has partnered with Goldman Sachs Transaction Banking (TxB) to offer an integrated payments solution to large corporate clients. Barclaycard Payments and SAP is expanding their cooperation in a bid to boost payment acceptance capabilities and enhance procure-to-pay processes. UK-based fintech firm Previse has tapped Mastercard to provide instant payments to suppliers in more than 100 markets globally. Latin America-based payment processor PayRetailers has entered into an alliance with European payment giant Worldline. Buy now pay later (BNPL) firm Klarna has introduced ‘pay now’ option in the UK. Western Union International Bank (WUIB) has expanded its real-time payment capabilities in Europe by joining the Single Euro Payments Area (SEPA) Instant Credit Transfer scheme (SCT Inst). San Francisco and Lagos-based cross-border technology company Klasha is further expanding its presence in Africa with the launch of its services in Ghana.",
        "article_source": "electronicpaymentsinternational.com",
        "article_published_at": "2021-10-20T00:00:00.000Z",
        "confidence": "0.6872"
      }
    },
    "relationships": {}
  },
    ...,
  ],
  "meta": {
    "count": 8
  }
}

HTTP Request

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

Request Parameters

Parameter Description
categories string All event categories are listed below. Split by a comma (,).
found_at_from date (ISO 8601) Signals found from specified date.
found_at_until date (ISO 8601) Signals found until specified date.
limit string Limit the number of shown events per page. Default is 30, maximum is 100.
with_news_article_bodies boolean Set to true if you’d like news articles returned with their descriptions.

For the endpoint to return total number of records please add a page parameter to your query eg. page=1.

List of event categories and more information on event object is available here.

To get more results use pagination.

Job openings

curl -X GET "https://predictleads.com/api/v2/companies/tryterra.co/job_openings" \
  -H 'X-Api-Key: <key>' \
  -H 'X-Api-Token: <token>'

Returns a list of job openings for a given company. Job openings are found on companies’ career sites and job boards.

  {
    "data": [
      {
        "id": "4d5ac23c-5824-427d-96c6-4e8d50a4241a",
        "type": "job_opening",
        "attributes": {
          "title": "AI Engineer",
          "url": "https://www.ycombinator.com/companies/terra/jobs/0f5CP0r-ai-engineer",
          "description": "**AI Engineer**\n\n\n**$50K - $120K** /  0.10% - 0.50%  **Location** London, England, GB  **Job Type** Full-time  **Experience** Any (new grads ok)   Apply to Terra and hundreds of other fast-growing YC startups with a single profile.    ****\n\nPlaid for healthcare\n\n\n**About the role**\n\nWe work in super small teams, with extremely high velocity.\n\nWe are building multiple AI products, such as OdinAI, Graph API, and many more\n\nAs an AI engineer, you'll work in a small team, with maximum autonomy.\n\n* Be behind the curtain, creating, testing, and implementing AI models\n* Engage in data analysis, machine learning, and natural language processing.\n* Fine-tuning the AI's performance and many more\n\nPreferred background:\n\nBachelor's or Master's degree in STEM. Strong technical skills (e.g. familiarity with a programming language such as Python, JavaScript, or Ruby) Experience with growth marketing, product development, and user acquisition/retention\n\n\n**Must haves.**\n\n-Must have done this before, or be willing to learn fast.\n\n-Must be fast. We operate at 200mph, and so do you.\n\n-Must be relentless. We never stop, so you are even faster than us.\n\n-Must have customer driven. We think customers first and so should you.\n\n-Must be driven and go above and beyond.\n\n-Must be able to explain and communicate clearly.\n\n-Must be prepared to challenge us and disagree. We are thinking and acting as a team.\n\n-Must be able to work autonomously.\n\n-Must want to work hard.\n\n-Last but not least, you are genuinely a nice person.\n\n**Big plus** You are an athlete, or care about quantifying your data\n\n\n**About Terra**\n\n**What we do**\n\nTerra is an API that makes it easy for apps to connect to wearables. Currently, apps and developers in the fitness, wellness, sleep, and other health spaces are using us. Terra was launched in early 2021, and since then we’ve been growing like crazy. But this is just the beginning.\n\n\n**The goal and vision**\n\nThink if Spotify and Netflix create music and movies based on your heart rate, and stress levels, in real time. We want to enable apps to achieve that reality, through our super easy to use API.\n\n\n**Funding**\n\nTo achieve our grand goal, we couldn’t have made it without the support from some incredible investors. We are lucky enough to be supported by , ,  and we were part of  batch.\n\n, and learn who we are \n\nLocation: San Francisco",
          "salary": "USD50000 - USD120000",
          "salary_data": {
            "salary_low": 50000.0,
            "salary_high": 120000.0,
            "salary_currency": "USD",
            "salary_low_usd": 50000.0,
            "salary_high_usd": 120000.0,
            "salary_time_unit": "year"
          },
         "job_opening_closed": false,
          "location": "London, United Kingdom",
          "contract_types": [
            "full time"
          ],
          "first_seen_at": "2023-07-03T08:36:13Z",
          "last_seen_at": "2023-07-12T16:27:59Z",
          "last_processed_at": "2023-07-12T16:27:59Z",
          "categories": [
            "engineering"
          ],
          "additional_data": {
            "job_title_seniority": "non_manager",
            "tags": [
              "Growth",
              "Python",
              "Plaid",
              "JavaScript"
            ],
            "location_data": {
              "country": "United Kingdom",
              "city": "London",
              "fuzzy_match": false
            }
          }
        },
        "relationships": {
          "company": {
            "data": {
              "id": "22379668",
              "type": "company"
            }
          }
        }
      },
      ...,
    ],
    "included": [
      {
        "id": "22379668",
        "type": "company",
        "attributes": {
          "domain": "tryterra.co",
          "company_name": "Tryterra",
          "ticker": null
        }
      }
    ],
    "meta": {
      "count": 33
    }
  }

HTTP Request

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

Request Parameters

Parameter Description
categories string All job opening categories are listed below. Split by a comma (,).
with_job_descriptions boolean Set to true if you’d like jobs returned with their descriptions.
active_only boolean Set to true if you’d like to receive jobs that are not closed and last_seen_at more recent than 3 weeks.
limit string Limit the number of shown events per page. Default is 30, maximum is 100.

For the endpoint to return total number of records please add a page parameter to your query eg. page=1.

List of job openings categories and more information on job opening object is available here.

To get more results use pagination.

Technologies

curl -X GET "https://predictleads.com/api/v2/companies/madkudu.com/technologies" \
  -H 'X-Api-Key: <key>' \
  -H 'X-Api-Token: <token>'

Returns a list of technology providers for a given company.

{
  "data": [
    {
      "id": "344f5e7c-4dae-4814-8f45-ded70b2baa6a",
      "type": "technology",
      "attributes": {
        "categories": [
          "content_delivery_network"
        ],
        "domain": "google.com",
        "first_seen_at": "2022-12-08T10:40:41Z",
        "last_seen_at": "2023-03-08T10:48:08Z",
        "url": "https://developers.google.com/speed/libraries",
        "title": "Google Hosted Libraries",
        "behind_firewall": false,
        "score": 0.5
      },
      "relationships": {
        "company": {
          "data": {
            "id": "1595944",
            "type": "company"
          }
        },
        "seen_on_job_openings": {
          "data": [
            ...
          ]
        },
        "seen_on_subpages": {
          "data": [
            {
              "id": "093ad986-ab24-4a50-a9d9-0acf411dd50b",
              "type": "subpages"
            },
            ...,
          ]
        }
      }
    },
    ...,
  ],
  "included": [
    {
      "id": "093ad986-ab24-4a50-a9d9-0acf411dd50b",
      "type": "subpage",
      "attributes": {
        "url": "https://www.madkudu.com",
        "first_seen_at": "2018-07-09T21:35:33Z",
        "last_seen_at": "2023-03-08T10:48:08Z"
      }
    },
    ...
  ],
  "meta": {
    "count": 29
  }
}

HTTP Request

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

Request Parameters

Parameter Description
categories string All technology categories are listed below. Split by a comma (,).
limit string Limit the number of shown events per page. Default is 30, maximum is 100.

For the endpoint to return total number of records please add a page parameter to your query eg. page=1.

List of technology categories and more information on technology object is available here.

Tables for technology confidence scores can be found here.

To get more results use pagination.

Connections

curl -X GET "https://predictleads.com/api/v2/companies/pipedrive.com/connections" \
  -H 'X-Api-Key: <key>' \
  -H 'X-Api-Token: <token>'

Returns a list of categorized business connections. Business connections can be found via backlinks or logos on /our-customers, /case-studies, /portfolio, /clients etc. pages. Business connections enable you to eg. calculate network health of a company, to build systems when new high value connections are made… Connections can be of many types: partner, vendor, investor, parent…

{
  "data": [{
    "id": "168d9d73-3a8b-492f-b5bc-35564a5ff1fe",
    "type": "connection",
    "attributes": {
      "category": "vendor",
      "source_category": "vendor_page",
      "source_url": "https://funnel.io/customers",
      "first_seen_at": "2021-08-23T09:08:38Z",
      "last_seen_at": "2021-10-18T11:30:23Z"
    },
    "relationships": {
      "company1": {
        "data": {
          "id": "1828101",
          "type": "company"
        }
      },
      "company2": {
        "data": {
          "id": "1464778",
          "type": "company"
        }
      }
    }
  },
    {
    "id": "d76d778a-06be-470f-b7f2-937a81b4b7d5",
    "type": "connection",
    "attributes": {
      "category": "partner",
      "source_category": "partner_page",
      "source_url": "https://1wirefiber.com",
      "first_seen_at": "2021-07-15T10:50:55Z",
      "last_seen_at": "2021-10-23T15:10:12Z"
    },
    "relationships": {
      "company1": {
        "data": {
          "id": "4965363",
          "type": "company"
        }
      },
      "company2": {
        "data": {
          "id": "1464778",
          "type": "company"
        }
      }
    }
  },
    ...,
  ],
  "included": [{
    "id": "1828101",
    "type": "company",
    "attributes": {
      "domain": "funnel.io",
      "company_name": "Funnel",
      "ticker": null
    }
  },{
    "id": "1464778",
    "type": "company",
    "attributes": {
      "domain": "pipedrive.com",
      "company_name": "Pipedrive, Inc.",
      "ticker": null
    }
  },{
    "id": "4965363",
    "type": "company",
    "attributes": {
      "domain": "1wirefiber.com",
      "company_name": "1Wire Communications",
      "ticker": null
    }
  }
    ...,
  ],
  "meta": {
    "count": 83
  }
}

HTTP Request

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

Request Parameters

Parameter Description
categories string All connection categories are listed below. Split by a comma (,).
limit string Limit the number of shown website subpages per page. Default is 30, maximum is 100.

For the endpoint to return total number of records please add a page parameter to your query eg. page=1.

More information on the connection object is available here.

More information on the connection categories can be found here.

To get more results use pagination.

Website Evolution

curl -X GET "https://predictleads.com/api/v2/companies/snowflake.com/website_evolution" \
  -H 'X-Api-Key: <key>' \
  -H 'X-Api-Token: <token>'

Website Evolution gives insights to how website is chronologically developing eg. when pages like “Blog”, “Privacy policy”, “Pricing”, “Product”, “API Docs”, “Team”, “Support pages” etc. were added. This can serve as a proxy to how quickly a website is growing, to determine the growth stage they are at and also to help segment websites.

{
  "data": [

    {
      "id": "00000000-0000-0000-0000-000020202026",
      "type": "subpage",
      "attributes": {
        "category": "blog",
        "url": "https://prisma.io/blog",
        "first_seen_at": "2018-07-07T15:21:17.765+02:00",
        "last_seen_at": "2019-10-19T12:45:24.804+02:00"
      },
      "relationships": {}
    },
    ...
  ],
  "meta": {
    "count": 24
  }
}

HTTP Request

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

Request Parameters

Parameter Description
limit string Limit the number of shown events per page. Default is 30, maximum is 100.

For the endpoint to return total number of records please add a page parameter to your query eg. page=1.

More information on the website_evolution object is available here.

To get more results use pagination.

Github repositories

curl -X GET "https://predictleads.com/api/v2/companies/openmeter.io/github_repositories" \
  -H 'X-Api-Key: <key>' \
  -H 'X-Api-Token: <token>'

GitHub repositories gives insight into how frequently a website is contributing to its public GitHub repository.

{
  "data": [
    {
      "id": "1c2f062f-2a98-4094-b5f9-873da16f9466",
      "type": "github_repository",
      "attributes": {
        "url": "https://github.com/openmeterio/openmeter",
        "description": "Real-Time, Accurate Usage Metering for Billing, Chargeback and Infrastructure.",
        "first_seen_at": "2023-06-21T05:28:35Z"
      },
      "relationships": {
        "company": {
          "data": {
            "id": "351747922",
            "type": "company"
          }
        },
        "timeseries_datapoints": {
          "data": [
            {
              "id": "7e1b166f-5c76-43b0-bd05-5a339bbc6d67",
              "type": "timeseries_datapoint"
            },
            ...
          ]
        }
      }
    },
    ...
  ],
  "included": [
    {
      "id": "7e1b166f-5c76-43b0-bd05-5a339bbc6d67",
      "type": "timeseries_datapoint",
      "attributes": {
        "timestamp": "2023-06-21T07:28:35.759+02:00",
        "data": {
          "forks": 5,
          "stars": 86,
          "watches": 3,
          "last_update_at": "2023-06-20T11:17:04Z"
        }
      }
    },
    ...
  ],
  "meta": {
    "count": 21
  }
}

HTTP Request

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

Request Parameters

Parameter Description
limit string Limit the number of shown events per page. Default is 30, maximum is 100.

For the endpoint to return total number of records please add a page parameter to your query eg. page=1.

More information on the github_repository object is available here.

To get more results use pagination.

Products

curl -X GET "https://predictleads.com/api/v2/companies/accountablehq.com/products" \
  -H 'X-Api-Key: <key>' \
  -H 'X-Api-Token: <token>'

Products dataset identifies what kind of products / solutions / features a company is offering.

{
  "data": [
    {
      "id": "56452a8a-6c41-49a2-aed7-35c14043782d",
      "type": "product",
      "attributes": {
        "name": "SSO/SAML",
        "sources": [
          "pricing"
        ],
        "url": "https://www.accountablehq.com/pricing",
        "first_seen_at": "2022-03-19T09:39:51Z",
        "last_seen_at": "2022-03-19T09:39:51Z"
      },
      "relationships": {}
    },
    ...
  ],
  "included": [],
  "meta": {
    "count": 32
  }
}

HTTP Request

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

Request Parameters

Parameter Description
limit string Limit the number of shown events per page. Default is 30, maximum is 100.
sources string comma separated.

For the endpoint to return total number of records please add a page parameter to your query eg. page=1.

More information on the product object is available here.

To get more results use pagination.

Company

curl -X GET "https://predictleads.com/api/v2/companies/hubspot.com" \
  -H 'X-Api-Key: <key>' \
  -H 'X-Api-Token: <token>'

Returns basic information about the company like company location, company name, ticker, meta description…

{
  "data": [
    {
      "id": "1438333",
      "type": "company",
      "attributes": {
        "domain": "hubspot.com",
        "location": "California, United States",
        "location_data": {
          "state": "California",
          "country": "United States"
        },
        "company_name": "HubSpot, Inc.",
        "friendly_company_name": "HubSpot",
        "ticker": "NYSE:HUBS",
        "meta_title": "HubSpot | Software, Tools, Resources for Your Business",
        "meta_description": "HubSpot's CRM platform contains the marketing, sales, service, operations, and website-building software you need to grow your business."
      },
      "relationships": {}
    }
  ],
  "included": [],
  "meta": {}
}

HTTP Request

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

Redirects

curl -X GET "https://predictleads.com/api/v2/companies/snowflake.net" \
  -H 'X-User-Email: <email>' \
  -H 'X-User-Token: <token>'

Sometimes companies undergo rebranding or get acquired and thus the domain of their website changes, which means we need to start tracking them as a different entity. This would be inconvenient if there were no link between the old and new company, which we solve with an extra field when querying the domain.

{
  "data": [
    {
      "id": "1477073",
      "type": "company",
      "attributes": {
        "domain": "snowflake.net",
        "location": "Bozeman, Montana, United States",
        "location_data": {
          "city": "Bozeman",
          "state": "Montana",
          "country": "United States"
        },
        "company_name": "Snowflake",
        "friendly_company_name": "Snowflake Computing",
        "ticker": null,
        "meta_title": "The Enterprise Data Warehouse Built in the Cloud | Snowflake",
        "meta_description": "Snowflake is the only data warehouse built in the cloud, for all your data & all your users. Conventional data warehouses and big data solutions struggle to make it easy to amass data and enable rapid analytics and insights. In response, Snowflake built a new SQL data warehouse from the ground up. Learn more."
      },
      "relationships": {
        "redirects_to": {
          "data": {
            "id": "3500291",
            "type": "company"
          },
          "meta": {
            "reason": "rebranding"
          }
        }
      }
    }
  ],
  "included": [
    {
      "id": "3500291",
      "type": "company",
      "attributes": {
        "domain": "snowflake.com",
        "company_name": "Snowflake Inc.",
        "ticker": "NYSE:SNOW"
      }
    }
  ],
  "meta": {}
}

HTTP Request

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

Discover

Discover via StartupPlatform

curl -X GET "https://predictleads.com/api/v2/discover/startup_platform/latest" \
  -H 'X-Api-Key: <key>' \
  -H 'X-Api-Token: <token>'

Find companies that are hiring or launching new products via Hacker News (news.ycombinator.com) and similar platforms.

{
  "data": [{
    "id": "247825",
    "type": "startup_platform_post",
    "attributes": {
      "published_at": "2020-08-12 00:24:30 +0200",
      "post_type": "job_hn",
      "post_url": "https://news.ycombinator.com/item?id=24126709",
      "company_domain": "repl.it",
      "company_name": "Repl",
      "fuzzy_match": false
    }
  },
    ...
  ],
  "meta": {
    "count": 180013
  }
}

curl -X GET "https://predictleads.com/api/v2/discover/startup_platform/jobs_hn" \
  -H 'X-Api-Key: <key>' \
  -H 'X-Api-Token: <token>'

{
  "data": [{
    "id": "247782",
    "type": "startup_platform_post",
    "attributes": {
      "published_at": "2020-08-11 16:28:16 +0200",
      "post_type": "job_hn",
      "post_url": "https://news.ycombinator.com/item?id=24120589",
      "company_domain": "forma.ai",
      "company_name": "Forma AI, Inc.",
      "fuzzy_match": false
    }
  },
    ...
  ],
  "meta": {
    "count": 65106
  }
}

HTTP Request

GET https://predictleads.com/api/v2/discover/startup_platform/jobs_hn

HTTP Request

GET https://predictleads.com/api/v2/discover/startup_platform/show_hn

Returns companies that have posted in Show HN format on Hacker News.

Request Parameters

Parameter Description
post_datetime_from date (ISO 8601) Found HN posts from specified date.
post_datetime_until date (ISO 8601) Found HN posts from specified date.
min_score date (ISO 8601) Minimum required HN score (Coming soon …).
limit string Limit the number of shown events per page. Default is 30, maximum is 100.

Segments

Returns a list of companies matching your segment criteria. Companies are sent on a periodic basis eg. weekly, bi-weekly, monthly.

Matching companies are sent onto segment webhook URL. If webhook URL is not set, companies are sent to your email.

Company segments enable you to personalize outreach and messaging. Leverage buying signals and identify new sets of companies. Eg.: you can create a segment of companies that use Salesforce and recently posted a job opening for iOS Developers.

Create segment

curl -X POST "https://predictleads.com/api/v2/segments"
  -d '{"technologies":"Salesforce", "job_categories":"sales"}'
  -H "Content-Type: application/json" \
  -H 'X-Api-Key: <key>' \
  -H 'X-Api-Token: <token>'

Creates a segment of companies with a set of query parameters.

{
  "data": {
    "id": "1093",
    "type": "segment",
    "attributes": {
      "name": null,
      "webhook_url": null,
      "active": null,
      "recurrence": "onetime",
      "job_categories": [
        "sales"
      ],
      "locations": null,
      "event_relationship_type_names": null,
      "event_tags": null,
      "found_at_from": "2021-03-29T15:18:37.237+02:00",
      "found_at_until": null,
      "technology_names": [
        "Salesforce"
      ]
    }
  },
  "meta": {
    "message": "Segment successfully created.",
    "message_type": "segment_created"
  }
}

HTTP Request

POST https://predictleads.com/api/v2/segments

Request Parameters

Parameter Description
webhook_url string We’ll send the data to this URL.
locations string List of company locations separated by comma (,). Ie.: CA, FL, France.
headquarters_locations string List of company headquarters locations separated by comma (,). Ie.: CA, FL, France.
job_categories string List of job categories separated by comma (,). Ie.: marketing, education, software_development.
technologies string List of technologies separated by comma (,). Ie.: Salesforce, Gitlab, Slack.
found_at_from date (ISO 8601) Signals found from specified date.
found_at_until date (ISO 8601) Signals found until specified date.
active string Set to “false” to deactivate the segment.
limit string Limit the number of shown events per page. Default is 10, maximum is 100.

Use abbreviations for US states ie.: CA, FL and countries for other locations: Germany, China, Japan …

All /segment parameters can be used to create a segment.

List of job opening categories is available here.

For getting a list of technologies please contact us at founders@predictleads.com.

Sample segment Webhook payload

{
  "data": [{
    "id": "348068",
    "type": "company",
    "attributes": {
      "domain": "boozallen.com",
      "company_name": "Booz Allen Hamilton",
      "friendly_company_name": "Booz Allen Hamilton",
      "ticker": "NYSE:BAH"
    }
  },
    ...
  ],
  "meta": {
    "count": 21251
  }
}

Returns a list of companies that satisfy given Segment parameters.

Update segment

curl -X PUT "https://predictleads.com/api/v2/segments/721"
  -d '{"webhook_url":"https://requestb.in/2940cn"}'
  -H "Content-Type: application/json" \
  -H 'X-Api-Key: <key>' \
  -H 'X-Api-Token: <token>'

Updates the segment.

{
  "data": {
    "id": "721",
    "type": "segments",
    "attributes": {
      "name": null,
      "webhook_url": "https://requestb.in/2940cn",
      "active": true,
      "recurrence": "onetime",
      "job_categories": [
        "Sales"
      ],
      "locations": [
        "United States"
      ],
      "event_relationship_type_names": null,
      "company_partnered_with_stock_exchange_company": null,
      "company_not_on_stock_exchange": null,
      "event_tags": null,
      "found_at_from": null,
      "found_at_until": null,
      "technology_names": [
        "Salesforce",
        "Outreach.io"
      ]
    },
    "meta": {
      "message": "Segment successfully updated.",
      "message_type": "segment_updated"
    }
  }
}

HTTP Request

PUT https://predictleads.com/api/v2/segments/:id

Request Parameters

Parameter Description
id string ID of the segment.
webhook_url string We’ll send the data to this URL.
active string Set to “false” to deactivate the segment.

All /segment parameters can be used to update a segment.

Show segment

curl -X GET "https://predictleads.com/api/v2/segments/721"
  -H "Content-Type: application/json" \
  -H 'X-Api-Key: <key>' \
  -H 'X-Api-Token: <token>'

Show segment attributes.

{
  "data": {
    "id": "1060",
    "type": "segment",
    "attributes": {
      "name": null,
      "webhook_url": null,
      "active": true,
      "recurrence": "onetime",
      "job_categories": [
        "Sales"
      ],
      "locations": [
        "United States"
      ],
      "event_relationship_type_names": null,
      "company_partnered_with_stock_exchange_company": null,
      "company_not_on_stock_exchange": null,
      "event_tags": null,
      "found_at_from": null,
      "found_at_until": null,
      "technology_names": [
        "Salesforce",
        "Outreach.io"
      ]
    }
  }
}

HTTP Request

GET https://predictleads.com/api/v2/segments/:id

Show all segments

curl -X GET "https://predictleads.com/api/v2/segments"
  -H "Content-Type: application/json" \
  -H 'X-Api-Key: <key>' \
  -H 'X-Api-Token: <token>'

Returns a list of all your segments.

{
  "data": [{
    "id": "1060",
    "type": "segment",
    "attributes": {
      "name": null,
      "webhook_url": null,
      "active": true,
      "recurrence": "onetime",
      "job_categories": [
        "Sales"
      ],
      "locations": [
        "United States"
      ],
      "event_relationship_type_names": null,
      "company_partnered_with_stock_exchange_company": null,
      "company_not_on_stock_exchange": null,
      "event_tags": null,
      "found_at_from": null,
      "found_at_until": null,
      "technology_names": [
        "Salesforce",
        "Outreach.io"
      ]
    }
  },
    ...
  ]
}

HTTP Request

POST https://predictleads.com/api/v2/segments

Signal objects

Listed here are all types of returned signal objects.

Event

Examples of event objects

{
  "data": [{
    "id": "998e1763-8a7e-4ad8-836d-053d0d0c67ac",
    "type": "event",
    "attributes": {
      "categories": [
        "invests_into"
      ],
      "title": "Greycroft Partners invests into Klasha, Inc. in $2.4M",
      "found_at": "2021-10-13T02:21:50Z",
      "url": "https://www.techinafrica.com/africa-cross-border-commerce-platform-klasha-raises-2-4m-expands-to-ghana/",
      "additional_data": {
        "location": "San Francisco, California, United States",
        "location_data": {
          "country": "United States",
          "city": "San Francisco",
          "fuzzy_match": false,
          "state": "California"
        },
        "amount": 2400000,
        "article_title": "Africa cross-border commerce platform Klasha raises $2.4M, expands to Ghana",
        "article_sentence": "San Francisco and Nigeria-based Klasha has raised $2.4 million in a round led by Greycroft to scale its offering.",
        "article_source": "techinafrica.com",
        "article_published_at": "2021-10-13T04:21:50.000Z",
        "confidence": "0.7269"
      }
    },
    "relationships": {
      "company1": {
        "data": {
          "id": "444790",
          "type": "company"
        }
      },
      "company2": {
        "data": {
          "id": "8333660",
          "type": "company"
        }
      }
    }
  },,
    ...
  ],
  "included": [
    {
      "id": "444790",
      "type": "company",
      "attributes": {
        "domain": "greycroft.com",
        "company_name": "Greycroft Partners",
        "ticker": null
      }
    },
    {
      "id": "8333660",
      "type": "company",
      "attributes": {
        "domain": "klasha.com",
        "company_name": "Klasha, Inc.",
        "ticker": null
      }
    },
  ],
  "meta": {
    "count": 9
  }
}

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

Attribute Description
id UUID
Unique signal identifier (unique across signal types).
categories array
Type of the event - full list below.
title string
Autogenerated title from the data.
url string
Most relevant source URL.
found_at datetime
Time & date (ISO 8601) of the published document.
additional_data hash
Additional data regarding the signal. See attributes below.
relationships hash
Associated Company information: Company IDs and connection order. IDs are referenced in the included object.
included array
Includes references to the relationships object. It enables you to connect company IDs with related company domain name.

Additional data

Attribute Description
relationships > companies array
Array of company domains in the signal (max 2)
When category involves two companies ie.: acquires. The order of the companies in the array is guaranteed so that the first company in the array is the acquirer and the second is the acquiree. Same goes for other categories like sells_assets_to, integrates_with …
date date
Date (ISO 8601) of when the event happened.
location string
Location of where the event happened or where the organization has expanded/relocated.
location_data hash
Structured location data. Can include the following location attributes: city, state, country, fuzzy_match
contact string
Full name of the person in the personnel change.
job_title string
Full job title of the person in the personnel change.
product string
Name of the product that was launched.
product_tags array
List of tags regarding the product.
amount integer
Total amount of the deal in $ (investments, acquisitions, new clients).
recognition string
Name of recognition the company received.
assets string
Company’s assets.
asset_tags array
List of tags regarding the assets.
headcount integer
Number of employees hired or let go.
award string
Name of award the company received.
financing_type string
Stage of the funding round (seed, Series A, Series B, …, Angel funding, …).
financing_type_tags array
List of tags regarding the financing.
funding_round string
Funding round type (Angel, Seed, Accelerator, Series A, Series B …)
division string
Whether event concerns a specific division.
conference string
Conference where the company received award or recognition.
vulnerability string
Company issue
planning boolean
Event is not set in stone.
article_title string
Article title.
article_sentence string
Excerpt from an article.
article_body string
Article body.
article_source string
Where the article was found.
article_published_at string
Date (ISO 8601) of when the article was published.

Event categories

Signal Group Description
hires leadership Company hired new executive or senior personnel.
promotes leadership Company promoted existing executive or senior personnel.
leaves leadership Executive or senior personnel left the company.
retires leadership Executive or senior personnel retires from the company.
acquires acquisition Company acquired other company.
merges_with acquisition Company merges with other company.
sells_assets_to acquisition Company sells assets (like properties or warehouses) to other company.
expands_offices_to expansion Company opens new offices in another town, state, country or continent.
expands_offices_in expansion Company expands existing offices.
expands_facilities expansion Company opens new or expands existing facilities like warehouses, data centers, manufacturing plants etc.
opens_new_location expansion Company opens new service location like hotels, restaurants, bars, hospitals etc.
increases_headcount_by expansion Company offers new job vacancies.
launches new_offering Company launches new offering.
integrates_with new_offering Company integrates with other company.
is_developing new_offering Company begins development of a new offering.
receives_financing investment Company receives investment like venture funding, loan, grant etc.
invests_into investment Company invests into other company.
invests_into_assets investment Company invests into assets like property, trucks, facilities etc.
goes_public investment Company issues shares to the public for the first time.
closes_offices cost_cutting Company closes existing offices.
decreases_headcount_by cost_cutting Company lays off employees.
partners_with partnership Company partners with other company.
receives_award recognition Company or person at the company receives an award.
recognized_as recognition Company or person at the company receives recognition.
signs_new_client contract Company signs new client.
files_suit_against corporate_challenges Company files suit against other company.
has_issues_with corporate_challenges Company has vulnerability problems.
identified_as_competitor_of relational New or existing competitor was identified.

Job opening

Examples of job_opening objects

    {
    "data": [
      {
        "id": "4d5ac23c-5824-427d-96c6-4e8d50a4241a",
        "type": "job_opening",
        "attributes": {
          "title": "AI Engineer",
          "url": "https://www.ycombinator.com/companies/terra/jobs/0f5CP0r-ai-engineer",
          "description": "**AI Engineer**\n\n\n**$50K - $120K** /  0.10% - 0.50%  **Location** London, England, GB  **Job Type** Full-time  **Experience** Any (new grads ok)   Apply to Terra and hundreds of other fast-growing YC startups with a single profile.    ****\n\nPlaid for healthcare\n\n\n**About the role**\n\nWe work in super small teams, with extremely high velocity.\n\nWe are building multiple AI products, such as OdinAI, Graph API, and many more\n\nAs an AI engineer, you'll work in a small team, with maximum autonomy.\n\n* Be behind the curtain, creating, testing, and implementing AI models\n* Engage in data analysis, machine learning, and natural language processing.\n* Fine-tuning the AI's performance and many more\n\nPreferred background:\n\nBachelor's or Master's degree in STEM. Strong technical skills (e.g. familiarity with a programming language such as Python, JavaScript, or Ruby) Experience with growth marketing, product development, and user acquisition/retention\n\n\n**Must haves.**\n\n-Must have done this before, or be willing to learn fast.\n\n-Must be fast. We operate at 200mph, and so do you.\n\n-Must be relentless. We never stop, so you are even faster than us.\n\n-Must have customer driven. We think customers first and so should you.\n\n-Must be driven and go above and beyond.\n\n-Must be able to explain and communicate clearly.\n\n-Must be prepared to challenge us and disagree. We are thinking and acting as a team.\n\n-Must be able to work autonomously.\n\n-Must want to work hard.\n\n-Last but not least, you are genuinely a nice person.\n\n**Big plus** You are an athlete, or care about quantifying your data\n\n\n**About Terra**\n\n**What we do**\n\nTerra is an API that makes it easy for apps to connect to wearables. Currently, apps and developers in the fitness, wellness, sleep, and other health spaces are using us. Terra was launched in early 2021, and since then we’ve been growing like crazy. But this is just the beginning.\n\n\n**The goal and vision**\n\nThink if Spotify and Netflix create music and movies based on your heart rate, and stress levels, in real time. We want to enable apps to achieve that reality, through our super easy to use API.\n\n\n**Funding**\n\nTo achieve our grand goal, we couldn’t have made it without the support from some incredible investors. We are lucky enough to be supported by , ,  and we were part of  batch.\n\n, and learn who we are \n\nLocation: San Francisco",
          "salary": "USD50000 - USD120000",
          "salary_data": {
            "salary_low": 50000.0,
            "salary_high": 120000.0,
            "salary_currency": "USD",
            "salary_low_usd": 50000.0,
            "salary_high_usd": 120000.0,
            "salary_time_unit": "year"
          },
          "job_opening_closed": false,
          "location": "London, United Kingdom",
          "contract_types": [
            "full time"
          ],
          "first_seen_at": "2023-07-03T08:36:13Z",
          "last_seen_at": "2023-07-12T16:27:59Z",
          "last_processed_at": "2023-07-12T16:27:59Z",
          "categories": [
            "engineering"
          ],
          "additional_data": {
            "job_title_seniority": "non_manager",
            "tags": [
              "Growth",
              "Python",
              "Plaid",
              "JavaScript"
            ],
            "location_data": {
              "country": "United Kingdom",
              "city": "London",
              "fuzzy_match": false
            }
          }
        },
        "relationships": {
          "company": {
            "data": {
              "id": "22379668",
              "type": "company"
            }
          }
        }
      },
      ...,
    ],
    "included": [
      {
        "id": "22379668",
        "type": "company",
        "attributes": {
          "domain": "tryterra.co",
          "company_name": "Tryterra",
          "ticker": null
        }
      }
    ],
    "meta": {}
  }
Attribute Description
id UUID
Unique signal identifier (unique across signal types).
type string
Signal type: “job_opening”.
attributes hash
Includes different job opening attributes.
title string
Job title
url string
URL of the web page where the data was found.
description string
Job opening description.
first_seen_at datetime
Time & date (ISO 8601) of when the job opening was first seen.
last_seen_at datetime
Time & date (ISO 8601) of when the job opening was last seen.
job_opening_closed boolean
True if keyword eg.: “job no longer available”, “vacancy listing expired”, “position filled” … is found on job opening site. Please also deem job opening as closed if last_seen_at is greater than 3 weeks ago. Job openings are crawled every 36 hours though it might happen that we cannot access the job opening with every crawl.
categories array
Array of categories - full list below.
salary string
String eg.: “£40000 - £50000 GBP”.
salary_data hash
Additional data regarding the salary. See attributes below.
contract_types array
Array of strings eg.: [“full time”, “remote”]
location string
Location

Additional data

Attribute Description
job_title_seniority string
Seniority inferred from job opening title. Possible values listed below.
tags array
Includes keywords found under job opening descriptions.
description string
Job opening description in a more raw form to enable searching by keywords. Unicode normalization form NFKD is used.
location_data hash
Can include the following location attributes: city, state, country, fuzzy_match.

Salary data

Attribute Description
salary_low string
Salary range lower bound. If salary is not a range both low and high values will be the same.
salary_high string
Salary range upper bound.
salary_currency string
Salary currency.
salary_low_usd string
Salary range lower bound, converted to USD.
salary_high_usd string
Salary range upper bound, converted to USD.
salary_time_unit string
possible values: “hour”, “day”, “week”, “month”, “year”

Job openings are crawled every 36 hours though it might happen that we cannot access the job opening with every crawl.

Job opening can be deemed closed if job_opening_closed attribute is set to true or if last_seen_at data is eg. over 2-3 weeks old. If you want to only include super fresh job openings then simply only include those that have last_seen_at timestamp eg. younger than 24h.

Job ID will persist and remain the same through the job opening lifespan.

Job opening categories

["administration", "consulting", "data_analysis", "design", "directors", "education", "engineering", "finance", "food", "healthcare_services", "human_resources", "information_technology", "internship", "legal", "management", "manual_work", "marketing", "military_and_protective_services", "operations", "purchasing", "product_management", "quality_assurance", "real_estate", "research", "sales", "software_development", "support"]

Job opening seniority

["owner", "founder", "c_level", "partner", "president", "vice_president", "head", "director", "manager", "non_manager"]

Technology

Examples of technology objects

{
  "data": [{
    "id": "31b5ef46-606e-4bf9-9b03-e2f030b72b10",
    "type": "technology",
    "attributes": {
      "categories": [
        "miscellaneous"
      ],
      "domain": "ogp.me",
      "first_seen_at": "2022-12-08T10:40:41Z",
      "last_seen_at": "2023-03-08T10:48:08Z",
      "url": "https://ogp.me",
      "title": "Open Graph",
      "behind_firewall": false,
      "score": 1.0
    },
    "relationships": {
      "company": {
        "data": {
          "id": "1595944",
          "type": "company"
        }
      },
      "seen_on_job_openings": {
        "data": [
          {
            "id": "868cb5ac-355b-4e68-a811-1e630502ba1a",
            "type": "job_opening"
          },
          ...,
        ]
      },
      "seen_on_subpages": {
        "data": [
          {
            "id": "093ad986-ab24-4a50-a9d9-0acf411dd50b",
            "type": "subpages"
          },
          ...,
        ]
      }
    }
  },
  ...,
  ],
  "included": [
    {
      "id": "868cb5ac-355b-4e68-a811-1e630502ba1a",
      "type": "job_opening",
      "attributes": {
        "url": "https://jobs.lever.co/madkudu/01cdaa90-3d4b-47b5-bf29-5c04eb96f726",
        "first_seen_at": "2022-12-19T09:29:54Z",
        "last_seen_at": "2023-01-30T21:12:14Z"
      }
    },
    {
      "id": "093ad986-ab24-4a50-a9d9-0acf411dd50b",
      "type": "subpage",
      "attributes": {
        "url": "https://www.madkudu.com",
        "first_seen_at": "2018-07-09T21:35:33Z",
        "last_seen_at": "2023-03-08T10:48:08Z"
      }
    }
    {
      "id": "1595944",
      "type": "company",
      "attributes": {
        "domain": "madkudu.com",
        "company_name": "Madkudu",
        "ticker": null
      }
    },
    ...,
  ],
  "meta": {
    "count": 83
  }
}
Attribute Description
id integer
Unique trigger identifier (unique across all trigger types).
categories array
Array of categories - full list below.
title string
Technology name.
url string
URL of the web page where the data was found.
first_seen_at datetime
Time & date (ISO 8601) of when the technology was first seen.
last_seen_at datetime
Time & date (ISO 8601) of when the technology was last seen.
score float
Technology usage confidence score.
relationships hash
Company website and job openings and subpages where technology signal was found. IDs are referenced in the included object.

Technology categories

["a/b_testing", "accessibility", "account-based_marketing", "accounting", "accounting_and_finance", "ad_creative_management", "ad_exchanges", "ad_servers", "ad_verification_and_optimization", "advanced_analytics_and_data_science", "advertising", "advertising_networks", "advocacy_marketing", "affiliate_advertising_networks", "analytics", "api_management", "applicant_tracking_systems", "application_development_&_management", "application_security_testing", "appointment_scheduling", "archiving", "association_management", "audio,_video,_graphics", "augmented_reality", "automotive_marketing", "automotive_website_design_and_development_services", "backup_and_recovery", "big_data_processing", "blockchain", "blogs", "brand_protection_software", "build_automation", "business_intelligence", "business_process_management", "cache_tools", "caching", "cad_&_graphics", "call_tracking", "camp_management", "captcha", "charting", "click-to-call", "cloud_hosting", "cloud_infrastructure_computing", "comment_systems", "communication_and_collaboration", "communications_technology", "configuration_management", "configure_price_quote", "consent_management", "contact_center_solutions", "containerization", "content_delivery_network", "content_management_system", "content_marketing", "continuous_integration", "control_systems", "cookie_compliance", "corporate_learning_management_systems", "corporate_performance_management", "cross-border_e-commerce", "cryptominers", "customer_communication_management", "customer_data_platforms", "customer_experience_management", "customer_feedback_management", "customer_relationship_management", "customer_self-service", "customer_service", "data_integration", "data_management", "data_management_platforms", "data_quality_management", "data_security", "data_warehousing", "database", "database_management", "database_management_software", "ddos_and_bot_protection", "demand_side_platforms", "deployment", "design", "dev_tools", "development", "devops", "digital_asset_management", "document_management_systems", "documentation_tools", "domain_name_services", "e-commerce", "e-commerce_analytics_software", "e-commerce_platforms", "ediscovery", "editors", "education_management", "electronic_health_records", "electronic_signatures", "email", "email_delivery", "email_hosting", "email_marketing", "email_security", "email_tracking", "endpoint_protection", "enterprise", "enterprise_content_management", "enterprise_data_storage", "enterprise_mobility_management", "enterprise_resource_planning", "enterprise_search", "error_and_exception_monitoring", "event_management", "facilities_management", "file_sharing", "fitness_and_gym_management", "font_scripts", "food_ordering_and_delivery", "frameworks_and_libraries", "fraud_detection_and_prevention", "fundraising_and_donation_management", "governance,_risk_and_compliance", "header_bidding", "health_platform", "healthcare_marketing", "help_desk_management", "help_desk_software", "hospitality_marketing", "hosting_panels", "hotel_management", "hotel_reservations", "hris_management", "human_capital_management", "human_resource", "human_resource_management_system", "identity_and_access_management", "identity_verification", "influencer_marketing_software", "infrastructure_as_a_service", "insurance_software", "integrated_development_environments", "intelligence_and_analytics", "inventory_and_order_management", "issue_trackers", "it", "it_infrastructure", "it_infrastructure_&_operations_management", "it_infrastructure_monitoring", "it_service_management", "javascript_frameworks", "javascript_graphics", "javascript_libraries", "job_board_software", "lead_generation", "learning_management_system", "legal_solutions", "live_blogging", "live_chat", "live_streaming_platforms", "load_balancers", "local_marketing", "logging", "logistics", "loyalty_and_gamification", "machine_learning", "mapping_and_gis", "maps", "marketing", "marketing_analytics", "marketing_automation", "marketing_data_providers", "marketing_performance_measurement", "message_boards", "middleware_software", "miscellaneous", "mobile_application_development_platforms", "mobile_apps", "mobile_frameworks", "multichannel_retail_software", "network_hardware", "network_management", "network_management_(software)", "network_security", "office_suites", "online_banking", "online_community_software", "online_form_builders", "online_review_management", "online_video_platforms", "open_source", "operating_systems", "operating_systems_&_computing_languages", "operations", "page_builders", "partner_management_software", "payment_processing", "payroll_management_and_benefits_administration", "payroll_processing", "performance", "personalization", "photo_galleries", "platform_as_a_service", "points_of_sale", "pre-employment_assessment", "predictive_analytics", "printers", "procurement", "product_information_management", "programming", "programming_languages", "project_management", "push_notifications", "real_estate_marketing", "real_estate_property_management", "real_user_monitoring", "realty", "recruitment_marketing", "recurring_billing", "referral_marketing", "release_management", "restaurant_reservations", "retail_analytics_software", "retail_operations_software", "retargeting", "rich_text_editors", "risk_and_compliance", "sales", "sales_enablement", "sales_performance_management", "search_engines", "search_marketing", "security", "security_information_and_event_management", "server_hardware", "servers", "shopping_cart", "site_and_cart_abandonment", "site_search", "size_and_fit_prediction", "social_login", "social_media_analytics_and_monitoring", "social_media_marketing_software", "social_sharing", "software_as_a_service", "software_development", "software_framework", "source_code_management", "spa_and_salon_management", "sports_management", "sports_website_design_and_development_services", "ssl_certificate", "stock_images_providers", "storage", "supply_chain_management", "supply_side_platforms", "system_analytics_&_monitoring", "system_security_services", "tag_management", "team_collaboration", "testing_and_qa", "threat_intelligence", "ticket_booking", "time_tracking", "tours_and_activities_reservations", "translation", "transportation_and_fleet_management", "travel_and_expense_management", "ui_frameworks", "unified_communications", "user_onboarding", "video_advertising_networks", "video_players", "virtual_private_networks", "virtualisation_software", "visitor_counters", "visual_and_user_generated_content_marketing", "visualisation_software", "warehouse_management", "web_&_portal_technology", "web_accelerators", "web_analytics", "web_and_application_servers", "web_application_firewalls", "web_conferencing", "web_design_and_development_services", "web_fonts", "web_frameworks", "web_hosting", "web_platform_extensions", "web_server_extensions", "web_servers", "web_tools_and_plugins", "website_builders", "widgets", "wikis"]

Technology scores

If detected directly on website

No. of hits Score
1 0.5
2 0.75
3 0.88
4 0.94
5 0.97
6 0.98
7 0.99
8+ 1.00

If detected behind firewall

No. of hits Score
1 0.25
2 0.39
3 0.47
4 0.52
5 0.57
6 0.61
7 0.66
8 0.70
9 0.75
10 0.79
11 0.84
12 0.88
13 0.93
14 0.97
15+ 1.00

Connection

Examples of connection objects

{
  "data": [{
    "id": "168d9d73-3a8b-492f-b5bc-35564a5ff1fe",
    "type": "connection",
    "attributes": {
      "category": "vendor",
      "source_category": "vendor_page",
      "source_url": "https://funnel.io/customers",
      "first_seen_at": "2021-08-23T09:08:38Z",
      "last_seen_at": "2021-10-18T11:30:23Z"
    },
    "relationships": {
      "company1": {
        "data": {
          "id": "1828101",
          "type": "company"
        }
      },
      "company2": {
        "data": {
          "id": "1464778",
          "type": "company"
        }
      }
    }
  },
    {
      "id": "d76d778a-06be-470f-b7f2-937a81b4b7d5",
      "type": "connection",
      "attributes": {
        "category": "partner",
        "source_category": "partner_page",
        "source_url": "https://1wirefiber.com",
        "first_seen_at": "2021-07-15T10:50:55Z",
        "last_seen_at": "2021-10-23T15:10:12Z"
      },
      "relationships": {
        "company1": {
          "data": {
            "id": "4965363",
            "type": "company"
          }
        },
        "company2": {
          "data": {
            "id": "1464778",
            "type": "company"
          }
        }
      }
    },
    ...,
  ],
  "included": [{
    "id": "1828101",
    "type": "company",
    "attributes": {
      "domain": "funnel.io",
      "company_name": "Funnel",
      "ticker": null
    }
  },{
    "id": "1464778",
    "type": "company",
    "attributes": {
      "domain": "pipedrive.com",
      "company_name": "Pipedrive, Inc.",
      "ticker": null
    }
  },{
    "id": "4965363",
    "type": "company",
    "attributes": {
      "domain": "1wirefiber.com",
      "company_name": "1Wire Communications",
      "ticker": null
    }
  }
    ...,
  ],
  "meta": {
    "count": 83
  }
}
Attribute Description
id integer
Unique connection identifier (unique across all trigger types).
category string
Connection category. See full list below.
source_category string
Describes where the category was found. See full list below.
companies > data string
Order of companies under data is guaranteed to be such that fits the category.
source_url string
URL where connection was found.
first_seen_at datetime
Time & date (ISO 8601) of when the connection was first seen.
last_seen_at datetime
Time & date (ISO 8601) of when the connection was last seen.
relationships hash
Company information: Company IDs and connection order. IDs are referenced in the included object.
included array
Includes references to the relationships object. It enables you to connect company IDs with related company domain name.

Connection category

Can be one of the following: "partner", "vendor", "purchaser", "integration", "investor", "holding", "parent", "rebranding", "published_in", "other"

Connection source_category

Can show us more info on how the connection was found. This is the full list: “` "undefined”,

“footer”, “manual_input”, “domain_redirect”, “same_subpage”,

“partner_page”, “vendor_page”, “purchaser_page”, “integration_page”, “investor_page”, “sponsor_page”, “parent_page”, “case_study_page”, “testimonial_page”, “social_page”,

“partner_section”, “vendor_section”, “purchaser_section”, “integration_section”, “investor_section”, “sponsor_section”, “parent_section”, “case_study_section”, “testimonial_section”, “social_section”, published_in_section,

“vendor_inverse_section”, “investor_inverse_section”, “parent_inverse_section” “`

Subpage

Examples of website evolution objects

{
  "data": [{
    "id": "c626a256-e9e6-461b-9d28-b9a1d0f67d71",
    "type": "subpage",
    "attributes": {
      "category": "about",
      "url": "https://fly.io/docs/hands-on/start",
      "first_seen_at": "2020-07-05T18:25:39.792+02:00",
      "last_seen_at": "2022-03-02T07:11:27.031+01:00"
    },
    "relationships": {}
  },
    ...,
  ],
  "included": [],
  "meta": {
    "count": 17
  }
}
Attribute Description
id integer
Unique connection identifier (unique across all trigger types).
type string
Type is: "subpage”.
category string
Subpage category. See full list below.
url string
Subpage URL.
first_seen_at datetime
Time & date (ISO 8601) of when the subpage was first seen.
last_seen_at datetime
Time & date (ISO 8601) of when the subpage was last seen.
relationships hash
Since there are not relationships between companies in this dataset it will be blank.

Subpage category

Can be one of the following: 'jobs', 'blog', 'news', 'press', 'pricing', 'case_studies', 'customers', 'testimonials', 'suppliers', 'partners', 'integrations', 'portfolio', 'contact', 'investors', 'leadership', 'support', 'login', 'products', 'solutions', 'status', 'demo', 'resources', 'events', 'developers', 'API', 'terms', 'privacy', 'trust', 'feedback', 'marketplace', 'store', 'community', 'retail', 'about'

GitHub repository

Examples of GitHub repository objects

{
  "data": [
    {
      "id": "1c2f062f-2a98-4094-b5f9-873da16f9466",
      "type": "github_repository",
      "attributes": {
        "url": "https://github.com/openmeterio/openmeter",
        "description": "Real-Time, Accurate Usage Metering for Billing, Chargeback and Infrastructure.",
        "first_seen_at": "2023-06-21T05:28:35Z"
      },
      "relationships": {
        "company": {
          "data": {
            "id": "351747922",
            "type": "company"
          }
        },
        "timeseries_datapoints": {
          "data": [
            {
              "id": "7e1b166f-5c76-43b0-bd05-5a339bbc6d67",
              "type": "timeseries_datapoint"
            },
            ...
          ]
        }
      }
    },
    ...
  ],
  "included": [
    {
      "id": "7e1b166f-5c76-43b0-bd05-5a339bbc6d67",
      "type": "timeseries_datapoint",
      "attributes": {
        "timestamp": "2023-06-21T07:28:35.759+02:00",
        "data": {
          "forks": 5,
          "stars": 86,
          "watches": 3,
          "last_update_at": "2023-06-20T11:17:04Z"
        }
      }
    },
    ...
  ],
  "meta": {
    "count": 21
  }
}
Attribute Description
id uuid
Unique repository identifier (unique across all trigger types).
type string
Type is: “github_repository”.
attributes hash
Additional repository data
relationships string
Links to timeseries datapoints

Attributes data

Attribute Description
url url
URL pointing to the repository on GitHub.
description string
A short description of the repository.
first_seen_at datetime
Time & date (ISO 8601) of when the repository was first seen.

Timeseries datapoint

Attribute Description
id uuid
Unique datapoint identifier (unique across all trigger types).
type string
Type is: “timeseries_datapoint”.
forks integer
Number of times this repository was forked at the creation of this datapoint.
stars integer
Number of times this repository was starred at the creation of this datapoint.
watches integer
Number of GitHub profiles that were watching this repository at the creation of this datapoint.
last_update_at datetime
Time & date (ISO 8601) of the last update to the repository that was detected at the creation of this datapoint.

Product

Examples of Product objects

{
  "data": [{
    "id": "b5b12b0c-40eb-472d-b1cf-21863cc48201",
    "type": "product",
    "attributes": {
      "name": "Supply Chain Data Management",
      "sources": [
        "menu"
      ],
      "url": "https://www.logility.com",
      "first_seen_at": "2022-04-22T06:56:43Z",
      "last_seen_at": "2022-05-13T06:58:59Z"
    },
    "relationships": {}
  }, 
  ...
  ],
  "included": [],
  "meta": {
    "count": 21
  }
}
Attribute Description
id uuid
Unique repository identifier (unique across all trigger types).
type string
Type is: “product”.
attributes hash
Additional repository data
url url
URL where this product was found on
first_seen_at datetime
Time & date (ISO 8601) when this product was first seen
last_seen_at datetime
Time & date (ISO 8601) when this product’s page was last visited

Attributes data

Attribute Description
name string
Product name as found on the website.
sources array
Array of source types this product has been found at.

Source types

Can be one of the following: 'pricing, menu'

Flag

If you come across any signal that seems wrong you can simply call the flag endpoint.

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

Our quality assurance analysts will review the signal and correct it.

curl -X POST “https://predictleads.com/api/v1/events/:id/flag?message=‘Just … plain … wrong!!!’”

{
  "meta": "Event flagged"
}
curl