Developpeur / integrateur web (Growth Hacker)

Actualité web, solution Saas, CMS, eCommerce, Framework (VueJS, Symfony, CSS), avec une pointe de SEO.

Un peu de Growth avec Clearbit

par · Publié · Mis à jour

Clearbit vous permet de récupérer des données pour compléter la fiche d’un lead par exemple.
Vous pouvez indiquer par exemple une IP, puis obtenir de la data à partir de là.
Comment cela fonctionne concrètement ?

Nous allons voir cela ci-dessous à travers des exemples concrets.
Tout d’abord vous devez aller sur le site de clearbit.com, puis vous créer un compte pour pouvoir utiliser leur API.
Puis en gros vous allez faire des appels à l’API de Clearbit avec certaines informations de base, pour obtenir un grand nombre de donnée supplémentaire. La doc API (doc) vous apportera toutes les données nécessaires pour avancer.

Doc API :
Vous pourrez y trouver des exemples en Shell, Ruby, Node et Python.
Ces exemples pourront êtres lancés directement sur Postman pour tester vos requêtes API rapidement.
Lorsque vous serez sur la documentation de Clearbit, un bouton vous permettra, depuis la section nommée « API Reference », d’ajouter 9 exemples sur Postman.

  • Discovery
  • Enrichment
  • Logo
  • Name to Domain
  • Prospector
  • Reveal
  • Watchlist

Configuration Postman :
Clearbit > Vous devez récupérer la « secret key » sur le dashboard de Clearbit.
Postman > Puis aller sur l’onglet nommé « Headers » de Postman, et coller la « secret key » de votre compte Clearbit.

{key} :
A remplacer par votre « key API », à récupérer sur le dashboard de votre compte clearbit.
Il s’agit d’une chaîne alphanumérique (sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx).

Enrichment :

Source : https://clearbit.com/docs#enrichment-api
But : renvoyer les données d’une personne ET une société, à partir de son email.

curl 'https://person.clearbit.com/v2/combined/find?email=alex@clearbit.com' \
        -u {key}:

Résultat :

{
  "person": {
    "id": "d54c54ad-40be-4305-8a34-0ab44710b90d",
    "name": {
      "fullName": "Alex MacCaw",
      "givenName": "Alex",
      "familyName": "MacCaw"
    },
    "email": "alex@clearbit.com",
    "//": "..."
  },
  "company": {
    "id": "c5a6a9c5-303a-455a-935c-9dffcd2ed756",
    "name": "Clearbit",
    "legalName": "APIHub, Inc",
    "domain": "clearbit.com",
    "//": "..."
  }
}

Discovery :

Source : https://dashboard.clearbit.com/docs#discovery-api
But : rechercher des sociétés en fonction de critères spécifiques (ex : technologie, entre 100 et 500 employés, localisé sur San Francisco, …).
NB : uniquement disponible sur souscription d’une offre « entreprise » depuis Clearbit.

curl 'https://discovery.clearbit.com/v1/companies/search' \
  -G --data-urlencode 'query=and:(tech:marketo raised:100000~)' \
  --data-urlencode 'sort=alexa_asc' \
  -u {key}:

Résultat :

{
    "total": 894,
    "page": 1,
    "results": [
        {
            "id": "db6ffb23-a89a-4a94-a3b8-59fbc17d8ae1",
            "name": "GitHub",
            "legalName": "GitHub, Inc.",
            "domain": "github.com",
            "domainAliases": [
                "github.io",
                "aungmyokyaw.com",
                "guthub.com",
                "church.io",
                "github.us",
                "github.it",
                "github.de",
                "githubcloud.es",
                "github.ru",
                "github.com.tw",
                "github.co.uk",
                "github.com.my"
            ],
            "site": {
                "phoneNumbers": [],
                "emailAddresses": []
            },
            "category": {
                "sector": "Information Technology",
                "industryGroup": "Software & Services",
                "industry": "Internet Software & Services",
                "subIndustry": "Internet Software & Services",
                "sicCode": "48",
                "naicsCode": "54"
            },
            "tags": [
                "Information Technology & Services",
                "SAAS",
                "Technology",
                "B2B",
                "B2C"
            ],
            "description": "GitHub Inc. is a web-based hosting service for version control using Git.",
            "foundedYear": 2008,
            "location": "San Francisco, CA 94107, USA",
            "timeZone": "America/Los_Angeles",
            "utcOffset": -8,
            "geo": {
                "streetNumber": null,
                "streetName": null,
                "subPremise": null,
                "city": "San Francisco",
                "postalCode": "94107",
                "state": "California",
                "stateCode": "CA",
                "country": "United States",
                "countryCode": "US",
                "lat": 37.7618242,
                "lng": -122.3985871
            },
            "logo": "https://logo.clearbit.com/github.com",
            "facebook": {
                "handle": "github",
                "likes": 117577
            },
            "linkedin": {
                "handle": "company/github"
            },
            "twitter": {
                "handle": "github",
                "id": "13334762",
                "bio": "How people build software. \n\nNeed help? Send us a message at https://t.co/YU5nzbpDIg for support.",
                "followers": 1782545,
                "following": 294,
                "location": "San Francisco, CA",
                "site": "https://t.co/FoKGHcCyJJ",
                "avatar": "https://pbs.twimg.com/profile_images/1017516299143041024/fLFdcGsl_normal.jpg"
            },
            "crunchbase": {
                "handle": "organization/github"
            },
            "emailProvider": false,
            "type": "private",
            "ticker": null,
            "identifiers": {
                "usEIN": "271519660"
            },
            "phone": "+1 415-448-6673",
            "metrics": {
                "alexaUsRank": 36,
                "alexaGlobalRank": 58,
                "employees": 800,
                "employeesRange": "251-1K",
                "marketCap": null,
                "raised": 350000000,
                "annualRevenue": null,
                "estimatedAnnualRevenue": null,
                "fiscalYearEnd": 12
            },
            "indexedAt": "2019-01-10T01:33:41.713Z",
            "tech": [
                "zendesk",
                "mailchimp",
                "dyn_dns",
                "google_apps",
                "aws_route_53",
                "campaignmonitor",
                "google_analytics"
            ],
            "parent": {
                "domain": "microsoft.com"
            }
        },
        ...
    ]
}

