Zabihah
53,000+ halal places · Free
A regulated REST API for Zabihah's first-party halal data.
Base URL: https://www.zabihah.com/api/v1
Every request needs an API key. Apply for a sandbox key, then send it as a bearer token (or an x-api-key header):
curl "https://www.zabihah.com/api/v1/places/search?keyword=kabab&lat=38.9&lng=-77.4&radius=25&parts=hours&parts=cuisines" \
-H "Authorization: Bearer zbh_live_..."Limits depend on your tier. Every response includes X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset; a 429 includes Retry-After.
A program-wide safety cap may throttle Free and sandbox traffic during extreme load or a metering outage; it does not reduce a paid Pro app's guaranteed allowance. Attribution to Zabihah is required on every plan.
/api/v1/places/searchBounded search by keyword and/or location. Query params: keyword, lat, lng, radius (miles, ≤ 100), cuisine (repeatable), meatHalalStatus (full/partial, repeatable), type (restaurant/mosque), page, pageSize (≤ 25), parts (cuisines, hours, amenities, links; repeatable). Search is per-lookup only — there is no bulk export.
Every search must be constrained (a 400 otherwise): provide at least one meaningful filter (keyword, lat+lng together, cuisine, or meatHalalStatus); a keyword must be ≥ 2 characters and not a wildcard; radius requires coordinates; and the result window (page × pageSize) is capped. Systematic extraction patterns are monitored and may be throttled.
{
"page": 1, "pageSize": 25, "total": 42, "totalPages": 2,
"items": [{
"id": "…", "name": "…", "type": "Restaurant",
"location": { "city": "…", "latitude": 38.9, "longitude": -77.4 },
"halal": {
"meatHalalStatus": "Full",
"verificationStatus": { "code": 6, "label": "Authorized halal by a governmental entity." },
"handSlaughtered": true, "alcoholPolicy": "NotAllowed",
"authority": "…", "supplier": "…"
},
"halalRank": { "score": 82, "tier": "Verified", "computedOn": "…" },
"_attribution": "Data © Zabihah — https://www.zabihah.com"
}]
}/api/v1/places/{id}First-party detail for one place: halal signals, HalalRank, hours, cuisines, amenities, and contact links.
/api/v1/halalrank/{id}HalalRank tier/score plus the halal-signal summary for one place. Requires the halalrank.read scope.
Higher quota is earned by sending data back (the contribute.write scope). Accepted contributions raise your daily ceiling — and halal evidence, once approved by our moderators, strengthens HalalRank. Nothing you send is applied automatically; everything passes human review.
/api/v1/contribute/correctionReport a data fix. Body: { placeId, field, suggestedValue, currentValue?, note? }.
/api/v1/contribute/halal-evidenceSubmit halal evidence. Body: { placeId, evidenceType, value, igHandle? } where evidenceType is 3 (supplier name), 4 (Instagram), 5 (staff note), or 6 (issue report).
/api/v1/contribute/signalSend an anonymized usage signal (no PII). Body: { type, placeId?, query?, count? } where type is one of search, view, tap, favorite, direction.
/api/v1/contribute/missing-placeTell us about a place we're missing. Body: { name, address?, city?, lat?, lng?, note? }.
/api/v1/contribute/reviewSubmit a review written by one of your end users. Body: { placeId, rating (1–5), comment, dishes?, willReturn?, dinedOn?, externalAuthorName?, sourceUrl? }. Stored for moderation; once our team accepts it, it publishes on the Zabihah place page attributed to your app (“via {your app}”) and the author name you provide. You must have the right to share the review and it must be genuine first-party content — see the API terms. This is a pilot, enabled per program; contact us if you'd like access.
The API is versioned in the path (/api/v1). We add fields without bumping the version; breaking changes ship under a new version. When a version is deprecated we announce it and support it for at least 6 months before removal, with a Sunset header on the old version during the window.
The API exposes Zabihah's first-party halal data only. It deliberately does not return third-party reviews, ratings, or photos, community discussions, contributor identities, private playlists, behavioral data, or moderation details. Every place includes a zabihahUrl deep link — the richer material (full reviews, photos, detailed halal reports) lives on the Zabihah page you link to.
You must display attribution to Zabihah wherever this data appears. Bulk redistribution, re-caching beyond reasonable TTLs, and building a competing directory are not permitted. Third-party aggregated content is never served through this API. See the full API terms.