> ## Documentation Index > Fetch the complete documentation index at: https://docs.givingcompass.org/llms.txt > Use this file to discover all available pages before exploring further. # Browse Metrics > Browse impact metrics across multiple nonprofits. Filter by EINs to retrieve metrics from specific organizations. ## OpenAPI ````yaml GET /impact/metrics openapi: 3.1.0 info: title: Giving Compass Insights description: >+ ## Overview The Giving Compass Insights API provides access to nonprofit data, impact stories, financial information, and AI-powered search capabilities. ## Authentication All endpoints require an API key passed via the `X-API-Key` header. ``` X-API-Key: your_api_key_here ``` ## Core Capabilities ### Nonprofit Search Search and filter nonprofits by location, revenue, expenses, cause areas, and Charity Navigator ratings. ### Impact Data Access AI-extracted impact stories and metrics from nonprofit annual reports: - **Stories**: Human transformation narratives with emotional hooks, quotes, and before/after states - **Metrics**: Quantitative measures (people served, meals distributed, volunteers, etc.) ### Feed Data Access and filter nonprofit posts (articles, events, videos, job postings) from organizations: - **Content Types**: Filter by classification (articles, videos, events, podcasts, job postings, volunteer opportunities) - **Location Filtering**: Filter posts by nonprofit's city, county, state, ZIP code, or geographic radius (lat/lng) - **Cause Area Filtering**: Filter by NTEE codes to find posts from organizations working in specific cause areas ### AI Chat Natural language search for nonprofits and content. Example queries: - `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` version: 1.0.0 servers: - url: https://api.givingcompass.org/insights security: [] tags: - name: Insights description: >- Search nonprofits, retrieve financial data, and access AI-powered chat for nonprofit discovery. - name: Impact description: >- Access impact stories and metrics extracted from nonprofit annual reports. Stories are human transformation narratives with emotional hooks and quotes. Metrics are quantitative measures reported by nonprofits. - name: Feed description: >- Access nonprofit posts and content feeds with advanced filtering by location, cause area, and content type. Filter posts by organization location (city, county, state, ZIP, lat/lng radius) and NTEE codes - name: Beta description: Beta endpoints - may change without notice. paths: /impact/metrics: get: tags: - Impact summary: Browse Metrics description: |- Browse impact metrics across multiple nonprofits. Filter by EINs to retrieve metrics from specific organizations. operationId: get_all_impact_metrics_impact_metrics_get parameters: - name: eins in: query required: false schema: anyOf: - items: type: string type: array - type: 'null' title: EINs description: Filter by one or more nonprofit EINs description: Filter by one or more nonprofit EINs - name: metric_ids in: query required: false schema: anyOf: - items: type: string type: array - type: 'null' title: Metric IDs description: Filter by one or more metric IDs description: Filter by one or more metric IDs - name: metric_type in: query required: false schema: anyOf: - type: string - type: 'null' title: Metric Type description: Filter by metric type (e.g., 'meals served', 'children helped') description: Filter by metric type (e.g., 'meals served', 'children helped') - name: page in: query required: false schema: type: integer minimum: 1 description: Page number default: 1 title: Page description: Page number - name: size in: query required: false schema: type: integer maximum: 100 minimum: 1 description: Page size default: 20 title: Size description: Page size responses: '200': description: Successful Response content: application/json: schema: $ref: >- #/components/schemas/PaginatedResponse_InsightsImpactMetricResponse_ '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - APIKeyHeader: [] components: schemas: PaginatedResponse_InsightsImpactMetricResponse_: properties: items: items: $ref: '#/components/schemas/InsightsImpactMetricResponse' type: array title: Items total: type: integer title: Total page: type: integer title: Page size: type: integer title: Size type: object required: - items - total - page - size title: PaginatedResponse[InsightsImpactMetricResponse] HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError InsightsImpactMetricResponse: properties: metric_id: type: string title: Metric Id ein: type: string title: Ein metric_text: type: string title: Metric Text metric_type: type: string title: Metric Type metric_value: type: number title: Metric Value unit: anyOf: - type: string - type: 'null' title: Unit geo_impact: anyOf: - type: string - type: 'null' title: Geo Impact time_aggregation: anyOf: - type: string - type: 'null' title: Time Aggregation time_aggregation_text: anyOf: - type: string - type: 'null' title: Time Aggregation Text source_snippet: anyOf: - type: string - type: 'null' title: Source Snippet url: anyOf: - type: string - type: 'null' title: Url report_year: anyOf: - type: integer - type: 'null' title: Report Year date_added: anyOf: - type: string - type: 'null' title: Date Added type: object required: - metric_id - ein - metric_text - metric_type - metric_value title: InsightsImpactMetricResponse description: Public API response for impact metrics ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError securitySchemes: APIKeyHeader: type: apiKey description: Add a header [X-API-Key] with the token in: header name: X-API-Key ````