The SalesSift API

There are two API endpoints, and all requests should be sent over POST with your api_key. If you would like access to the API, please email us at info@salessift.com for an API key.

All API endpoints return a JSON response, and either a 200 (success), 500 (failure - with error message) or 403 (forbidden).

Please respect the rate limits. Do not go over the below limits or your API access may be blocked. If you require higher limits, please do get in touch.


Submit Company Search (https://salessift.com/api/submit_company_search/)

Rate Limit: 1 call every 180 seconds

Submit a new search for similar companies. Submit a URL or domain of the company you would like to search for. A task_id will be returned.

Required Parameters:

  • api_key
  • url

Optional Parameters:

  • number_of_results (number of companies to return, up to 100)
  • include_extra_info (True/False, whether to run a deep search to determine extra and more accurate information about each company. Considerably slower)

Sample Request (cURL):

$ curl https://salessift.com/api/submit_company_search/ \
    -d api_key="abcdefghijklmnopqrstuvwxyz" \
    -d url="kpmg.co.uk"

Sample Response:

{
    "task_id": "163dbb30-7482-4051-b053-88b508ed4521"
}

Get Company Search Results (https://salessift.com/api/get_company_search_results/)

Rate Limit: 1 call every 15 seconds

Once a company has been submitted, this endpoint should be polled to check if the results have been generated.

Do not poll more frequently than the API rate limit or your API access may be blocked.

In the JSON response, the key 'is_complete' will have value true on completion, upon which 'suggested_companies' will be populated.

Required Parameters:

  • api_key
  • task_id

Sample Request (cURL):

$ curl https://salessift.com/api/get_company_search_results/ \
    -d api_key="abcdefghijklmnopqrstuvwxyz" \
    -d task_id="163dbb30-7482-4051-b053-88b508ed4521"

Sample Response:

{
    "suggested_companies": [...]
    "is_complete": true
}