Dates: YYYY-MM-DD or today/tomorrow (Europe/Istanbul), default next 7 days,
maximum 31 days. Times: HH:MM within a day.
Started sessions are excluded by default, even for explicit dates. Use
include_past=true for retained active past sessions; this is not an archive
and expired prices stay unknown. result_info.filter_counts explains exclusions.
start_time_basis records the source of the time. source_time_conflict=true
means published Istanbul HTML session times took precedence over conflicting
JSON-LD times; preserve per-event warnings and verify the ticket page.
timing_kind=flexible_entry has event_date but start_at=null: its source_start_at
is catalogue metadata, never a visit or reservation time. Show the date and
ticket link, and verify opening hours/admission conditions. Clock-filtered
searches exclude date-only flexible tickets; excluded_unverified_time counts them.
admission_window holds published opening/last-entry/closing clocks, not an
appointment. Source excluded_weekdays uses Monday=0..Sunday=6; restricted
dates are excluded and counted in excluded_entry_date. Detail retains them
for inspection with entry_date_restricted=true, never an admission guarantee.
Categories: concert, theatre, opera_ballet, standup, family, festival, exhibition, workshop, sport, seminar,
other. District: one of Istanbul's 39 districts. Coordinates must be paired;
Turkish aliases such as tiyatro, konser, çocuk, atölye are accepted.
query searches titles by default; query_scope=all also searches venue names.
Empty/whitespace query means no text filter. match_mode=words (default)
matches complete normalized words, so Sıla does not match Silahşör.
Use match_mode=prefix explicitly for stems/autocomplete; prefix matches
are related title matches, never proof of artist identity.
radius defaults to 5000m, maximum 20000m. Limit defaults to 10, maximum 50.
Radius/distance are straight-line; the opposite shore may be included.
Price-unknown sessions remain labeled unknown with max_price_try; they are
not verified within budget. free_only requires observed zero price.
Set include_unknown_prices=false for verified-price-only results. Named,
budget, free, category and exclude_child_only queries may refresh up to three
relevant Biletinial details.
Category coverage is partial; category_source distinguishes provider genres
from explicit type markers in titles. Zero matches do not prove no city events.
For users explicitly seeking adult participation, exclude_child_only=true
removes published ranges with an upper age below 18 before result/plan limits.
Unknown ages and minimum-only limits are retained, not verified for the user;
this is not a general adult eligibility guarantee or a guessed numeric age.
child_age (0–17) requires a published matching age range and family genre;
missing age evidence is excluded, not guessed. Ticket-type eligibility and
service fees still need checking on the ticket page.
Explicitly sold-out sessions are excluded unless include_sold_out=true;
with that opt-in, a fresh observed sold-out price can be shown for inspection,
including zero, while availability remains sold_out. It is not an attendance recommendation.
unknown availability is still not a ticket guarantee.
With party_size (1–50) and ticket_profile, max_price_try is the WHOLE PARTY's
observed ticket subtotal for one event. Profiles: general (unrestricted),
adult, student, child, senior, any (conditional observations). Or supply
party={"adult":2,"child":1}; no unknown participant counts are invented.
price_quote gives ticket quantities/package admissions, observed subtotal,
unknown fees and unverified live group/adjacent-seat availability. General
tickets may cover eligible profile groups; discounted tickets are not
assigned to another profile. An adult-only ticket is not a child ticket.
budget_includes_fees=true requires observed fee inclusion; unknown fee totals
remain unknown, never guessed. For a strict budget use include_unknown_prices=false.
Without party/profile, legacy minimum ticket observations remain informational;
minimum_observed_try is not a per-person/group checkout total. Do not divide
or multiply a package label as if it were a single normal ticket.
result_info.empty_reasons and coverage distinguish unknown locations/prices
from verified exclusions. excluded_unknown_location and excluded_outside_location
sum to legacy excluded_location; neither establishes city-wide absence.
participation_conditions contains scoped published statements and unverified_topics;
source claims, source_section and observation time must be preserved. Unknown,
expired or truncated conditions do not establish accessibility, language,
reservation, refunds, materials or personal eligibility. Inspect detail for
full bounded statements. Catalogue venue hints only prioritize verification.
Ticketmaster is a catalogue, not live ticket inventory. Biletinial list
sessions need detail verification for venue, complete sessions and prices.
For each event shown to the user, include a clickable event/ticket-page link
from ticket_url or a non-null ticket_links[].url beside its title. Preserve
the exact returned URL; if none is available, say so rather than inventing one.
Each card includes about.text, a short source excerpt with status, provenance
and truncation. Briefly explain the topic for each recommendation; inspect
event_detail if not_checked. Missing text is unknown, never inferred from a title.
Preserve freshness, source coverage, truncated and warnings; no city-wide
completeness, live seat, routing or checkout guarantee.