FindNeo Developers

Getting started

1. Get a key

Ask an admin of the company's FindNeo account to create one: Settings → Security & Access → API keys → Create key. They choose:

  • Name: what the key is for, such as "Company website".
  • Access: List jobs, or List jobs and accept applications.
  • Websites (optional): the addresses allowed to use it from a browser, such as https://www.example.com.

The key starts with fnjobs_. FindNeo shows it in full only once, so it has to be copied and sent to you then. If it's lost, create a new one and revoke the old one.

2. Pick the server

Environment Base URL
Production https://api.gofindneo.com
QA https://api-qa.gofindneo.com

QA is a separate copy of FindNeo with test companies and test data. A QA key works only on QA, and a production key only on production. Build against QA if the company has a QA account; switch the base URL and key when you go live.

3. List the jobs

curl https://api.gofindneo.com/v1/website/jobs \
  -H "X-Api-Key: fnjobs_your_key"

The answer:

{
  "companyName": "Example Corp",
  "companySlug": "example-corp",
  "data": [
    {
      "id": "6f1c2a9e-3b4d-4c55-9a1e-2f0b7d8e9c10",
      "title": "Senior Backend Engineer",
      "employmentType": "full_time",
      "workMode": "hybrid",
      "countryCode": "IN",
      "locationText": "Bengaluru",
      "publishedAt": "2026-11-01T09:30:00.000Z",
      "applyUrl": "https://app.gofindneo.com/careers/example-corp/6f1c2a9e-3b4d-4c55-9a1e-2f0b7d8e9c10"
    }
  ],
  "pagination": { "nextCursor": null, "hasMore": false, "limit": 20 }
}

4. From a web page

The same call from your website's JavaScript:

const API = 'https://api.gofindneo.com/v1/website';
const KEY = 'fnjobs_your_key';

const response = await fetch(`${API}/jobs`, { headers: { 'X-Api-Key': KEY } });
if (!response.ok) throw new Error(`FindNeo answered ${response.status}`);
const { data: jobs } = await response.json();

The API answers any website (CORS is open, without cookies), so this works from the browser. Limiting the key to your websites stops other websites from using it.

Next