Prospector :

Source : https://clearbit.com/docs?shell#prospector-api
But : récupérer un groupe de personnes travaillant dans une société spécifique.

curl 'https://prospector.clearbit.com/v1/people/search' \
        -G --data-urlencode 'domain=twitter.com' \
        --data-urlencode 'role=marketing' \
        -u {key}:

Résultat :

[
  {
    "id": "e_491afe3b-2e7a-4952-9d56-8c67cda5c8b8",
    "name": {
      "fullName": "Jeff Lesser",
      "givenName": "Jeff",
      "familyName": "Lesser"
    },
    "title": "Senior Product Marketing Manager",
    "role": "marketing",
    "seniority": "manager",
    "company": {
      "name": "Twitter"
    },
    "email": "jlesser@twitter.com",
    "verified": true
  },
  {
    "id": "e_b8c06c1d-cda2-422c-a08f-117eaa9f0188",
    "name": {
      "fullName": "Jonathan Wegman",
      "givenName": "Jonathan",
      "familyName": "Wegman"
    },
    "title": "Chief of Staff, CMO, CCO, Chro",
    "role": "marketing",
    "seniority": "manager",
    "company": {
      "name": "Twitter"
    },
    "email": "jwegman@twitter.com",
    "verified": true
  },
  {
    "id": "e_d6632f7e-93ba-40c3-9530-5bf08098a3fb",
    "name": {
      "fullName": "Nick Quan",
      "givenName": "Nick",
      "familyName": "Quan"
    },
    "title": "Performance Marketing Manager",
    "role": "marketing",
    "seniority": "manager",
    "company": {
      "name": "Twitter"
    },
    "email": "nquan@twitter.com",
    "verified": true
  },
  {
    "id": "e_07d5857c-8a19-4871-9582-963a626084d9",
    "name": {
      "fullName": "Marissa Window",
      "givenName": "Marissa",
      "familyName": "Window"
    },
    "title": "Demand Generation Content Strategist, Self-serve Ads",
    "role": "marketing",
    "seniority": null,
    "company": {
      "name": "Twitter"
    },
    "email": "mwindow@twitter.com",
    "verified": true
  },
  {
    "id": "e_361baf6e-126a-43b9-b0eb-a19095beb3be",
    "name": {
      "fullName": "Kristine Yapp",
      "givenName": "Kristine",
      "familyName": "Yapp"
    },
    "title": "Senior Global Event Marketing Manager",
    "role": "marketing",
    "seniority": "manager",
    "company": {
      "name": "Twitter"
    },
    "email": "kyapp@twitter.com",
    "verified": true
  }
]

Risk :

Source : https://clearbit.com/docs#risk-api
But : Prend 1 email + 1 IP et calcule le score de risque associé. Cela vous permet de déterminer si une inscription sur votre service est de type « spam » ou « légitime », ou encore, si un paiement présente un risque élevé.

curl https://risk.clearbit.com/v1/calculate \
        -d 'email=alex@clearbit.com' \
        -d 'name=Alex MacCaw' \
        -d 'ip=127.0.0.1' \
        -u {key}:

Résultat :

{
  "id": "8ea0c9e6-ff59-4506-9c3c-a79ead14ba1f",
  "live": true,
  "fingerprint": false,
  "email": {
    "valid": true,
    "socialMatch": true,
    "companyMatch": true,
    "nameMatch": true,
    "disposable": false,
    "freeProvider": false,
    "blacklisted": false
  },
  "address": {
    "geoMatch": null
  },
  "ip": {
    "proxy": false,
    "geoMatch": false,
    "blacklisted": false,
    "rateLimited": false
  },
  "risk": {
    "level": "high",
    "score": 100,
    "reasons": [
      "email_ip_geo_mismatch",
      "ip_country_greylisted",
      "no_fingerprint_match"
    ]
  }
}

