Essentials Search includes fields like “organization_name”, “ein”, etc. The fields you would expect. The search will match the entered search term to both organization name and all “narrative content”. “Narrative content” includes fields such as “mission (statement)”, “programs”, and other text fields.

As an example, assume we are searching for “Comfort Zone Camp”.

Each part of the search term will be used in the search. So, we may get results having “Comfort”, “Zone”, and “Camp” in the results, with “hits” containing two of the three words being ranked higher than a hit that only contains the word “Camp”.

So, If our Essentials JSON search payload is:

{
   search_terms: "Comfort Zone Camp"
}

We get 125 hits, with the first being:

"total_hits": 125,
 "hits":  [
{
      "organization_id":  "7810133",
      "bridge id":  "0718346475",
      "ein":  "54-1916517",
      "organization_name":  "Comfort Zone Camp",
      "also_known_as":  "",
      "mission":  "Comfort Zone Camp's mission is \"to provide grieving children with a
       voice, a place and a community in which to heal, grow and lead more fulfilling
       lives.\"",

The second hit is:

      "organization_id":  "7001553",
      "bridge_id":  "7857469497",
      "ein":  "20-1933021",
      "organization_name":  "The Mark Wandall Foundation Inc",
      "also_known_as":  "",
      "mission":  "The Mark Wandall Foundation facilitates support for children, teens
       and young adults in grief due to the loss of a parent, guardian or sibling. Through
       our partnership with Comfort Zone Cam and the Sarasota Manatee Association  
       for Riding Therapy (SMART), as well as, The Mark Wandall Foundation College S
       scholarship Program, we trust that we can transform a child's broken spirit into a
       beautiful spark that will light the way to a happy, healthy and optimistic future.",

Note that this organization has the search term in the text of their mission statement. So they are a “close” match. After those two, the rest mostly have the term “Camp” in their organization Name.

Essentials Search allows users to focus a full-text search from the default, to match on either the organization name or the narratives, exclusively. Using the “!” operator, as in the example following, search will only match on the organization name, while the “!!” operator will limit matching to the narratives. Examples of each operator appear below

If we change the JSON search string to this one, by adding an exclamation point (a “bang”) in front of the search term, the search will only match the exact term and only in the “organization_name” field:

{
   search_terms:  "! Comfort Zone Camp"
}
"total_hits":  1,
"hits":  [
      {
       "organization_id":  "7810133",
       "bridge_id":  "0718346475",
       "ein":  "54-1916517",
       "organization_name":  "Comfort Zone Camp",

So we get 1 return and it's a match to the search terms.

If we use a JSON like this, with two "bangs", searching only the narrative fields, we get:

{
   search_terms:  "!! Comfort Zone Camp"
}
"total_hits": 125,
  "hits":  [
{
      "organization_id":  "7001553",
      "bridge_id":  "7857469497",
      "ein":  "20-1933021",
      "organization_name":  "The Mark Wandall Foundation Inc",
      "also_known as":  "",
      "mission":  "The Mark Wandall Foundation facilitates support for children, teens and young adults in grief due to the loss of a parent, guardian or sibling.Through our partnership with Comfort Zone Camp and the Sarasota Manatee Association for Riding Therapy (SMART), as well as, The Mark Wandall Foundation College Scholarship Program, we trust that we can transform a child's broken spirit into a beautiful spark that will light the way to a happy, healthy and optimistic future.",

We get the 125 hits with the one that has “Comfort Zone Camp” in it’s mission text as the first result.

I hope this helps you to tailor your searches to get the data you want. Please send any further questions to apisupport@candid.com and we will answer as quickly as we can.


Did this answer your question?