Overview of SignalHire API

Introduction

The SignalHire API allows developers to integrate the capabilities of SignalHire into their own applications. It provides access to a wealth of contact information, including emails, phone numbers, and social media profiles, from a global database of professionals. The API enables businesses to find and verify contact details, improve customer outreach, and enrich data for CRM systems.

SignalHire API is designed to be simple, scalable, and secure. It offers a variety of endpoints to retrieve detailed information about individuals, companies, and more. The flexibility of the API allows for easy integration into your existing applications and workflows, giving you access to accurate data when you need it.

Available Endpoints

Below are two endpoints available in the SignalHire API:


Person API

The Person API allows you to retrieve full and detailed information about a specific individual, based on unique identifiers. The search parameters are designed to unambiguously identify a person, as they can include LinkedIn profile links, email addresses, phone numbers, or ID. Once a match is found, the API returns the most comprehensive profile, including not only the individual's personal data such as location, work experience, education, skills, but also complete contact details.


Search API

The Search API allows you to search for individuals or companies in the SignalHire database using a wide variety of filters. This API can return multiple results depending on the search criteria provided, such as job title, location, or industry. It is highly useful for lead generation, market research, and talent acquisition.

Unlike the Person API, the Search API returns brief overview of the information about individuals without contact information. The purpose of this API is to enable you to search a large number of potential candidates or prospects and refine your results with filters.

Authentication

To access the SignalHire API, you need to authenticate using an API key. The API key serves as your unique identifier and ensures that only authorized requests are processed.

  • Obtaining an API Key: To get an API key, you must first register for a SignalHire account. Once registered, navigate to the Integrations & API section from the top dropdown menu in your account dashboard. There, you can request access to the API and generate your API key.
  • Storing API Key: Ensure that your API key is stored securely. Do not expose it in public repositories or share it with unauthorized parties. Sharing SignalHire API keys will allow others to make SignalHire API calls using your paid credits.
  • Using API Key: Include your API key in the apikey request header when making API calls to authenticate your requests.

HTTP Response Headers

The HTTP response headers provide important information about the status of your request and remaining credits. You can find the total remaining credits in the X-Credits-Left header. Alternatively, you can use a special API method to check your remaining credits.

HTTP Response Codes

SignalHire API returns various HTTP status codes to indicate the success or failure of your request. Below is a list of the most common response codes:

  • 200 - Request is completed successfully, and the data has been collected.
  • 201 - Request is accepted, and the server has started collecting data.
  • 204 - Request is still in progress, and the server is working on it.
  • 401 - Authentication failed. Please verify that your API key is correct.
  • 402 - You have run out of your credit limit.
  • 403 - Your account has been disabled, or you attempted to query the status of a request that is not yours.
  • 404 - The requested API could not be found on the server, or you provided invalid JSON data, or queried the status of a non-existing request.
  • 406 - You requested more than the allowed maximum number of items in a request (the limit is currently 100).
  • 422 - The server could not understand the request sent to it. This error may occur if the parameters are incorrect or malformed.
  • 429 - The rate limit of 600 items per minute (for Person API) or one concurrent request (for Search API) has been exceeded.
  • 500 - Internal Server Error. This indicates an issue with the server.

Legal Guidelines

By using SignalHire API you agree with our Terms of Use, Privacy Policy, and GDPR Compliance

BACK TO TOP