List events

curl -G https://api.softon.dev/v1/events \
  -H "Authorization: Bearer $SOFTON_KEY" \
  -d q=gimnastika -d category=cinema -d updated_after=2026-08-16T09:00:00Z

req, _ := http.NewRequestWithContext(ctx, "GET",
    "https://api.softon.dev/v1/events", nil)
req.Header.Set("Authorization", "Bearer "+os.Getenv("SOFTON_KEY"))

q := req.URL.Query()
q.Set("q", "gimnastika")
q.Set("category", "cinema")
q.Set("updated_after", "2026-08-16T09:00:00Z")
req.URL.RawQuery = q.Encode()

res, err := http.DefaultClient.Do(req)
if err != nil { log.Fatal(err) }
defer res.Body.Close()

var page struct {
    Data []Event `json:"data"`
    Meta struct{ Next *string `json:"next"` } `json:"meta"`
}
if err := json.NewDecoder(res.Body).Decode(&page); err != nil { log.Fatal(err) }
// page.Meta.Next → send it back as ?cursor= for the following page

import json, os, urllib.parse, urllib.request

url = "https://api.softon.dev/v1/events" + "?" + urllib.parse.urlencode({
    "q": "gimnastika",
    "category": "cinema",
    "updated_after": "2026-08-16T09:00:00Z",
})
req = urllib.request.Request(url, headers={
    "Authorization": "Bearer " + os.environ["SOFTON_KEY"],
})
page = json.load(urllib.request.urlopen(req))
# page["meta"]["next"] → send it back as ?cursor= for the following page

const url = new URL("https://api.softon.dev/v1/events");
url.searchParams.set("q", "gimnastika");
url.searchParams.set("category", "cinema");
url.searchParams.set("updated_after", "2026-08-16T09:00:00Z");

const res = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.SOFTON_KEY}` },
});
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const { data, meta } = await res.json();
// meta.next → send it back as ?cursor= for the following page

{
  "data": [
    {
      "id": "iticket:12299",
      "source": "iticket",
      "name": "The Golden Collection: Pearls of Azerbaijani Fine Art",
      "category": "exhibitions",
      "venue": {
        "id": "museum-center", "name": "Museum Center",
        "address": null, "lat": 40.3698087, "lng": 49.8425258
      },
      "starts_at": "2026-08-05T06:00:00Z",
      "ends_at": "2026-09-15T13:00:00Z",
      "price": { "min": 7, "max": 10, "currency": "AZN" },
      "age_limit": "16+",
      "tickets_available": 7199,
      "url": "https://iticket.az/az/events/exhibitions/the-golden-collection-pearls-of-azerbaijani-fine-art8749",
      "external_url": null,
      "ingested_at": "2026-08-04T23:55:46.834186Z"
    }
  ],
  "meta": { "count": 1, "next": "eyJvIjoyfQ", "request_id": "req_9Fv3" },
  "error": null
}