Quick Start - CUFinder

Before you can make requests to the CUFinder API, you will need to grab your API key from your dashboard. You find it underAccount » API key.

Make your first request

Every CUFinder endpoint is a POST to https://api.cufinder.io/v3/... with a JSON body and your key in the x-api-key header. Try the Company Email Finder:

curl -X POST 'https://api.cufinder.io/v3/companies/email-finder' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{"query": "cufinder.io"}'

Every successful response uses the same envelope: your result in data, and request context in meta:

{
  "success": true,
  "data": {
    "emails": ["info@cufinder.io", "marketing@cufinder.io"]
  },
  "meta": {
    "confidence": 99,
    "query": { "query": "cufinder.io" },
    "credits": { "charged": 1, "remaining": 9896 }
  }
}

data: the endpoint’s result. List endpoints also include meta.pagination with { "page", "has_more" }.
meta.credits: what this call cost (charged) and your balance after it (remaining). Credits are only charged on successful responses.
meta.query: an echo of the inputs the API accepted.

What’s next ?

Great, you’re now access to your API key and can make your first request to the API. Presented here is the exhaustive list of APIs, accompanied by the instructions on how to call them.