Enrichment

The Enrichment API allows you to retrieve valuable company insights based on a domain name. It provides structured data such as hiring activity, technologies usage and more.

Search for job postings by domain

post

Get job postings for a given domain with filtering, sorting, and pagination capabilities.

Authorizations

Body

domainstringRequired

Domain to search for job postings

limitinteger · int32Optional

Maximum number of results to return

Default: 20

cursorinteger · int32Optional

Cursor for pagination

Default: 0

searchstringOptional

Free text search query

filter_logicall ofOptional

Logic to apply between filters (AND or OR)

Default: AND

string · enumOptionalPossible values:

Responses

200

The request has succeeded.

application/json

422

Client error

application/json

post

HTTPcURLJavaScriptPython

POST /enrichment/job-postings HTTP/1.1
Host: madapi.madkudu.com
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 263

{
  "domain": "madkudu.com",
  "limit": 20,
  "cursor": 0,
  "filters": [
    {
      "property": "location",
      "operator": "CONTAINS",
      "value": "Paris"
    },
    {
      "property": "categories",
      "operator": "CONTAINS",
      "value": "engineering"
    }
  ],
  "filter_logic": "AND",
  "sort": [
    {
      "sort_by": "event_on",
      "sort_order": "desc"
    }
  ]
}

Search job postings with filters and sortingSearch job postings with text querySimple search with domain and limit

{
  "data": [
    {
      "company_domain": "madkudu.com",
      "job_opening_title": "Senior Software Engineer",
      "job_opening_url": "https://madkudu.com/careers/senior-software-engineer",
      "keywords": "python, typescript, react",
      "categories": "engineering, backend",
      "location": "San Francisco, CA",
      "event": "first_seen",
      "event_on": "2024-01-15",
      "first_event_on": "2024-01-15"
    },
    {
      "company_domain": "madkudu.com",
      "job_opening_title": "Frontend Developer",
      "job_opening_url": "https://madkudu.com/careers/frontend-developer",
      "keywords": "react, typescript, css",
      "categories": "engineering, frontend",
      "location": "Remote",
      "event": "closed",
      "event_on": "2024-01-10",
      "first_event_on": "2024-01-05"
    }
  ],
  "meta": {
    "limit": 20,
    "total": 45,
    "has_next_page": true,
    "next_cursor": 20
  }
}