# Salah — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Retrieve accurate Islamic prayer times for any location by entering coordinates or a location name, or browse default times from the site homepage. Access daily prayer schedules including Fajr, Sunrise, Dhuhr, Asr, Maghrib, Isha, and Qiyam for locations worldwide.

**Category:** Other | **Website:** [salah.com/](https://salah.com/) | **Docs:** [parse.bot/marketplace/09826426-d1a6-4a6e-a228-0256571d0496/salah-com-api](https://parse.bot/marketplace/09826426-d1a6-4a6e-a228-0256571d0496/salah-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-salah-com-api-09826426/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_all_prayer_times_for_location

Accepts a city name or address, geocodes it via Nominatim, and returns the prayer times for that location from salah.com. The geocoding step translates the text query to coordinates, then fetches prayer times using those coordinates. If the location cannot be geocoded, returns input_not_found.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `location` | string | Yes | City name or address to search for (e.g. 'London, UK', 'Tokyo, Japan', 'Dubai, UAE') |
| `method_id` | integer | No | Calculation method ID for prayer time computation. When omitted, the site uses its default method for the region. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-salah-com-api-09826426/get_all_prayer_times_for_location \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"location":"<string>","method_id":"<integer>"}'
```

### get_mosques

Returns mosque information for a given location. Note: mosque directory data may not be available for all regions.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-salah-com-api-09826426/get_mosques \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_prayer_times_by_coordinates

Fetches today's prayer times for a given location using latitude and longitude coordinates. Returns prayer names (Fajr, Sunrise, Dhuhr, Asr, Maghrib, Isha, Qiyam) with their times formatted as 'HH:MM AM/PM'. Uses the salah.com /get endpoint with coordinate parameters. If coordinates resolve to no known location, returns input_not_found.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `latitude` | number | Yes | Latitude of the location (e.g. 40.7128) |
| `longitude` | number | Yes | Longitude of the location (e.g. -74.0060) |
| `method_id` | integer | No | Calculation method ID for prayer time computation. When omitted, the site uses its default method for the region. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-salah-com-api-09826426/get_prayer_times_by_coordinates \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"latitude":"<number>","longitude":"<number>","method_id":"<integer>"}'
```

### get_prayer_times_homepage

Retrieves the default prayer times and calculation method for the auto-detected location from the salah.com homepage. No input parameters required — location is determined by the server based on the requesting IP. Returns the detected location name, the calculation method used, and all prayer times.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-salah-com-api-09826426/get_prayer_times_homepage \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```