EventLane API Documentation

Learn how to authenticate, make API requests, and retrieve real-time Facebook events using the EventLane REST API.

Authentication

All API requests require authentication using your personal API key. You can get your key after signing up at dashboard.eventlane.pro or by writing email to contact@eventlane.pro with request to issue API key

API-Key: YOUR_API_KEY
        

Keep your API key secret — do not expose it in client-side code.

Base URL

https://api.eventlane.pro

Endpoints

POST /subscribe-to-page/

Subscribe to Facebook page. Go to Facebook page and extract the page id from URL. Example, extract EdSheeranMusic from https://www.facebook.com/EdSheeranMusic

POST https://api.eventlane.pro/events?city=warsaw&limit=5
API-Key: YOUR_API_KEY
{
    "fb_page_id": "LiveNationPL"
}
            

Example Response

201 NO CONTENT
            

GET /events/

Fetch a list of Facebook events based on filters such as city, page, category, or date range.

POST https://api.eventlane.pro/events?city=warsaw
API-Key: YOUR_API_KEY
            

Query Parameters

Parameter Type Description
city string Filter events by city name (e.g. “Warsaw”).
page_ids string Filter by specific Facebook page ID. Pass comma separated page ids
page integer Page number to paginate

Example Response

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "id": 6,
      "created_at": "2025-10-11T06:48:12.320842Z",
      "updated_at": "2025-10-11T06:48:12.320890Z",
      "event_id": 1948514522557137,
      "event_time_id": null,
      "title": "ARMIA – Official Event, 11.10.2025, Blue Note, Poznań",
      "facebook_url": "https://www.facebook.com/events/1948514522557137/",
      "date_str": "Saturday, October 11, 2025 at 6:00 PM – 11:00 PM CEST",
      "start_date": "2025-10-11T16:00:00Z",
      "end_date": "2025-10-11T21:00:00Z",
      "description": "80 people responded",
      "description_text": "80 people responded",
      "raw_location": "Blue Note Poznań",
      "google_location": {
        "name": "Blue Note Jazz Club",
        "geometry": {
          "location": {
            "lat": 52.40820429999999,
            "lng": 16.9194754
          },
          "viewport": {
            "northeast": {
              "lat": 52.40954373029149,
              "lng": 16.9209345802915
            },
            "southwest": {
              "lat": 52.40684576970849,
              "lng": 16.9182366197085
            }
          }
        },
        "place_id": "ChIJuzwb5TZbBEcRY6E1YZYxJDU",
        "formatted_address": "Tadeusza Kościuszki 79, 61-891 Poznań, Poland",
        "address_components": [
          {
            "types": [
              "political",
              "sublocality",
              "sublocality_level_1"
            ],
            "long_name": "Stare Miasto",
            "short_name": "Stare Miasto"
          },
          {
            "types": [
              "locality",
              "political"
            ],
            "long_name": "Poznań",
            "short_name": "Poznań"
          },
          {
            "types": [
              "country",
              "political"
            ],
            "long_name": "Poland",
            "short_name": "PL"
          }
        ]
      },
      "city": "Poznań",
      "country_code": "PL",
      "image_url": "https://scontent.fktw6-1.fna.fbcdn.net/v/t39.30808-6/514623902_1145203300986338_6958738590563857726_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=109&ccb=1-7&_nc_sid=75d36f&_nc_ohc=UoI0SPw0G6cQ7kNvwEpcj-V&_nc_oc=AdlOTQpZ1ZIIIjAnQ5Y2mCvvNihVQaOJQdFPv2SnH2izyRrXpUR4bThskgfiGJbSwI8&_nc_zt=23&_nc_ht=scontent.fktw6-1.fna&_nc_gid=HO86kkMCXZs1znc1brUXow&oh=00_Afc02MeSYyzAITgyvCOD7JoL8FV4P5q17YThOpAbpRFg3w&oe=68EFC9A9",
      "organizer": "Event by Live Nation Polska and Ticketmaster Polska",
      "people_responded": 80,
      "ticket_url": "www.livenation.pl/armia-tickets-adp1467320",
      "text_classification_categories": [],
      "manual_classification": [],
      "picked_for_model_training": false,
      "entity": 2,
      "categories": []
    }
  ]
}
            

Error Codes

Status Message Description
401 Unauthorized Missing or invalid API key.
404 Not Found Requested resource could not be found.
429 Rate Limit Exceeded You’ve exceeded your free API call limit.