Reveal :

Source : https://clearbit.com/docs#reveal-api
But : A partir d’une adresse IP (v4 uniquement pour le moment, pas d’IPv6), vous renvoyer l’entreprise associée à cette IP. Ceci vous permettra d’obtenir la data concernant la personne qui vous rend visite (ex : sur votre site), pour analyser et personnaliser les pages de destination pour un secteur d’activité spécifique, par exemple. Ou pour optimiser / compléter les données d’un lead / prospect, et ainsi affiner le pipeline de vos commerciaux, pour améliorer votre taux de conversion.

curl 'https://reveal.clearbit.com/v1/companies/find?ip=88.184.57.55' \
        -u {key}:

Résultat :

{
  "ip": "88.184.57.55",
  "fuzzy": true,
  "domain": "segment.com",
  "type": "company",
  "company": {
    "name": "Segment",
    "tags": [
      "Software",
      "SAAS",
      "B2B",
      "Information Technology & Services",
      "Technology",
      "Internet"
    ],
    "metrics": {
      "alexaUsRank": 14014,
      "alexaGlobalRank": 34096,
      "employees": 180,
      "employeesRange": "51-250",
      "raised": 108720000
    },
    "...":  "..."
  },
  "geoIP": {
    "city": "San Francisco",
    "state": "California",
    "stateCode": "CA",
    "country": "United States",
    "countryCode": "US"
  }
}

Name To Domain :

Source : https://clearbit.com/docs#name-to-domain-api
But : vous permet d’obtenir l’url du site + son logo, à partir du nom de la société.

curl 'https://company.clearbit.com/v1/domains/find?name=Segment' \
  -u {key}:

Résultat :

{
  "domain": "segment.com",
  "logo": "https://logo.clearbit.com/segment.com",
  "name": "Segment"
}

Autocomplete :

Source : https://clearbit.com/docs#autocomplete-api
But : vous permet d’obtenir des informations sur le nom de domaine et le logo d’une société, à partir de son nom de société.

curl 'https://autocomplete.clearbit.com/v1/companies/suggest?query=segment'

Résultat :

[
  {
    "name": "Segment",
    "domain": "segment.com",
    "logo": "https://logo.clearbit.com/segment.com"
  },
  {
    "name": "Segmentify",
    "domain": "segmentify.com",
    "logo": "https://logo.clearbit.com/segmentify.com"
  }
]

Clearbit, mais encore :

Il dispose aussi de :

  • webhook
  • d’une connexion possible via OAuth
  • d’une extension pour « google chrome »
  • d’une intégration clearbit sur Zapier et d’autres solutions si besoin.
  • Test A/B avec l’excellent Google Optimize et Optimizely.

Ex : lors de la mise à jour d’un contact sur votre solution CRM (ex : Sellsy.fr), compléter certaines données avec celles présentes sur clearbit.

NB : il vous faudra bien segmenter les données provenant de Clearbit, et les prendre avec des « pincettes », car elles sont parfois obsolètes, ou erronées, mais pourront vous apporter de la data intéressante à exploiter pour votre équipes commerciales.

Intégrer des formulaires Clearbit (sans coder) :

Une fois connecté sur Clearbit.com, vous pourrez réaliser des formulaires rapidement, puis recevoir les data sur un :

  • webhook
  • email
  • crm

Ex (sans coder) :

  • Créer le formulaire sur le dashboard Clearbit.
  • Coller le code / script JS dans le footer de votre site.
  • Indiquer que vous souhaitez envoyer les données sur l’email contact@tld.com
  • Configurer un parser d’email sur Zapier pour récupérer les données.
  • Sauvegarder les données sur votre solution CRM.

Ex (en codant) :

  • Créer le formulaire sur le dashboard Clearbit.
  • Coller le code / script JS dans le footer de votre site.
  • Indiquer que vous souhaitez envoyer un webhook.
  • Coder un script PHP pour traiter les données reçues et alimenter votre CRM (ex : dans une opportunité).
  • Mettre en avant sur votre solution CRM les technologies que le lead utilise, pour que vos commerciaux puis démarcher en tenant compte des produits concurrents qui sont déjà utilisé.
  • Puis envoyer un 1er email d’accroche à votre lead (envoyer un tableau comparatif de la technologie du concurrent trouvé et de votre solution SAAS, et ainsi lui montrer par A+B que votre solution est plus efficace que celle qu’il utilise actuellement).
  • Et votre CRM doit pouvoir faire la suite des relances en automation.

Étiquettes :

Michael

Développeur / intégrateur, travaillant en agence web depuis 2005, je viens à présent vous proposer de venir découvrir mes créations personnelles de plugins / themes pour le CMS Wordpress & Prestashop, quelques solutions en mode SAAS & un peu d'actualité web ( / Twitter).

Vous aimerez aussi...