API Access

To access any of the LeadsPiper.com APIs you will first need to get an authentication token (OAUTH).

The authentication token is generally valid for 24hours and in most cases you will need to use a client id and client secret to get it.

How to get an access token

Example using curl:

curl --request POST \
  --url https://idp.inspirenet.cloud/connect/token \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data client_id=YourClientId \
  --data 'client_secret=YourClientSecret' \
  --data grant_type=client_credentials

You will get an answer like:

{
    "access_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6ImF0K2p3dCJ9.....",
    "expires_in": 86400,
    "token_type": "Bearer",
    "scope": "partner"
}

Access to custom feeds

Using the access token from previous step, you can for example get the feed:

curl --location --request GET 'https://api.inspirenet.cloud/api/v1/external/FEEDNAME' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer ey...'

Every data feed will have exactly the same behavior. The only difference will be the last part of the path (e.g. “/FEEDNAME”).

The structure should be evident but let me know if you need any details.

Most feeds are also available as csv files by changing the Accept header to text/csv.