Using ContactFinder API: A Simple Guide


ContactFinder offers a powerful API that allows you to interact with the service programmatically. This guide will walk you through the basics of using the API, making Python requests, and handling responses.

API Endpoints

1. Retrieving Job List

  • URL:
  • Method: GET
  • Purpose: Fetches a list of your past searches, providing names and IDs.

2. Retrieving Job Content

  • Method: GET
  • Purpose: Retrieves the content of a specific search using the search ID.
  • URL:
  • Method: POST
  • Purpose: Initiates a new search with specified parameters.
  • Request Body:
    • Role (comma-separated list)
    • Company Name (comma-separated list)
    • Country Code (from Country Code API)
    • Filename (optional)
    • Contacts per Role (optional)

Sample Python Code

1. Fetching Job List

2. Retrieving Job Content

Handling Asynchronous Searches

Without Webhooks

If you can’t use webhooks, after initiating a search, wait for 2 minutes, then retrieve the results using the search ID.

With Webhooks

Webhooks provide real-time notifications. Set up your server and provide the webhook URL during the search initiation. When the search finishes, you’ll receive a notification.

Feel free to use the provided Python code snippets as a foundation for integrating ContactFinder API into your website or application. Make sure to replace placeholder values with your actual API key and search IDs.