MyWed APImywed.com ↗
Access MyWed.com data via API: browse top-rated wedding photographers by location, retrieve portfolios, EXIF photo details, and forum posts across 10 endpoints.
What is the MyWed API?
The MyWed.com API exposes 10 endpoints covering the full photographer directory on mywed.com, including global and location-filtered listings, individual profiles, a photo gallery feed, and forum posts. With get_top_rated_photographers you can pull structured photographer records — name, pricing, location, and portfolio photos — paginated across the global catalog. Location filtering is available down to city level, and individual photo records include EXIF metadata and author attribution.
curl -X GET 'https://api.parse.bot/scraper/f7f4f4b2-c3fe-4908-97c3-21876fb48a72/get_top_rated_photographers?page=1' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace mywed-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""MyWed Photography API — browse photographers, photos, and forum posts."""
from parse_apis.mywed_photography_api import MyWed, Category, CountrySlug, NotFound
client = MyWed()
# Browse top-rated wedding photographers globally
for photographer in client.photographers.top_rated(limit=3):
print(photographer.name, photographer.surname, photographer.login)
# Search by category — use the Category enum for typed filtering
for photographer in client.photographers.search(category_id=Category.PORTRAIT, limit=3):
print(photographer.name, photographer.has_pro)
# Get photographer profile details by username from a listing
first = client.photographers.by_country(country_slug=CountrySlug.UNITED_STATES, limit=1).first()
if first:
profile = client.photographerprofiles.get(username=first.login)
print(profile.full_name, profile.location, profile.phone)
# Browse best photos and drill into detail for EXIF data
photo = client.photosummaries.best(limit=1).first()
if photo:
detail = photo.details()
print(detail.author_login, detail.exif)
# List countries and drill into cities sub-resource
country = client.countries.list(limit=1).first()
if country:
for city in country.cities.list(limit=3):
print(city.name, city.path)
# Typed error handling — catch NotFound on a bad username
try:
client.photographerprofiles.get(username="nonexistent-user-xyz-000")
except NotFound as exc:
print(f"Profile not found: {exc.username}")
print("exercised: photographers.top_rated / search / by_country / photographerprofiles.get / photosummaries.best / details / countries.list / cities.list")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.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number (1-based) |
{
"type": "object",
"fields": {
"page": "integer, current page number",
"per_page": "integer, results per page (typically 30)",
"photographers": "array of photographer objects with id, name, surname, login, pricing, location, and portfolio photos"
}
}About the MyWed API
Photographer Discovery
The API offers four complementary ways to query the photographer directory. get_top_rated_photographers returns a paginated global feed of top-rated photographers, each record including id, name, surname, login, pricing, location, and an array of portfolio photos. For regional targeting, get_photographers_by_country accepts a country_slug (sourced from get_available_countries) and additionally returns a cities array of popular cities within that country. get_photographers_by_city narrows further using a city_path segment and country_slug pair — city paths come from get_cities_by_country, which returns path values in the format United-States:NY-New-York; only the segment after the colon is passed to get_photographers_by_city. search_photographers filters by photography category using category_id values 1–8, covering wedding, couple, maternity, newborn, child, family, and portrait specialties.
Photographer Profiles
get_photographer_profile fetches a single photographer's page by username and returns full_name, location, bio, phone, url, and a social_links array. Not all fields are guaranteed — bio, phone, and location may be absent depending on what the photographer has published. Social links include type and URL when present.
Photos and Forum
get_best_photos returns a paginated feed of photo objects from the site's gallery, each with id, url, and image_url. For individual photos, get_photo_detail accepts a numeric photo_id and returns EXIF data as a text string, author, author_login, and the full-resolution image_url. The EXIF field may be empty if the photographer did not publish shooting data. get_forum_posts retrieves forum and story post listings with id, title, and url per post — useful for monitoring community content without navigating the site directly.
The MyWed API is a managed, monitored endpoint for mywed.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when mywed.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official mywed.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a photographer comparison tool filtered by country or city using
get_photographers_by_countryand pricing fields - Aggregate portfolios from top-rated photographers globally via
get_top_rated_photographersfor a curated gallery app - Index wedding photographer profiles including bio and social links for a B2B lead or directory product
- Pull EXIF metadata from photos via
get_photo_detailto analyze popular camera equipment and shooting settings among wedding photographers - Monitor new forum and story posts from
get_forum_poststo surface wedding photography community trends - Filter photographers by specialty category (e.g. maternity, newborn) using
search_photographerswithcategory_id - Populate a location-aware search UI by chaining
get_available_countries,get_cities_by_country, andget_photographers_by_city
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does MyWed.com have an official developer API?+
What does get_photographer_profile return, and are all fields always present?+
get_photographer_profile returns full_name, url, username, and optionally bio, phone, location, and social_links. The optional fields depend on what each photographer has added to their profile — they may be absent or empty in the response. You should handle missing fields defensively in your integration.How do city paths work when querying photographers by city?+
get_cities_by_country returns path values in the format CountrySlug:CityPath (e.g. United-States:NY-New-York). When calling get_photographers_by_city, pass only the segment after the colon as city_path, and the full country slug as country_slug. Passing the full path including the prefix to city_path will not return results.Does the API return photographer reviews or ratings?+
pricing, location, and portfolio photos, but individual review counts, star ratings, or review text are not exposed as distinct fields. You can fork this API on Parse and revise it to add an endpoint targeting per-photographer review data.Does the forum endpoint return the full post body or just listings?+
get_forum_posts returns post id, title, and url — it is a listing feed, not a content endpoint. Full post body and comments are not currently included. You can fork this API on Parse and revise it to add a post detail endpoint that fetches the full content for a given post ID.