> ## Documentation Index
> Fetch the complete documentation index at: https://docs.harvestapi.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Event

> Get a LinkedIn event by its URL or ID: its description, exact start and end, place, organizer, speakers and the post that announces it. Required at least one of the query parameters

Get a LinkedIn event by its URL or ID: its description, exact start and end, place, organizer, speakers and the post
that announces it. Event URLs carry either the event's ID or its vanity name, and both work.

```javascript JavaScript theme={null}
const params = new URLSearchParams({
  url: 'https://www.linkedin.com/events/7523060148135907328/', // by URL
  // eventId: '7523060148135907328', // by event ID alternatively
});

fetch(`https://api.harvestapi.io/linkedin/event?${params.toString()}`, {
  headers: { 'X-API-Key': '<api-key>' },
})
  .then((response) => response.json())
  .then((data) => console.log(data));
```

```bash cURL theme={null}
curl --request GET \
  --url 'https://api.harvestapi.io/linkedin/event?eventId=7523060148135907328' \
  --header 'X-API-Key: <api-key>'
```

```python Python theme={null}
import requests

url = "https://api.harvestapi.io/linkedin/event?eventId=7523060148135907328"

headers = {"X-API-Key": "<api-key>"}

response = requests.request("GET", url, headers=headers)

print(response.text)
```


## OpenAPI

````yaml GET /linkedin/event
openapi: 3.0.1
info:
  title: HarvestAPI LinkedIn API reference
  description: HarvestAPI LinkedIn API reference
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.harvestapi.io
security:
  - ApiKeyAuthHeader: []
paths:
  /linkedin/event:
    get:
      summary: Get a LinkedIn event
      description: >-
        Get a LinkedIn event by its URL or ID: its description, exact start and
        end, place, organizer, speakers and the post that announces it. Required
        at least one of the query parameters
      parameters:
        - name: url
          in: query
          description: >-
            URL of the event, with its ID or its vanity name, e.g.
            `https://www.linkedin.com/events/7523060148135907328/`
          schema:
            type: string
            format: url
        - name: eventId
          in: query
          description: ID of the event, e.g. `7523060148135907328`
          schema:
            type: string
      responses:
        '200':
          description: Event response
          content:
            application/json:
              schema:
                type: object
                properties:
                  element:
                    $ref: '#/components/schemas/Event'
                  status:
                    type: integer
                  error:
                    type: string
                  query:
                    type: object
                    properties:
                      url:
                        type: string
                      eventId:
                        type: string
              example:
                element:
                  id: '7513241096366268417'
                  linkedinUrl: https://www.linkedin.com/events/7513241096366268417/
                  vanityName: productanalyticsmeetup7513241096366268417
                  name: Product Analytics Meetup
                  description: >-
                    An evening of talks on product analytics, followed by
                    networking.
                  startsAt:
                    date: '2026-10-21T23:00:00.000Z'
                    timestamp: 1792623600000
                  endsAt:
                    date: '2026-10-22T01:00:00.000Z'
                    timestamp: 1792630800000
                  timeZone: AMERICA_CHICAGO
                  displayTime: Oct 21, 2026, 6:00 PM - 8:00 PM CDT
                  status: FUTURE
                  cancelled: false
                  privateEvent: false
                  broadcastTool: null
                  externalUrl: null
                  address:
                    line1: Acme Office
                    line2: 100 Main St
                    line3: null
                    line4: null
                    city: Houston
                    geographicArea: TX
                    postalCode: '77002'
                    country: US
                  venueDetails: Acme Office, 3rd floor
                  attendees: 22 attendees
                  organizer:
                    type: company
                    id: '12345678'
                    linkedinUrl: https://www.linkedin.com/company/12345678/
                    name: Acme
                    logo: >-
                      https://media.licdn.com/dms/image/v2/C4E0BAQexample/company-logo_400_400/0/1600000000000
                  speakers:
                    - id: ACoAABx7Ld0BqT1o3dXc9zKfP2uWm4hYs8vNe5Q
                      linkedinUrl: >-
                        https://www.linkedin.com/in/ACoAABx7Ld0BqT1o3dXc9zKfP2uWm4hYs8vNe5Q
                      firstName: Jane
                      lastName: Smith
                      headline: Business Analyst at Acme
                      picture: >-
                        https://media.licdn.com/dms/image/v2/D5603AQexample/profile-displayphoto-crop_800_800/0/1700000000000
                  image: >-
                    https://media.licdn.com/dms/image/v2/D561EAQexample/event-background-image-crop_720_1280/0/1791296266133
                  post:
                    urn: urn:li:ugcPost:7513241098874417152
                    linkedinUrl: >-
                      https://www.linkedin.com/posts/acme_product-analytics-meetup-activity-7513241099805581314-9Acu
                    text: Join us for our Product Analytics Meetup in Houston!
                    likes: 7
                    comments: 0
                    shares: 1
                status: 200
                query:
                  url: https://www.linkedin.com/events/7513241096366268417/
        '400':
          description: Neither a valid event `url` nor an `eventId` was given
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: 'No such event: the `error` is `Event not found`'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Event:
      type: object
      properties:
        id:
          type: string
          description: ID of the LinkedIn event
        linkedinUrl:
          type: string
          format: url
          description: URL of the event
        vanityName:
          type: string
          nullable: true
          description: >-
            The event's vanity name, its other URL:
            `https://www.linkedin.com/events/<vanityName>/`
        name:
          type: string
          nullable: true
          description: Name of the event
        description:
          type: string
          nullable: true
          description: The event's description
        startsAt:
          type: object
          nullable: true
          description: When the event starts
          properties:
            date:
              type: string
              format: date-time
            timestamp:
              type: integer
              format: int64
              description: Milliseconds since the epoch
        endsAt:
          type: object
          nullable: true
          description: When the event ends; null when the organizer set no end time
          properties:
            date:
              type: string
              format: date-time
            timestamp:
              type: integer
              format: int64
              description: Milliseconds since the epoch
        timeZone:
          type: string
          nullable: true
          description: >-
            The event's time zone as LinkedIn names it, e.g. `AMERICA_CHICAGO`
            or `ETC_UTC`
        displayTime:
          type: string
          nullable: true
          description: >-
            The event's time as LinkedIn displays it, e.g. `Oct 21, 2026, 6:00
            PM - 8:00 PM CDT`. The time zone shown is not necessarily the
            event's: `startsAt` and `endsAt` are exact
        status:
          type: string
          nullable: true
          enum:
            - FUTURE
            - ONGOING
            - PAST
          description: Whether the event is upcoming, happening now or over
        cancelled:
          type: boolean
        privateEvent:
          type: boolean
        broadcastTool:
          type: string
          nullable: true
          enum:
            - LINKEDIN_LIVE_VIDEO
            - LINKEDIN_LIVE_AUDIO
            - LINKEDIN_INTERACTIVE_MEETING
          description: >-
            How the event is streamed on LinkedIn; null for an event held in
            person or elsewhere online
        externalUrl:
          type: string
          format: url
          nullable: true
          description: Link of an event held outside LinkedIn
        address:
          type: object
          nullable: true
          description: Where an in-person event takes place
          properties:
            line1:
              type: string
              nullable: true
            line2:
              type: string
              nullable: true
            line3:
              type: string
              nullable: true
            line4:
              type: string
              nullable: true
            city:
              type: string
              nullable: true
            geographicArea:
              type: string
              nullable: true
            postalCode:
              type: string
              nullable: true
            country:
              type: string
              nullable: true
              description: Country code, e.g. `US`
        venueDetails:
          type: string
          nullable: true
          description: The venue as the organizer describes it
        attendees:
          type: string
          nullable: true
          description: The attendee count as LinkedIn displays it, e.g. `22 attendees`
        organizer:
          type: object
          nullable: true
          description: >-
            The organizer: a company (`type` is `company`) or a member (`type`
            is `profile`)
          properties:
            type:
              type: string
              enum:
                - company
                - profile
            id:
              type: string
              nullable: true
              description: The company's ID, or the member's profile ID
            linkedinUrl:
              type: string
              format: url
              nullable: true
            name:
              type: string
              nullable: true
              description: The company's name. Companies only
            logo:
              type: string
              format: url
              nullable: true
              description: URL of the company's logo. Companies only
            firstName:
              type: string
              nullable: true
              description: Members only
            lastName:
              type: string
              nullable: true
              description: Members only
            headline:
              type: string
              nullable: true
              description: Members only
            picture:
              type: string
              format: url
              nullable: true
              description: URL of the member's photo. Members only
        speakers:
          type: array
          items:
            $ref: '#/components/schemas/EventProfile'
        image:
          type: string
          format: url
          nullable: true
          description: URL of the event's cover image
        post:
          type: object
          nullable: true
          description: The LinkedIn post that announces the event
          properties:
            urn:
              type: string
              nullable: true
            linkedinUrl:
              type: string
              format: url
              nullable: true
              description: >-
                URL of the post, which [Get
                post](/linkedin-api-reference/post/get-post) accepts
            text:
              type: string
              nullable: true
            likes:
              type: integer
              nullable: true
            comments:
              type: integer
              nullable: true
            shares:
              type: integer
              nullable: true
      required:
        - id
        - linkedinUrl
    Error:
      required:
        - error
        - message
      type: object
      properties:
        error:
          type: integer
          format: int32
        message:
          type: string
    EventProfile:
      type: object
      description: 'A member the event names: its organizer or a speaker'
      properties:
        id:
          type: string
          nullable: true
          description: >-
            The member's profile ID, which [Get
            profile](/linkedin-api-reference/profile/get) accepts as `query`
        linkedinUrl:
          type: string
          format: url
          nullable: true
        firstName:
          type: string
          nullable: true
        lastName:
          type: string
          nullable: true
        headline:
          type: string
          nullable: true
        picture:
          type: string
          format: url
          nullable: true
          description: URL of the member's photo
  securitySchemes:
    ApiKeyAuthHeader:
      type: apiKey
      in: header
      name: X-API-Key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.