queer APIqueer.paris ↗
Access upcoming LGBTQ+ events in Paris and Île-de-France via the queer.paris API. Filter by category or time period. Returns title, date, venue, and image.
What is the queer API?
The queer.paris API exposes a single endpoint, list_events, that returns all upcoming LGBTQ+ events in Paris and Île-de-France as a chronologically ordered array. Each event object includes up to 6 fields: title, date, time, venue, detail page URL, and image. You can narrow results by event category or time period using the what and when query parameters, making it straightforward to pull targeted listings for parties, drag shows, brunches, exhibitions, and other events.
curl -X GET 'https://api.parse.bot/scraper/3d1da655-8f8f-4bae-9d0c-93091ff908f0/list_events?what=drag&when=09-2026' \ -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 queer-paris-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.
"""Walkthrough: browse upcoming LGBTQ+ events in Paris."""
from parse_apis.queer_paris_api import QueerParis, What, When, ParseError
client = QueerParis()
# List all upcoming events, capped to 5 items.
for event in client.events.list(limit=5):
print(f"{event.date} {event.time} — {event.title} @ {event.location}")
# Filter by category: drag shows this weekend.
drag_event = client.events.list(what=What.DRAG, when=When.WEEKEND, limit=1).first()
if drag_event is not None:
print(f"First drag show this weekend: {drag_event.title}")
print(f" Details: {drag_event.url}")
# Filter by month: clubbing events in September 2026.
try:
for event in client.events.list(what=What.CLUBBING, when=When.SEPTEMBER_2026, limit=3):
print(f"{event.date_label} — {event.title} ({event.location})")
except ParseError as e:
print(f"Extraction failed ({e.code}): {e}")
print("exercised: events.list with category/time filters")
Returns all upcoming LGBTQ+ events in Paris and Île-de-France. For each event on the listing page, its detail page is fetched to extract the ticket/booking link (e.g. Shotgun, BilletWeb, Weezevent). Each event includes its title, date, time, venue, detail page URL, image, and ticket link (with UTM/tracking parameters stripped). Results are ordered chronologically. Optionally filter by time period (when) and/or event category (what). When both filters are supplied they are combined. When no filters are supplied, all upcoming events are returned. Note: one HTTP request per event is made to retrieve ticket links, so response time scales with the number of matching events.
| Param | Type | Description |
|---|---|---|
| what | string | Event category filter. Omit to return all categories. |
| when | string | Time period filter. Values follow the site's URL slugs: 'weekend' for this weekend, a month in MM-YYYY format (e.g. '09-2026'), or a named period like 'pride-2026' or 'global-black-pride'. Omit to return all upcoming events. |
{
"type": "object",
"fields": {
"events": "Array of event objects ordered chronologically, each containing event_id, title, date, date_label, time, location, url, image_url, and ticket_link",
"total_count": "Total number of events matching the current filter, as shown by the site"
},
"sample": {
"data": {
"events": [
{
"url": "https://queer.paris/Queer-Summer-Market-2026-435854",
"date": "2026-08-30",
"time": "12:00",
"title": "Queer Summer Market 2026",
"event_id": "435854",
"location": "Plantation Paris — Ferme Urbaine et Événements Engagés en Rooftop",
"image_url": "https://queerparis.b-cdn.net/u/2608/Queer-Summer-Market-2026-435854-1780939486360.webp",
"date_label": "Ce soir"
},
{
"url": "https://queer.paris/Bingo-Drag-de-Gigi-Von-Dredee-a-la-Folie-avec-Bichette--436383",
"date": "2026-08-30",
"time": "18:00",
"title": "Bingo Drag de Gigi Von Dredee à la Folie! avec Bichette!",
"event_id": "436383",
"location": "À la folie",
"image_url": "https://queerparis.b-cdn.net/u/2608/Bingo-Drag-de-Gigi-Von-Dredee-a-la-Folie-avec-Bichette--436383-1781874114360.webp",
"date_label": "Ce soir"
}
],
"total_count": 73
},
"status": "success"
}
}About the queer API
What the API returns
The list_events endpoint returns the full upcoming event calendar from queer.paris, covering Paris and the wider Île-de-France region. Each event object in the events array includes the event title, date, time, venue name, a URL pointing to the event's detail page on queer.paris, and an image URL. The response also includes a total_count field reflecting the number of matched events as reported by the source.
Filtering results
Two optional parameters control which events are returned. The what parameter accepts a category string (e.g. a genre or event type matching the site's own category slugs) to limit results to a specific type of event. The when parameter accepts either 'weekend' to fetch events occurring this weekend, or a month string in MM-YYYY format to fetch events within a given calendar month. Both parameters can be omitted to retrieve the full chronological listing across all categories and dates.
Coverage and scope
queer.paris focuses specifically on LGBTQ+ events in Paris and Île-de-France. Coverage includes parties, drag shows, clubbing nights, brunches, and cultural exhibitions. Results are ordered chronologically. The API does not paginate — all matching events are returned in a single response, consistent with how the site presents its listings.
The queer API is a managed, monitored endpoint for queer.paris — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when queer.paris 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 queer.paris 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 city guide app surfacing upcoming LGBTQ+ events by venue in Paris
- Power a weekend planner widget filtered by 'weekend' using the
whenparameter - Aggregate monthly event calendars using the MM-YYYY format of the
whenfilter - Display event images and titles in a card-based feed using the image and title fields
- Track how many events are listed per category using
total_countacrosswhatfilter values - Notify users about upcoming drag shows or brunches by filtering with the
whatparameter - Cross-reference Paris LGBTQ+ venues by collecting the venue field across all events
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does queer.paris have an official developer API?+
What does the `list_events` endpoint return for each event?+
total_count of matched events. No additional detail (e.g. ticket links, full descriptions, or organizer contacts) is currently included in the event objects.Does the API cover events outside Paris and Île-de-France?+
Does the API return full event descriptions or ticket purchase links?+
detail page URL field pointing back to queer.paris, where that information may be available. You can fork the API on Parse and revise it to add an endpoint that fetches per-event detail pages.Are past events included in the results?+
list_events endpoint returns only upcoming events, ordered chronologically. Historical event data is not exposed. The API covers future-dated events across all available categories and time periods the site lists.