Public
Documentation Settings

Giving Compass Insights API

The Giving Compass Insights API provides various ways to search for nonprofits and content.

For the /chat endpoint, some examples of the q pameter value are:

  • Find articles about clean water

  • Find nonprofits in Chicago with revenue over 100k

  • Show nonprofits in TX that help the blind

  • Nonprofits that are similar to JDRF

  • Nonprofits that focus on SDG 5 with revenue between 1M and 5M

Book a call

Get Trial Key

chat

search

GETChat Search

https://api.givingcompass.org/insights/chat/search?q=<string>&city=<string>&state=<string>&zip=97595&min_total_revenue=<integer>&max_total_revenue=<integer>&gc_vetted=<boolean>&sdg=<integer>
AUTHORIZATIONAPI Key
Key

X-API-Key

Value

{{apiKey}}

HEADERS
x-session-id

<uuid>

A unique UUID value to maintain context

Accept

application/json

PARAMS
q

<string>

(Required) Query string for searching the vector database

city

<string>

City string for filtering search results

state

<string>

State string for filtering the vector database (2 character abbreviation)

zip

97595

5 Zip Code for filtering search results

min_total_revenue

<integer>

Returns nonprofits with total revenue more than min total revenue

max_total_revenue

<integer>

Returns nonprofits with total revenue less than max total revenue

gc_vetted

<boolean>

Query string for selecting vetted Giving Compass nonprofits

sdg

<integer>

List of Sustainable Development Goals (SDGs) to filter search results by

GETProcess User Message

https://api.givingcompass.org/insights/chat?q=<string>&city=<string>&state=<string>&zip=97595&min_total_revenue=<integer>&max_total_revenue=<integer>&gc_vetted=<boolean>&sdg=<integer>
AUTHORIZATIONAPI Key
Key

X-API-Key

Value

{{apiKey}}

HEADERS
x-session-id

<uuid>

A unique UUID value to maintain context

Accept

application/json

PARAMS
q

<string>

(Required) Query string for searching the vector database

city

<string>

City string for filtering search results

state

<string>

State string for filtering the vector database (2 character abbreviation)

zip

97595

5 Zip Code for filtering search results

min_total_revenue

<integer>

Returns nonprofits with total revenue more than min total revenue

max_total_revenue

<integer>

Returns nonprofits with total revenue less than max total revenue

gc_vetted

<boolean>

Query string for selecting vetted Giving Compass nonprofits

sdg

<integer>

List of Sustainable Development Goals (SDGs) to filter search results by

nonprofits

Loading