# Mywed — 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.

> Find and connect with photographers worldwide by browsing top-rated professionals, filtering by location, viewing their portfolios and best work, while engaging with the wedding photography community through forums. Discover photographers in your country or city, explore their detailed profiles and photo galleries, and participate in discussions with other users.

**Category:** Business Directories | **Website:** [mywed.com/](https://mywed.com/) | **Docs:** [parse.bot/marketplace/aa47153c-3c02-4650-8457-ed5dbbd52d5f/mywed-com-api](https://parse.bot/marketplace/aa47153c-3c02-4650-8457-ed5dbbd52d5f/mywed-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-mywed-com-api-aa47153c/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_available_countries

List all countries active on mywed.com with their IDs and URL slugs. Returns the curated set of countries where photographers are available. Country slugs feed into get_photographers_by_country; country IDs feed into get_cities_by_country.

**Estimated cost:** Metered

_No parameters required._

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

### get_best_photos

Retrieve the curated best/latest photos feed from the gallery. Returns photo thumbnails with IDs, page URLs, and image source URLs. Some entries may lack an ID when they are promotional placeholders. Paginates via page counter.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number (1-based) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mywed-com-api-aa47153c/get_best_photos \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### get_cities_by_country

List cities for a specific country by country ID. Returns city names, IDs, and full path strings. The path includes the country prefix separated by a colon (e.g. 'United-States:NY-New-York'); use only the segment after the colon for get_photographers_by_city.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country_id` | string | Yes | Country ID from get_available_countries (e.g. '161' for United States, '62' for India) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mywed-com-api-aa47153c/get_cities_by_country \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country_id":"<string>"}'
```

### get_forum_posts

List forum/story posts with pagination. Returns post titles, IDs, and URLs. Posts include community discussions, wedding stories, and platform announcements.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number (1-based) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mywed-com-api-aa47153c/get_forum_posts \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### get_photo_detail

Retrieve detailed information for a single photo by ID. Returns the full-resolution image URL, EXIF data (camera model, aperture, shutter speed, ISO), and author information. Use photo IDs from get_best_photos.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `photo_id` | integer | Yes | Photo ID (numeric), obtainable from get_best_photos |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mywed-com-api-aa47153c/get_photo_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"photo_id":"<integer>"}'
```

### get_photographer_profile

Retrieve a photographer's profile page data by username. Returns basic info (name, location), contact details (phone when published), bio text, and social media links. The username corresponds to the 'login' field from photographer listing endpoints.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `username` | string | Yes | Photographer username/login (e.g. 'traetta', 'albertocosenza') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mywed-com-api-aa47153c/get_photographer_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"<string>"}'
```

### get_photographers_by_city

List photographers filtered by city within a country. Returns the same rich photographer objects scoped to a specific city. Use get_cities_by_country to obtain valid city paths; the path segment after the colon is what this endpoint expects (e.g. 'NY-New-York' from 'United-States:NY-New-York').

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city_path` | string | Yes | City path segment after the colon from get_cities_by_country (e.g. 'NY-New-York', 'CA-Los-Angeles') |
| `country_slug` | string | Yes | Country slug (e.g. 'United-States') |
| `page` | integer | No | Page number (1-based) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mywed-com-api-aa47153c/get_photographers_by_city \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city_path":"<string>","country_slug":"<string>","page":"<integer>"}'
```

### get_photographers_by_country

List photographers filtered by country. Returns the same rich photographer objects as get_top_rated_photographers, scoped to the given country. Also surfaces popular cities within that country for drill-down navigation. Use get_available_countries to obtain valid country slugs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country_slug` | string | Yes | Country slug from get_available_countries (e.g. 'United-States', 'United-Kingdom', 'India') |
| `page` | integer | No | Page number (1-based) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mywed-com-api-aa47153c/get_photographers_by_country \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country_slug":"<string>","page":"<integer>"}'
```

### get_top_rated_photographers

Retrieve globally top-rated wedding photographers. Returns rich structured data from embedded CATALOG_STATE including pricing tiers, location coordinates, and portfolio thumbnail URLs. Paginates via page counter; each page returns up to 30 photographers ordered by platform rating.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number (1-based) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mywed-com-api-aa47153c/get_top_rated_photographers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### search_photographers

Search for photographers globally by photography category (specialty). Returns the same rich photographer objects filtered to the specified category. Categories are fixed: wedding, couple, maternity, newborn, child, family, portrait.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_id` | integer | No | Category ID for photographer specialty |
| `page` | integer | No | Page number (1-based) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mywed-com-api-aa47153c/search_photographers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category_id":"<integer>","page":"<integer>"}'
```