Searching API : Introduction of raw_filter Parameter

We’ve upgraded both the Job and Profile Searching APIs by introducing a new raw_filter parameter that lets users write advanced, expressive queries using the Elasticsearch Query DSL.

😍 Why it’s a big deal for HrFlow.ai users?

Previously, search filters were limited to a fixed set of query parameters. With raw_filter, you now gain full control over how results are filtered—unlocking a range of new capabilities like:

• Writing multi-condition queries (must, should, must_not)
• Using full-text search with match, match_phrase, or wildcard
• Targeting nested fields and combining filters across attributes

This update brings powerful Elasticsearch-native filtering directly into the HrFlow.ai API.

👍

Example Queries

// Job search\

JSON

{
  "query": {
    "bool": {
      "should": [
        { "match_phrase": { "name": "AI" } },
        { "match_phrase": { "name": "Researcher" } }
      ]
    }
  }
}

// Profile search\

JSON

{
  "query": {
    "bool": {
      "should": [
        { "match_phrase": { "text": "Python" } },
        { "match_phrase": { "text": "Java" } }
      ]
    }
  }
}

💡 Useful Resources

• HrFlow.ai API Documentation
• Job Searching API Endpoint
• Profile Searching API Endpoint
• Jobs Asking Guide
• HrFlow.ai Postman Collection