Skip to main content

SocieteInfo

SocieteInfo specializes in gathering information about businesses with the intention of furthering Business-To-Business relations. This includes finding contact information about people relevant to the company, investigating their internet presence on social networks and their own websites.

To use this provider, you need a SocieteInfo api key. You can request that Qard set one up for your use in the provider, or supply your own. SocieteInfo offers time-limited free trial keys. The provider needs to be able to use the SocieteInfo api with the api key it holds in its credentials.

This provider supports these data types:

  • Contact: to retrieve a list of company contacts.
  • Web Info: to retrieve a company web/social information (domains, facebook, wikipedia ...).

Test SocieteInfo integration:

1. Update SocieteInfo provider credentials:

  • api_key : SocieteInfo api key
(PUT) /api/v6/providers/societe_info/credentials
{
"credentials": {
"api_key": "SOCIETEINFO_API_KEY"
}
}

2. Enable SocieteInfo provider:

(PUT) /api/v6/providers/societe_info
{
"enable": true
}

3. Create SocieteInfo data connection:

(POST) /api/v6/users/{userId}/data-connections
{
"requested_data_types": ["WEB_INFO", "CONTACT"],
"provider_name": "societe_info"
}

4. Create a synchronization:

After validating that the data connection status is CONNECTED, you can run a new synchronization.

(POST) /api/v6/users/{userId}/sync
{
"data_types": ["WEB_INFO", "CONTACT"]
}

To verify that you are receiving the right data, check out these endpoints:

  • GET /api/v6/users/{userId}/web-infos