Business and contact intelligence, built into your product
Access KnowFirst programmatically through a straightforward REST API. Search Australian and New Zealand businesses and people, retrieve structured data, unlock contact information and build exports from your own applications.
Your first request should be the easy part
Authenticate with your KnowFirst API key, send a standard HTTP request and receive JSON. There is no SDK requirement and no separate API subscription to manage.
- REST endpoints with JSON responses
- API key authentication using
x-api-key - Business and people search
- Filter discovery for building valid queries
- Exports and export status
- Same account and credit balance as the platform
curl -X GET "https://api.knowfirst.ai/v1/business/list?state=NSW" \
-H "x-api-key: $KF_API_KEY"
const res = await fetch("https://api.knowfirst.ai/v1/business/list?state=NSW", {
headers: { "x-api-key": process.env.KF_API_KEY },
});
const data = await res.json();
import os, requests
res = requests.get(
"https://api.knowfirst.ai/v1/business/list?state=NSW",
headers={"x-api-key": os.environ["KF_API_KEY"]},
)
data = res.json()
{
"total_results": 412098,
"results": [
{ "name": "Acme Pty Ltd",
"abn": "12 345 678 901",
"state": "NSW",
"anzsic": "E",
"employees": "20-50" }
],
"next_token": "..."
}
Use the same data behind the KnowFirst app
The API is not a separate data product. It exposes the same underlying business and people intelligence used by the KnowFirst platform, so you can prototype a workflow in the app and then automate it in code.
Build precise business searches
Search businesses using criteria such as name, industry, location, size and registration attributes. Filter endpoints help your application discover valid values rather than hard-coding assumptions.
Search people by the attributes that matter
Find people using role, seniority, employer, location and other available criteria, then use the resulting profiles in enrichment, prospecting or research workflows.
Export without rebuilding the workflow
Create exports programmatically, choose the fields you need and track the export until it is ready. The same export workflow used in the dashboard can be incorporated into your own systems.
No SDK required
One key, one account
Manage your API key from KnowFirst. If you regenerate it, the previous key stops working, giving you a simple way to rotate credentials when needed. Treat the key like a password and keep it server-side.
One credit balance
API usage draws from the same KnowFirst credit balance as the dashboard. This keeps billing and usage in one place rather than creating a separate API contract for the same data.
No SDK required
If your stack can make an HTTP request and send a header, it can use KnowFirst. Start with cURL, Python, JavaScript or the HTTP client already used by your application.
The core surface
All endpoints are relative to https://api.knowfirst.ai/v1 and speak JSON.
| Endpoint | What it does |
|---|---|
GET/business/list | Search businesses across AU and NZ. Filter by name, industry (ANZSIC), location, size, registration details and more; paginate through results. |
GET/person/list | Search people - by name, role, seniority, employer or location - with the same filter style as business search. |
GET/business/list/fields/{field} | Discover the values a filter accepts (industries, states, size bands and friends), so queries are built from real options, not guesses. |
GET/person/list/estimate | Price an export before committing: how many records match and what the export would cost in credits. |
GET/person/list/export | Request a CSV export of a person search with your chosen fields. Poll its status, then download - charged once on first download. |
GET/user/exports/person | List the person exports you have requested, with status and download links - the same list the Exports view shows. |
Build on the whole database
Generate an API key and start testing against Australian and New Zealand business and people data.