> ## Documentation Index
> Fetch the complete documentation index at: https://docs.theswarm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Job changes endpoint

> Example OpenSearch DSL queries for retrieving daily job changes via the Search Profiles endpoint.

These examples target the [Search Profiles](/docs/endpoints/v3/search-profiles) endpoint and rely on the [Daily Job Changes](/docs/signals/daily-job-changes) timestamp fields. The Search endpoint returns IDs only — pass them to [Fetch Profile](/docs/endpoints/v3/fetch-profile) with `fields: ["profile_info"]` for the full job-change context.

## Date-range queries

### Job changes in the last 24 hours

```json theme={null}
{
  "query": {
    "range": {
      "profile_info.current_job_updated_at": {
        "gte": "now-1d/d",
        "lt": "now/d"
      }
    }
  },
  "limit": 1000
}
```

### Job changes in a specific date window

```json theme={null}
{
  "query": {
    "range": {
      "profile_info.current_job_updated_at": {
        "gte": "2026-05-01",
        "lte": "2026-05-31"
      }
    }
  },
  "limit": 1000
}
```

## Filtering by change type

### Only company changes (excluding same-company promotions)

```json theme={null}
{
  "query": {
    "range": {
      "profile_info.latest_company_change_at": {
        "gte": "now-7d/d"
      }
    }
  },
  "limit": 1000
}
```

### Only promotions (role change at the same company)

Profiles whose role changed more recently than their company.

```json theme={null}
{
  "query": {
    "bool": {
      "must": [
        {
          "range": {
            "profile_info.latest_role_change_at": { "gte": "now-30d/d" }
          }
        }
      ],
      "must_not": [
        {
          "range": {
            "profile_info.latest_company_change_at": { "gte": "now-30d/d" }
          }
        }
      ]
    }
  },
  "limit": 1000
}
```

## Filtering by target

### Job changes into a target company

```json theme={null}
{
  "query": {
    "bool": {
      "must": [
        {
          "range": {
            "profile_info.current_job_updated_at": { "gte": "now-7d/d" }
          }
        },
        {
          "term": {
            "profile_info.current_company_name.raw": { "value": "Stripe" }
          }
        }
      ]
    }
  },
  "limit": 1000
}
```

### Job changes into a target title

```json theme={null}
{
  "query": {
    "bool": {
      "must": [
        {
          "range": {
            "profile_info.current_job_updated_at": { "gte": "now-7d/d" }
          }
        },
        {
          "match": {
            "profile_info.current_title": {
              "query": "VP Engineering",
              "operator": "AND"
            }
          }
        }
      ]
    }
  },
  "limit": 1000
}
```

### Job changes within your network only

```json theme={null}
{
  "in_network_only": true,
  "query": {
    "range": {
      "profile_info.current_job_updated_at": { "gte": "now-14d/d" }
    }
  },
  "limit": 1000
}
```