Skip to main content

Quick Start

This page will help you get started with Discover API.

Authentication​

Using Discover API you can fetch data from SMARTe database and add into your existing technology stack and workflows. The input and response are in JSON format which are commonly used.

URL​

POST https://api.smarte.pro/v1/discover

Headers​

Below are the mandatory input parameter to call Discover API.

API Key​

All API calls must include a valid API key. Authentication is based on the key which is a mandatory parameter in every API request you receive.

We'll return an error if the key is missing or invalid.

"content-type": "application/json"
"API_KEY": "<api_Key>"

The application/json is required to submit your data in JSON format.

Input Modes​

This parameter lets you access the features of Enrich API

  • Discover
  • Stats

Discover Detailed Contact Data is sent in the response. This is also the default search criteria.

Stats Total count of the data is sent in the response.

Rate Limiter​

This feature controls the number of requests per minute sent to the API.

A failure response will be sent in case of exceeded request limit.

Input Field Requirement​

When you send a request to Discover API you need to specify the GUID of the company of which you want the data along with some other parameters.

Below is the sample input request. Here's how you would do that using a simple HTTP POST request using curl command.

curl --request POST \
--url https://api.smarte.pro/v1/discover \
--header 'API_KEY: 3f5b4b24-16ac-4136-9f74-xxxxxxxxxxxx' \
--header 'Content-Type: application/json' \
--data '{
    "company_guid": "E8932F31620C0D5D",
    "jobTitle": [
        "VP",
        "sales"
    ],
    "location": ["San Francisco"],
    "within_miles": 50,
    "accuracy": "A+",
    "max_contacts": 100,
    "pagination_required": true,
    "page_size": 10,
    "page_number": 1
}'