انتقل إلى المحتوى الرئيسي

Public API and feeds

There are two ways to bring hangel’s public information to other websites and apps. Both are free, need no key and return no personal data.

The difference in one sentence

The API is for developers who pull hangel data into their own app; embed codes and feeds are for organisations that don’t code and want to show their listings on their own website with copy and paste.

API for developers

The door through which two pieces of software talk. It returns information that is already public on our pages, in a tidy, machine-readable form.

  1. hangel

  2. API v1 · OpenAPI 3.1

    • /api/v1/ngos
    • /api/v1/events
    • /api/v1/volunteering
    • /api/v1/funds
    • /api/v1/stores
    • /api/v1/products
    • /api/v1/library
    • /api/v1/platform
  3. Your app

  • Documented: every endpoint, parameter and response is in the OpenAPI 3.1 document.
  • Read-only: it only reads; it never writes or deletes anything.
  • No key and free; there is a per-minute request limit for fair use.
  • No personal data: no email, phone number or street address is returned.

Sample request

curl "https://hangel.org/api/v1/volunteering?city=izmir&limit=5"
200 OK · application/json

Use the API in three steps

  1. Open the OpenAPI document or load it into a tool such as Postman.

  2. Try the sample request: fetch the volunteering listings in your city.

  3. Connect it to your app with pagination and filters.

Embed codes and feeds for organisations

No code needed: hangel listings appear on your NGO’s, club’s or company’s own website and update on their own.

  1. hangel

  2. Embed codes · RSS · JSON

  3. Your organisation’s website

    • Feed reader

Add it to your website in three steps

  1. Open “Add to your website” in your organisation panel.

  2. Choose the look and copy the code.

  3. Paste the code anywhere on your website; new listings appear on their own.

Embed codes

Ready-made pieces that show your events and volunteering listings, your member badge or a single event on your website.

See the embed codes

RSS and JSON feeds

Feed readers, news aggregators and other websites pick up new entries here automatically. Every organisation also has its own listings feed and calendar.

Organisation calendar (ICS): https://hangel.org/takvim/kurum/{id}.ics

All technical details

Which one is right for you?

If you write software, start with the API; if you want to put listings on your organisation’s website, start with the embed code. If you get stuck, the support form in the developer hub will help.

Stuck on a term? hangel Glossary