Developers & syndication

HelpHope provides read-only public APIs and RSS feeds so NGOs, journalists, and volunteers can discover urgent requests.

Public API v1

• GET https://needhelp.info/api/v1/posts — List active posts (optional ?country= & ?urgency= & ?limit=)
• GET https://needhelp.info/api/v1/posts/{id} — Get one post by ID
• GET https://needhelp.info/feed.xml — RSS (all)
• GET https://needhelp.info/feed/{lang} — RSS by locale
• GET https://needhelp.info/api/v1/geojson — GeoJSON map points (lat/lng only, no exact addresses)
• GET https://needhelp.info/api/oembed?url={post_url} — oEmbed
• https://needhelp.info/embed/request/{id} — iframe embed card

Webhooks (admin)

Register HTTPS endpoints to receive post.created and offer.created events. Requires x-admin-key header.

POST https://needhelp.info/api/webhooks
Header: x-admin-key: YOUR_KEY
Body: { "url": "https://example.com/hook", "events": ["post.created", "offer.created"] }

API Terms (summary)

Use only for humanitarian discovery and citation. No harassment, doxxing, commercial spam, or resale of personal data. Respect rate limits. Exact contacts and restricted locations are never in the public API. See OpenAPI under docs/openapi/needhelp-v1.yaml.

Try the RSS feed →

Cold-start playbook for partners: see repository docs/COLD_START_PLAYBOOK.md and docs/HELP_EFFECTIVENESS_ROADMAP.md.