> ## 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. # Get Feed Posts > Get posts from all nonprofits for the global feed, sorted by newest first. Organization names are guaranteed to be populated via SQL lookup. Supports optional filtering by classification and search. ## OpenAPI ````yaml GET /feed/posts 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: /feed/posts: get: tags: - Feed summary: Get Feed Posts description: >- Get posts from all nonprofits for the global feed, sorted by newest first. Organization names are guaranteed to be populated via SQL lookup. Supports optional filtering by classification and search. operationId: get_feed_posts_feed_posts_get parameters: - name: classification in: query required: false schema: anyOf: - type: string - type: 'null' title: Post Classification description: >- Filter by post classification/content type (article, video, event, podcast, job_posting, volunteer_opportunity) description: >- Filter by post classification/content type (article, video, event, podcast, job_posting, volunteer_opportunity) example: article - name: search in: query required: false schema: anyOf: - type: string maxLength: 256 - type: 'null' title: Search Query description: Search query for post titles and content description: Search query for post titles and content example: climate change - name: view in: query required: false schema: anyOf: - type: string - type: 'null' title: View Mode description: >- View mode: 'latest' (all posts) or 'following' (favorited nonprofits only) description: >- View mode: 'latest' (all posts) or 'following' (favorited nonprofits only) example: following - name: city in: query required: false schema: anyOf: - type: string minLength: 2 maxLength: 100 - type: 'null' title: Organization City description: Filter posts by the city of the nonprofit organization description: Filter posts by the city of the nonprofit organization example: San Francisco - name: county in: query required: false schema: anyOf: - type: string minLength: 2 maxLength: 100 - type: 'null' title: Organization County description: Filter posts by the county of the nonprofit organization description: Filter posts by the county of the nonprofit organization example: San Francisco County - name: state in: query required: false schema: anyOf: - type: string minLength: 2 maxLength: 2 - type: 'null' title: Organization State description: >- Filter posts by the state of the nonprofit organization (2 character abbreviation) description: >- Filter posts by the state of the nonprofit organization (2 character abbreviation) example: CA - name: zip_code in: query required: false schema: anyOf: - type: string pattern: ^\d{5}$ - type: 'null' title: Organization ZIP Code description: >- Filter posts by the ZIP code of the nonprofit organization (5 digits) description: >- Filter posts by the ZIP code of the nonprofit organization (5 digits) example: '94102' - name: ntee_codes in: query required: false schema: anyOf: - items: type: string type: array - type: 'null' title: NTEE Codes description: >- Filter posts by NTEE (National Taxonomy of Exempt Entities) codes of the nonprofit organization default: [] description: >- Filter posts by NTEE (National Taxonomy of Exempt Entities) codes of the nonprofit organization example: - A20 - B25 - 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: Items per page default: 10 title: Size description: Items per page responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/PaginatedResponse_NonprofitPostResponse_' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - APIKeyHeader: [] components: schemas: PaginatedResponse_NonprofitPostResponse_: properties: items: items: $ref: '#/components/schemas/NonprofitPostResponse' 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[NonprofitPostResponse] HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError NonprofitPostResponse: properties: organization_ein: type: string title: Organization Ein post_title: type: string title: Post Title organization_name: anyOf: - type: string - type: 'null' title: Organization Name organization_city: anyOf: - type: string - type: 'null' title: Organization City organization_state: anyOf: - type: string - type: 'null' title: Organization State post_id: anyOf: - type: string - type: 'null' title: Post Id post_classification: anyOf: - type: string - type: 'null' title: Post Classification post_description: anyOf: - type: string - type: 'null' title: Post Description post_content: anyOf: - type: string - type: 'null' title: Post Content post_url: anyOf: - type: string - type: 'null' title: Post Url post_published_date: anyOf: - type: string - type: 'null' title: Post Published Date post_author: anyOf: - type: string - type: 'null' title: Post Author post_categories: anyOf: - items: type: string type: array - type: 'null' title: Post Categories post_tags: anyOf: - items: type: string type: array - type: 'null' title: Post Tags type: object required: - organization_ein - post_title title: NonprofitPostResponse 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 ````