---
title: "Natural-language search for AI assistants. Accepts free-form English queries and extracts location + mode + urgency automatically. Designed for OpenAI Custom GPTs, Claude Tools, Perplexity custom actions. CORS-enabled for browser AI clients."
method: GET
path: "/api/llm-search"
---

# Natural-language search for AI assistants. Accepts free-form English queries and extracts location + mode + urgency automatically. Designed for OpenAI Custom GPTs, Claude Tools, Perplexity custom actions. CORS-enabled for browser AI clients.

`GET /api/llm-search`

## Request

- Base URL: `https://feedam.org`
- URL: `https://feedam.org/api/llm-search`
- Auth: none declared

## Query parameters

- `q` string, required

## Response `200`

Search results with structured intent + natural-language answer

- object
  - `query` string: The original input query
  - `intent` object: Extracted intent: location, mode, urgency, action
    - `location` string: 5-digit ZIP or "City, ST"
    - `state` string: 2-letter US state code
    - `mode` 'free' | 'snap' | 'wic' | 'school' | 'summer'
    - `urgent` boolean
    - `intent` 'find' | 'apply'
  - `answer` string: Natural-language answer the AI can return verbatim or rephrase
  - `action` string: What the response represents: search_results | apply_snap | apply_wic | need_location
  - `result_count` integer
  - `total_available` integer
  - `resources` object[]
    - `id` integer
    - `name` string
    - `type` string
    - `address` string
    - `phone` string, nullable
    - `distance_miles` number, nullable
    - `open_status` 'open' | 'closed' | 'closes_soon' | 'opens_soon' | 'unknown'
    - `feedam_detail_url` string, uri
  - `related_links` object: Useful follow-up URLs the AI can offer
  - `attribution` string

---

[API](https://skmtc.dev/feedam/apis/feed-america-api.md) · [All operations](https://skmtc.dev/feedam/apis/feed-america-api/llms.txt) · [OpenAPI document](https://skmtc.dev/feedam/apis/feed-america-api/revisions/5c4569cd2ca6?raw)