--- title: "/news/v1/search" method: GET path: "/v1/search" tags: ["News Search"] --- # /news/v1/search `GET /v1/search` Access the only API on the market delivering real-time, actionable news on nonprofits, philanthropy, and the social sector, curated by Candid from over 65,000 sources. ## Query parameters - `search_terms` string - `start_date` string, date - `end_date` string, date - `added_start_date` string, date-time - `added_end_date` string, date-time - `eins` string[] - `organizations` string[] - `locations` integer[] - `subjects` string[] - `populations` string[] - `people` string[] - `sources_include` string[] - `sources_exclude` string[] - `staff_change_mentioned` boolean - `rfp_mentioned` boolean - `grant_mentioned` boolean - `filter_operator` 'AND' | 'OR' - `advisory_content` boolean - `sort_order` 'desc' | 'asc' - `page` integer ## Response `200` OK - object - `meta` object - `code` integer — HTTP response status code. - `status` string — Description of the HTTP response status code. - `elapsed_time` string — Elapsed time of API call in miliseconds. - `time` string — Time of API call. - `article_count` integer — Number of news articles returned by the search. - `page_count` integer — Number of pages returned by the search. - `parameters` object - `search_terms` string — Filter passed through for search_terms parameter - `start_date` string, date — Filter passed through for start_date parameter - `end_date` string, date — Filter passed through for end_date parameter - `added_start_date` string, date — Filter passed through for added_start_date parameter - `added_end_date` string, date — Filter passed through for added_end_date parameter - `eins` string[] — Filter passed through for eins parameter - `organizations` string[] — Filter passed through for organizations parameter - `locations` integer[] — Filter passed through for locations parameter - `subjects` string[] — Filter passed through for subjects parameter - `populations` string[] — Filter passed through for populations parameter - `filter_operator` 'AND' | 'OR' — Filter passed through for filter_operator parameter - `people` string[] — Filter passed through for people parameter - `sources_include` string[] — Filter passed through for sources_include parameter - `sources_exclude` string[] — Filter passed through for sources_exclude parameter - `staff_change_mentioned` boolean — Filter passed through for staff_change_mentioned parameter - `rfp_mentioned` boolean — Filter passed through for rfp_mentioned parameter - `grant_mentioned` boolean — Filter passed through for grant_mentioned parameter - `advisory_content` boolean — Filter passed through for advisory_content parameter - `sort_order` 'desc' | 'asc' — Filter passed through for sort_order parameter - `page` integer — Filter passed through for page parameter - `data` object[] - `data_id` integer — Candid data ID of the news article. - `title` string — Title of the news article. - `content` string — Short preview content of the news article. - `publication_date` string — Date article was published. - `added_date` string — Date article was added to the Candid News database. - `author` string — Author of the news article when available. - `link` string — Link to the news article. - `image` string — Article image. - `sources` string[] - `site_name` string — Site name where the news article published. - `base_url` string — Base URL of the news article source website. - `icon_url` string — URL of the news article source website icon. - `philanthropy_classification_system` object[] - `subjects` object[] - `taxonomy_code` string — Philanthropy Classification Code (PCS) subject facet codes related to the article. - `taxonomy_code_description` string — Philanthropy Classification Code (PCS) subject facet descriptions related to the article. - `populations` object[] - `taxonomy_code` string — Philanthropy Classification Code (PCS) population facet codes related to the article. - `taxonomy_code_description` string — Philanthropy Classification Code (PCS) population facet descriptions related to the article. - `people_mentioned` string[] - `most_relevant_organizations` object[] — The most relevant organizations to the article, sorted by most salient to least salient. - `name` string — Name of the organization. - `org_type` string — Organization type, either recipient or funder. - `profile_link` string — URL of organization's profile on Guidestar.org or Foundationcenter.org - `profile_link_type` 'foundation_directory' | 'guidestar' — The profile type of the profile link. - `ein` string — EIN of the organization. - `org_salience_score` number — The likelihood that the given organization is the most important organization in the context of the article. Values closer to 1 indicate that the organization is very important. - `organizations_mentioned` string[] - `eins` string[] - `locations_mentioned` object[] - `geoid` string — GeoID of a location mentioned in the article. - `location_name` string — Location name mentioned in the article. - `staff_change_mentioned` boolean — True if the article contains a mentions of staff changes. - `rfp_mentioned` boolean — True if the article contains a mentions of RFPs. - `grant_mentioned` boolean — True if the article contains a mentions of grants. - `advisory_content` boolean — True if the article has been flagged for advisory content. - `scores` object - `article_score` number — The total score for the article which drives article ranking. This can be any number greater than or equal to 0. - `grant_mentioned_confidence` number — The likelihood that at least one grant transaction is mentioned in the article. - `rfp_mentioned_confidence` number — The likelihood that at least one RFP announcement is mentioned in the article. - `advisory_content_confidence` number — The likelihood that the article includes advisory content about organizations or people in the social sector that may or may not require due diligence. - `staff_change_mentioned_confidence` number — The likelihood that at least one staff change is mentioned in the article. Staff changes include, but are not limited to, retirements, new hires, promotions, board member appointments, and terminations. ## Other responses - `400` — Bad Request - `401` — Unauthorized - `403` — Forbidden - `404` — No Results Found - `406` — Not Acceptable - `429` — Too Many Requests - `500` — Internal Server Error --- [API](https://skmtc.dev/candid/apis/rfpapi.md) · [All operations](https://skmtc.dev/candid/apis/rfpapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/candid/rfpapi/revisions/bb9133e46de6/schema)