Fresh LinkedIn Scraper API

https://docs.saleleads.ai
Admin
A LinkedIn Scraper API that provides endpoints for extracting various data such as jobs, user...
Tokens:76,826
Snippets:125
Trust Score:2.8
Update:8 months ago
Show doc for...
Tokens:
Raw
### GET /api/v1/user/follower-and-connection

Source: https://docs.saleleads.ai/api-reference/user-additional-data/get-user-follower-and-connection

Fetches the number of followers and connections of a user based on the provided username.

```APIDOC
## GET /api/v1/user/follower-and-connection

### Description
Fetches the number of followers and connections of a user based on the provided username.

### Method
GET

### Endpoint
/api/v1/user/follower-and-connection

### Parameters
#### Query Parameters
- **username** (string) - Required - The username of the user whose follower and connection count is being requested.

### Request Example
```json
{
  "example": ""
}
```

### Response
#### Success Response (200)
- **success** (boolean) - Indicates if the request was successful.
- **cost** (number) - Cost of the request.
- **data** (object) - User follower and connection count.
  - **follower_count** (number) - Number of followers.
  - **connection_count** (number) - Number of connections.

#### Response Example
```json
{
  "success": true,
  "cost": 1,
  "data": {
    "follower_count": 11832,
    "connection_count": 1142
  }
}
```

#### Error Responses
- **400 Bad Request**: Indicates an issue with the request parameters.
- **401 Unauthorized**: Indicates an invalid API key.
- **403 Forbidden**: Indicates the user is not subscribed to this API.
- **500 Internal Server Error**: Indicates a server-side issue.
```

--------------------------------

### Get User Volunteers API Endpoint (OpenAPI)

Source: https://docs.saleleads.ai/api-reference/user-additional-data/get-user-volunteers

Defines the GET request for the `/api/v1/user/volunteers` endpoint. It allows fetching volunteer experiences for a given user URN, with options for username and pagination. The response includes success status, cost, total count, pagination information, and a list of volunteer data.

```yaml
openapi: 3.1.0
info:
  title: Linkedin Scraper API
  description: Linkedin Scraper API Documentation
  version: 1.0.0
servers:
  - url: https://fresh-linkedin-scraper-api.p.rapidapi.com
    description: RapiAPI
security: []
paths:
  /api/v1/user/volunteers:
    get:
      tags:
        - User Additional Data
      summary: Get User Volunteers
      description: >-
        Fetches a list of volunteer experiences associated with a specific user
        based on the provided user URN.
      operationId: getApiV1UserVolunteers
      parameters:
        - in: query
          name: urn
          schema:
            type: string
            description: User URN
            example: ACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVffJ3hc
        - in: query
          name: username
          schema:
            type: string
            description: >-
              Username. Enabling this option will consume an additional 1
              request.
            example: simonsinek
        - in: query
          name: page
          schema:
            type: integer
            exclusiveMinimum: 0
            description: Page number for pagination
            default: 1
            example: 1
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  cost:
                    type: number
                    description: Cost of the request
                    example: 1
                  total:
                    type: number
                    description: Total number of user volunteers
                    example: 12
                  has_more:
                    type: boolean
                    description: Whether there are more user volunteers to fetch
                    example: false
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        organization:
                          type: string
                          description: Name of the organization
                          example: DigitalOcean
                        title:
                          type: string
                          description: Title of the volunteer experience
                          example: Volunteer
                        cause:
                          type: string
                          description: Cause of the volunteer experience
                          example: Education
                        duration:
                          type: string
                          description: Duration of the volunteer experience
                          example: 1 year
                        description:
                          type: string
                          description: Description of the volunteer experience
                          example: Mentored students in computer science
                        date:
                          type: object
                          properties:
                            start:
                              type: string
                              description: Start date
                              example: Feb 2025
                            end:
                              type: string
                              description: End date
                              example: Present
                          description: Date of the volunteer experience
                        media:
                          type: array
                          items:
                            type: object
                            properties:
                              title:
                                type: string
                                description: Title of media
                                example: Title
                              description:
                                type: string
                                description: Description of media
                                example: Description
                              thumbnail:
                                type: object
                                properties:
                                  width:
                                    type: number
                                    description: Logo width
                                    example: 400
                                  height:
                                    type: number
                                    description: Logo height
                                    example: 400
                                  url:
                                    type: string
                                    description: Logo URL
                                    example: >-

```

--------------------------------

### Get User Documents API Reference (OpenAPI)

Source: https://docs.saleleads.ai/api-reference/user-profile-data/get-user-documents

This OpenAPI specification defines the 'get /api/v1/user/documents' endpoint. It allows users to retrieve their documents by providing a username and optional pagination parameters. The endpoint supports success and error responses, detailing data structure and potential issues.

```yaml
openapi: 3.1.0
info:
  title: Linkedin Scraper API
  description: Linkedin Scraper API Documentation
  version: 1.0.0
servers:
  - url: https://fresh-linkedin-scraper-api.p.rapidapi.com
    description: RapiAPI
security: []
paths:
  /api/v1/user/documents:
    get:
      tags:
        - User Profile Data
      summary: Get User Documents
      description: Get User Documents
      operationId: getApiV1UserDocuments
      parameters:
        - in: query
          name: username
          schema:
            type: string
          required: true
        - in: query
          name: page
          schema:
            type: integer
            exclusiveMinimum: 0
            description: Page number for pagination
            default: 1
            example: 1
          required: false
        - in: query
          name: pagination_token
          schema:
            type: string
            description: ''
          required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  cost:
                    type: number
                    description: Cost of the request
                    example: 1
                  data:
                    type: object
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: Bad request
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: >-
                      Invalid API key. Go to https://docs.rapidapi.com/docs/keys
                      for more info.
        '403':
          description: Not Found
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: You are not subscribed to this API.
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  message:
                    type: string
                    example: 'Request failed with status 500: Internal Server Error'
                  status_code:
                    type: number
                    example: 500
                  cost:
                    type: number
                    example: 0
                  explain:
                    type: string
                    example: >-
                      Oops, it looks like there was an issue processing your
                      request. Don't worry, you won't be charged for this
                      request. If you need any help, don't hesitate to contact
                      us via email hello@saleleads.ai or telegram
                      https://t.me/saleleads
      security:
        - apiKeyAuth: []
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-rapidapi-key
      description: Rapid API Key

```

--------------------------------

### Get User Follower and Connection (OpenAPI)

Source: https://docs.saleleads.ai/api-reference/user-additional-data/get-user-follower-and-connection

This OpenAPI specification defines the endpoint for fetching a user's follower and connection count. It requires a username as a query parameter and returns success status, cost, and the follower/connection counts. Error responses for bad requests, unauthorized access, and server errors are also defined.

```yaml
openapi: 3.1.0
info:
  title: Linkedin Scraper API
  description: Linkedin Scraper API Documentation
  version: 1.0.0
servers:
  - url: https://fresh-linkedin-scraper-api.p.rapidapi.com
    description: RapiAPI
security: []
paths:
  /api/v1/user/follower-and-connection:
    get:
      tags:
        - User Additional Data
      summary: Get User Follower and Connection
      description: >-
        Fetches the number of followers and connections of a user based on the
        provided username.
      operationId: getApiV1UserFollower-and-connection
      parameters:
        - in: query
          name: username
          schema:
            type: string
            minLength: 1
            description: >-
              The username of the user whose follower and connection count is
              being requested.
          required: true
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  cost:
                    type: number
                    description: Cost of the request
                    example: 1
                  data:
                    type: object
                    properties:
                      follower_count:
                        type: number
                        description: Number of followers
                        example: 11832
                      connection_count:
                        type: number
                        description: Number of connections
                        example: 1142
                    description: User follower and connection count
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: Bad request
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: >-
                      Invalid API key. Go to https://docs.rapidapi.com/docs/keys
                      for more info.
        '403':
          description: Not Found
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: You are not subscribed to this API.
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  message:
                    type: string
                    example: 'Request failed with status 500: Internal Server Error'
                  status_code:
                    type: number
                    example: 500
                  cost:
                    type: number
                    example: 0
                  explain:
                    type: string
                    example: >-
                      Oops, it looks like there was an issue processing your
                      request. Don't worry, you won't be charged for this
                      request. If you need any help, don't hesitate to contact
                      us via email hello@saleleads.ai or telegram
                      https://t.me/saleleads
      security:
        - apiKeyAuth: []
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-rapidapi-key
      description: Rapid API Key

```

--------------------------------

### GET /websites/saleleads_ai/jobs

Source: https://docs.saleleads.ai/api-reference/company/get-company-jobs

Retrieves a list of job postings with detailed information about each job and its associated company.

```APIDOC
## GET /websites/saleleads_ai/jobs

### Description
Retrieves a list of job postings with detailed information about each job and its associated company. This endpoint provides comprehensive details for each job, including its listing date, promotion status, application difficulty, location, and in-depth company information.

### Method
GET

### Endpoint
/websites/saleleads_ai/jobs

### Parameters
#### Query Parameters
- **query** (string) - Optional - The search query to filter jobs.
- **limit** (integer) - Optional - The maximum number of job results to return.
- **offset** (integer) - Optional - The number of job results to skip.

### Request Example
```json
{
  "query": "Software Engineer",
  "limit": 10,
  "offset": 0
}
```

### Response
#### Success Response (200)
- **jobs** (array) - An array of job objects.
  - **job_id** (string) - Unique identifier for the job.
  - **title** (string) - The title of the job.
  - **description** (string) - A detailed description of the job.
  - **posted_at** (string) - Date and time when the job was listed.
  - **is_promote** (boolean) - Indicates if the job is promoted.
  - **is_easy_apply** (boolean) - Indicates if the job is easy to apply for.
  - **location** (string) - Location of the job.
  - **company** (object) - Information about the company posting the job.
    - **id** (string) - Unique identifier for the company.
    - **name** (string) - Name of the company.
    - **url** (string) - URL to the company LinkedIn profile.
    - **verified** (boolean) - Indicates if the company is verified.
    - **logo** (array) - Array of company logos.
      - **width** (number) - Logo width.
      - **height** (number) - Logo height.
      - **url** (string) - Logo URL.
      - **expires_at** (number) - Logo expires at.

#### Response Example
```json
{
  "jobs": [
    {
      "job_id": "job123",
      "title": "Senior Software Engineer",
      "description": "Develop and maintain scalable software solutions...",
      "posted_at": "2025-03-15T03:15:50.000Z",
      "is_promote": false,
      "is_easy_apply": false,
      "location": "United States (Remote)",
      "company": {
        "id": "2847303",
        "name": "Coventry Workers' Comp & Auto Networks",
        "url": "https://www.linkedin.com/company/2847303",
        "verified": true,
        "logo": [
          {
            "width": 400,
            "height": 400,
            "url": "https://media.licdn.com/dms/image/v2/D4E0BAQHjelLY2a-Mnw/company-logo_400_400/company-logo_400_400/0/1666083635765?e=1748476800&v=beta&t=V_T_yXL6Bs2HDEY-iZAKSkNype7_-7USjP2HIXo0Zv8",
            "expires_at": 1748476800000
          }
        ]
      }
    }
  ]
}
```

### Error Handling
- **400 Bad Request**: Returned if the request parameters are invalid.
- **401 Unauthorized**: Returned if the API key is invalid.
- **403 Forbidden**: Returned if the user is not subscribed to this API.
- **500 Internal Server Error**: Returned if an unexpected server error occurs.
```

--------------------------------

### Get User Experiences

Source: https://docs.saleleads.ai/api-reference/user-additional-data/get-user-experiences

Fetches a list of experiences associated with a specific user based on the provided user URN.

```APIDOC
## GET /websites/saleleads_ai/users/{userUrn}/experiences

### Description
Fetches a list of experiences associated with a specific user based on the provided user URN.

### Method
GET

### Endpoint
/websites/saleleads_ai/users/{userUrn}/experiences

### Parameters
#### Path Parameters
- **userUrn** (string) - Required - The unique identifier for the user.

#### Query Parameters
None

#### Request Body
None

### Request Example
None

### Response
#### Success Response (200)
- **experiences** (array) - A list of user experiences.
  - **experienceId** (string) - The unique identifier for the experience.
  - **title** (string) - The title of the experience.
  - **description** (string) - A description of the experience.

#### Response Example
```json
{
  "experiences": [
    {
      "experienceId": "exp_12345",
      "title": "First Time User Onboarding",
      "description": "Guides new users through the initial setup process."
    },
    {
      "experienceId": "exp_67890",
      "title": "Advanced Feature Tutorial",
      "description": "Explains how to use advanced functionalities."
    }
  ]
}
```
```

--------------------------------

### GET /api/v1/user/experience

Source: https://docs.saleleads.ai/api-reference/user-additional-data/get-user-experiences

Fetches a list of experiences associated with a specific user based on the provided user URN.

```APIDOC
## GET /api/v1/user/experience

### Description
Fetches a list of experiences associated with a specific user based on the provided user URN.

### Method
GET

### Endpoint
/api/v1/user/experience

### Parameters
#### Query Parameters
- **urn** (string) - Required - User URN
- **username** (string) - Optional - Username. Enabling this option will consume an additional 1 request.
- **page** (integer) - Optional - Page number for pagination. Defaults to 1.

### Request Example
```json
{
  "example": ""
}
```

### Response
#### Success Response (200)
- **success** (boolean) - Indicates if the request was successful.
- **cost** (number) - Cost of the request.
- **total** (number) - Total number of user experiences.
- **has_more** (boolean) - Whether there are more user experiences to fetch.
- **data** (array) - An array of user experience objects.
  - **title** (string) - Title of the experience.
  - **description** (string) - Description of the experience.
  - **location** (string) - Location of the experience.
  - **employment_type** (string) - Employment type of the experience.
  - **date** (object) - Date of the experience.
    - **start** (string) - Start date.
    - **end** (string) - End date.
  - **skills** (array) - Skills used in the experience.
  - **company** (object) - Company details.
    - **id** (string) - Unique identifier for the company.
    - **name** (string) - Name of the company.
    - **url** (string) - URL to the company LinkedIn.
    - **logo** (array) - Array of logo objects.
      - **width** (number) - Logo width.

#### Response Example
```json
{
  "success": true,
  "cost": 1,
  "total": 12,
  "has_more": false,
  "data": [
    {
      "title": "Software Engineer",
      "description": "Developed and maintained software applications",
      "location": "El Segundo, California, United States · On-site",
      "employment_type": "Full-time",
      "date": {
        "start": "Feb 2025",
        "end": "Present"
      },
      "skills": [
        "JavaScript",
        "React"
      ],
      "company": {
        "id": "2601253",
        "name": "DigitalOcean",
        "url": "https://www.linkedin.com/company/2601253/",
        "logo": [
          {
            "width": 400
          }
        ]
      }
    }
  ]
}
```
```

--------------------------------

### Get Post Content

Source: https://docs.saleleads.ai/api-reference/group/get-group-posts

Retrieves detailed information about a specific post, including its content, author, and creation time.

```APIDOC
## GET /websites/saleleads_ai/posts/{post_id}

### Description
Retrieves detailed information about a specific post, including its content, author, and creation time.

### Method
GET

### Endpoint
/websites/saleleads_ai/posts/{post_id}

### Parameters
#### Path Parameters
- **post_id** (string) - Required - The unique identifier of the post.

#### Query Parameters
None

#### Request Body
None

### Request Example
None

### Response
#### Success Response (200)
- **content** (object) - The main content of the post, which can include text, images, or events.
  - **text** (string) - The textual content of the post.
  - **images** (array) - A list of images associated with the post.
    - **url** (string) - URL of the image.
    - **description** (string) - Description of the image.
  - **event** (object) - Details about an event associated with the post.
    - **description** (string) - Description of the event.
    - **url** (string) - URL for the event.
    - **time_start** (string) - The start time of the event.
    - **time_event** (string) - The general time of the event.
    - **location** (string) - The location of the event.
- **activity** (object) - Metrics related to the post's engagement.
  - **num_likes** (number) - The total number of likes.
  - **num_comments** (number) - The total number of comments.
  - **num_shares** (number) - The total number of shares.
  - **reaction_counts** (array) - A list of reaction types and their counts.
    - **type** (string) - The type of reaction (e.g., LIKE).
    - **count** (number) - The number of times this reaction was received.
- **author** (object) - Information about the author of the post.
  - **id** (string) - The unique identifier of the author.
  - **url** (string) - The LinkedIn URL of the author.
  - **name** (string) - The name of the author.
  - **avatar** (array) - The author's avatar image details.
    - **width** (number) - Width of the avatar image.
    - **height** (number) - Height of the avatar image.
    - **url** (string) - URL of the avatar image.
    - **expires_at** (number) - Timestamp when the avatar URL expires.
- **created_at** (string) - The timestamp when the post was created.
- **url** (string) - The URL of the post.

#### Response Example
```json
{
  "content": {
    "text": "Check out our latest blog post!",
    "images": [
      {
        "url": "https://example.com/image.jpg",
        "description": "Blog post header image"
      }
    ],
    "event": {
      "description": "Webinar on AI trends",
      "url": "https://example.com/webinar",
      "time_start": "2025-04-15T10:00:00Z",
      "time_event": "10:00 AM PST",
      "location": "Online"
    }
  },
  "activity": {
    "num_likes": 150,
    "num_comments": 75,
    "num_shares": 30,
    "reaction_counts": [
      {
        "type": "LIKE",
        "count": 150
      },
      {
        "type": "LOVE",
        "count": 25
      }
    ]
  },
  "author": {
    "id": "user123",
    "url": "https://www.linkedin.com/in/user123",
    "name": "Jane Doe",
    "avatar": [
      {
        "width": 400,
        "height": 400,
        "url": "https://media.licdn.com/dms/image/v2/D4E0BAQHjelLY2a-Mnw/company-logo_400_400/company-logo_400_400/0/1666083635765?e=1748476800&v=beta&t=V_T_yXL6Bs2HDEY-iZAKSkNype7_-7USjP2HIXo0Zv8",
        "expires_at": 1748476800000
      }
    ]
  },
  "created_at": "2025-03-28T10:12:49.775Z",
  "url": "https://example.com/post/123"
}
```
```

--------------------------------

### POST /websites/saleleads_ai/posts

Source: https://docs.saleleads.ai/api-reference/group/get-group-posts

Creates a new post on the SaleLeads AI website. Supports various content types like videos, documents, and articles.

```APIDOC
## POST /websites/saleleads_ai/posts

### Description
Creates a new post on the SaleLeads AI website. This endpoint supports rich content such as videos, documents, and articles.

### Method
POST

### Endpoint
/websites/saleleads_ai/posts

### Parameters
#### Request Body
- **content_type** (string) - Required - The type of content to post (e.g., 'video', 'document', 'article').
- **video** (object) - Optional - Details for a video post.
  - **thumbnail** (string) - Required - URL of the video thumbnail.
  - **expires_at** (number) - Optional - Timestamp when the thumbnail expires.
  - **description** (string) - Optional - Description of the video.
  - **duration** (string) - Optional - Duration of the video.
  - **aspect_ratio** (string) - Optional - Aspect ratio of the video.
  - **streams** (array) - Optional - Array of video stream objects.
    - **url** (string) - Required - URL of the video stream.
    - **expires_at** (number) - Optional - Timestamp when the stream expires.
    - **size** (number) - Optional - Size of the video stream in bytes.
    - **width** (number) - Optional - Width of the video stream.
    - **height** (number) - Optional - Height of the video stream.
    - **bit_rate** (number) - Optional - Bit rate of the video stream.
- **document** (object) - Optional - Details for a document post.
  - **title** (string) - Optional - Title of the document.
  - **total_page_count** (number) - Optional - Total number of pages in the document.
  - **manifest_url** (string) - Optional - URL of the document manifest.
  - **manifest_url_expires_at** (number) - Optional - Timestamp when the manifest URL expires.
  - **transcribed_document_url** (string) - Optional - URL of the transcribed document.
- **article** (object) - Optional - Details for an article post.
  - **title** (string) - Optional - Title of the article.
  - **subtitle** (string) - Optional - Subtitle of the article.
  - **article_url** (string) - Optional - URL of the article.
  - **image** (array) - Optional - Array of image objects for the article.
    - **width** (number) - Optional - Width of the article image.

### Request Example
```json
{
  "content_type": "video",
  "video": {
    "thumbnail": "https://media.licdn.com/dms/image/v2/D4E0BAQHjelLY2a-Mnw/company-logo_400_400/company-logo_400_400/0/1666083635765?e=1748476800&v=beta&t=V_T_yXL6Bs2HDEY-iZAKSkNype7_-7USjP2HIXo0Zv8",
    "description": "A promotional video for our new product.",
    "streams": [
      {
        "url": "https://www.linkedin.com/video/urn:li:dms_video:D4E3DAQGzWAY8oQqw",
        "width": 1920,
        "height": 1080,
        "bit_rate": 5000000
      }
    ]
  }
}
```

### Response
#### Success Response (200)
- **post_id** (string) - The unique identifier for the created post.
- **status** (string) - The status of the post creation (e.g., 'success', 'pending').

#### Response Example
```json
{
  "post_id": "post_12345abc",
  "status": "success"
}
```
```

--------------------------------

### GET /api/v1/company/job-count

Source: https://docs.saleleads.ai/api-reference/company/get-company-job-count

Retrieves the total number of job postings for a specified company. You can identify the company by its unique ID or its name.

```APIDOC
## GET /api/v1/company/job-count

### Description
Retrieves the total number of job postings for a specified company. You can identify the company by its unique ID or its name.

### Method
GET

### Endpoint
/api/v1/company/job-count

### Parameters
#### Query Parameters
- **company_id** (string) - Optional - Company ID. Must be a string of digits.
- **company** (string) - Optional - Company name. Enabling this option will consume an additional request.

### Request Example
```json
{
  "example": "GET /api/v1/company/job-count?company_id=10649600"
}
```

### Response
#### Success Response (200)
- **success** (boolean) - Indicates if the request was successful.
- **cost** (number) - The cost of the request.
- **data** (object) - Contains the job count data.
  - **total** (number) - Total number of company jobs.

#### Response Example
```json
{
  "success": true,
  "cost": 1,
  "data": {
    "total": 500
  }
}
```

#### Error Responses
- **400 Bad Request**: Returned if the request parameters are invalid.
- **401 Unauthorized**: Returned if the API key is invalid.
- **403 Forbidden**: Returned if the user is not subscribed to this API.
- **500 Internal Server Error**: Returned if the server encounters an error.
```

--------------------------------

### GET /api/v1/user/volunteers

Source: https://docs.saleleads.ai/api-reference/user-additional-data/get-user-volunteers

Fetches a list of volunteer experiences associated with a specific user based on the provided user URN or username.

```APIDOC
## GET /api/v1/user/volunteers

### Description
Fetches a list of volunteer experiences associated with a specific user based on the provided user URN or username. This endpoint supports pagination.

### Method
GET

### Endpoint
/api/v1/user/volunteers

### Parameters
#### Query Parameters
- **urn** (string) - Required - User URN (e.g., ACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVffJ3hc)
- **username** (string) - Optional - Username. Enabling this option will consume an additional request.
- **page** (integer) - Optional - Page number for pagination. Defaults to 1. Minimum value is 1.

### Request Example
```json
{
  "example": "GET /api/v1/user/volunteers?urn=ACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVffJ3hc&page=1"
}
```

### Response
#### Success Response (200)
- **success** (boolean) - Indicates if the request was successful.
- **cost** (number) - The cost of the request.
- **total** (number) - The total number of user volunteers found.
- **has_more** (boolean) - Indicates if there are more user volunteers to fetch.
- **data** (array) - An array of volunteer experience objects.
  - **organization** (string) - Name of the organization.
  - **title** (string) - Title of the volunteer experience.
  - **cause** (string) - Cause of the volunteer experience.
  - **duration** (string) - Duration of the volunteer experience.
  - **description** (string) - Description of the volunteer experience.
  - **date** (object) - Date of the volunteer experience.
    - **start** (string) - Start date.
    - **end** (string) - End date.
  - **media** (array) - An array of media objects associated with the experience.
    - **title** (string) - Title of the media.
    - **description** (string) - Description of the media.
    - **thumbnail** (object) - Thumbnail details.
      - **width** (number) - Logo width.
      - **height** (number) - Logo height.
      - **url** (string) - Logo URL.

#### Response Example
```json
{
  "example": {
    "success": true,
    "cost": 1,
    "total": 12,
    "has_more": false,
    "data": [
      {
        "organization": "DigitalOcean",
        "title": "Volunteer",
        "cause": "Education",
        "duration": "1 year",
        "description": "Mentored students in computer science",
        "date": {
          "start": "Feb 2025",
          "end": "Present"
        },
        "media": [
          {
            "title": "Title",
            "description": "Description",
            "thumbnail": {
              "width": 400,
              "height": 400,
              "url": "https://example.com/logo.png"
            }
          }
        ]
      }
    ]
  }
}
```
```

--------------------------------

### GET /api/v1/user/contact

Source: https://docs.saleleads.ai/api-reference/user-profile-data/get-user-contact

Retrieves the contact information for a specified LinkedIn user.

```APIDOC
## GET /api/v1/user/contact

### Description
Retrieves the contact information for a specified LinkedIn user.

### Method
GET

### Endpoint
/api/v1/user/contact

### Parameters
#### Query Parameters
- **username** (string) - Required - The username of the user whose contact information is being requested.

### Request Example
```json
{
  "example": ""
}
```

### Response
#### Success Response (200)
- **success** (boolean) - Indicates if the request was successful.
- **cost** (number) - The cost of the request.
- **data** (object) - Contains the user's contact information.
  - **urn** (string) - User URN.
  - **public_identifier** (string) - User Public Identifier.
  - **first_name** (string) - User First Name.
  - **last_name** (string) - User Last Name.
  - **websites** (array) - User Websites.
  - **email** (string) - User Email.
  - **address** (string) - User Address.
  - **wechat** (string) - User WeChat ID.
  - **phone_numbers** (array) - User Phone Numbers.
  - **twitter** (array) - User Twitter Handles.

#### Response Example
```json
{
  "success": true,
  "cost": 1,
  "data": {
    "urn": "ACoAABjUlV0BZyoygykTrBKGdL4gUCR1i1pFnfQ",
    "public_identifier": "shubhangi-shrivastava-39161bb7",
    "first_name": "Shubhangi",
    "last_name": "Shrivastava",
    "websites": [],
    "email": "",
    "address": "123 Main St, City, Country",
    "wechat": "",
    "phone_numbers": [],
    "twitter": []
  }
}
```

#### Error Response (400)
- **message** (string) - Error message indicating a bad request.

#### Error Response (401)
- **message** (string) - Error message indicating invalid API key.

#### Error Response (403)
- **message** (string) - Error message indicating the user is not subscribed to this API.

#### Error Response (500)
- **success** (boolean) - Indicates if the request was successful.
- **message** (string) - Error message indicating an internal server error.
- **status_code** (number) - The HTTP status code.
- **cost** (number) - The cost of the request.
- **explain** (string) - Explanation of the internal server error.
```

--------------------------------

### POST /websites/saleleads_ai/posts

Source: https://docs.saleleads.ai/api-reference/group/get-group-posts

Creates a new post for the SaleLeads AI website. Supports various post types including articles, celebrations, polls, and events.

```APIDOC
## POST /websites/saleleads_ai/posts

### Description
Creates a new post for the SaleLeads AI website. This endpoint allows for the creation of posts with different content types such as articles, celebrations, polls, and events.

### Method
POST

### Endpoint
/websites/saleleads_ai/posts

### Parameters
#### Request Body
- **post_type** (string) - Required - The type of post to create (e.g., 'article', 'celebration', 'poll', 'event').
- **content** (object) - Required - The content of the post, structured according to the `post_type`.
  - **article**: 
    - **title** (string) - Required - The title of the article.
    - **description** (string) - Optional - A brief description of the article.
    - **image** (object) - Optional - Details for the article's image.
      - **height** (number) - Optional - Logo height.
      - **url** (string) - Optional - Logo URL.
      - **expires_at** (number) - Optional - Logo expires at timestamp.
  - **celebration**: 
    - **url** (string) - Optional - Celebration URL.
    - **title** (string) - Optional - Celebration Title.
    - **tagged** (array) - Optional - List of tagged users.
      - **url** (string) - Optional - Tagged User URL.
      - **first_name** (string) - Optional - Tagged User First Name.
      - **last_name** (string) - Optional - Tagged User Last Name.
      - **public_identifier** (string) - Optional - Tagged User Public Identifier.
      - **urn** (string) - Optional - Tagged User URN.
  - **poll**: 
    - **question** (string) - Required - The question for the poll.
    - **closed** (boolean) - Optional - Poll Closed Status.
    - **duration** (string) - Optional - Poll Duration.
    - **options** (array) - Required - List of poll options.
      - **title** (string) - Required - Poll Option Title.
      - **count** (number) - Optional - Poll Option Count.
  - **event**: 
    - **title** (string) - Required - Event Title.
    - **banner** (array) - Optional - Event banner details.
      - **width** (number) - Optional - Logo width.
      - **height** (number) - Optional - Logo height.

### Request Example
```json
{
  "post_type": "article",
  "content": {
    "article": {
      "title": "New AI Features",
      "description": "Discover the latest advancements in AI.",
      "image": {
        "height": 400,
        "url": "https://media.licdn.com/dms/image/v2/D4E0BAQHjelLY2a-Mnw/company-logo_400_400/company-logo_400_400/0/1666083635765?e=1748476800&v=beta&t=V_T_yXL6Bs2HDEY-iZAKSkNype7_-7USjP2HIXo0Zv8",
        "expires_at": 1748476800000
      }
    }
  }
}
```

### Response
#### Success Response (200)
- **post_id** (string) - The unique identifier for the created post.
- **message** (string) - A confirmation message.

#### Response Example
```json
{
  "post_id": "post_12345",
  "message": "Article post created successfully."
}
```

#### Error Response (400)
- **error** (string) - A message describing the error.

#### Error Response Example
```json
{
  "error": "Invalid post type provided."
}
```
```

--------------------------------

### Get User Honors API Endpoint (OpenAPI)

Source: https://docs.saleleads.ai/api-reference/user-additional-data/get-user-honors

This OpenAPI definition describes the GET /api/v1/user/honors endpoint. It allows fetching a list of honors for a specific LinkedIn user by providing their URN or username. The response includes success status, cost, total honors, pagination information, and a detailed list of honors with their associated data.

```yaml
openapi: 3.1.0
info:
  title: Linkedin Scraper API
  description: Linkedin Scraper API Documentation
  version: 1.0.0
servers:
  - url: https://fresh-linkedin-scraper-api.p.rapidapi.com
    description: RapiAPI
security: []
paths:
  /api/v1/user/honors:
    get:
      tags:
        - User Additional Data
      summary: Get User Honors
      description: >-
        Fetches a list of honors associated with a specific user based on the
        provided user URN.
      operationId: getApiV1UserHonors
      parameters:
        - in: query
          name: urn
          schema:
            type: string
            description: User URN
            example: ACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVffJ3hc
        - in: query
          name: username
          schema:
            type: string
            description: >-
              Username. Enabling this option will consume an additional 1
              request.
            example: simonsinek
        - in: query
          name: page
          schema:
            type: integer
            exclusiveMinimum: 0
            description: Page number for pagination
            default: 1
            example: 1
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  cost:
                    type: number
                    description: Cost of the request
                    example: 1
                  total:
                    type: number
                    description: Total number of user honors
                    example: 12
                  has_more:
                    type: boolean
                    description: Whether there are more user honors to fetch
                    example: false
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        title:
                          type: string
                          description: Title of the honor
                          example: Breakthrough
                        caption:
                          type: string
                          description: Caption of the honor
                          example: Awarded for outstanding performance
                        issued_by:
                          type: string
                          description: Entity that issued the honor
                          example: DigitalOcean
                        issued_at:
                          type: string
                          description: Date the honor was issued
                          example: Jan 2020
                        associated_with:
                          type: string
                          description: Entity associated with the honor
                          example: DigitalOcean
                        media:
                          type: array
                          items:
                            type: object
                            properties:
                              title:
                                type: string
                                description: Title of media
                                example: Title
                              description:
                                type: string
                                description: Description of media
                                example: Description
                              thumbnail:
                                type: object
                                properties:
                                  width:
                                    type: number
                                    description: Logo width
                                    example: 400
                                  height:
                                    type: number
                                    description: Logo height
                                    example: 400
                                  url:
                                    type: string
                                    description: Logo URL
                                    example: >-
                                      https://media.licdn.com/dms/image/v2/D4E0BAQHjelLY2a-Mnw/company-logo_400_400/company-logo_400_400/0/1666083635765?e=1748476800&v=beta&t=V_T_yXL6Bs2HDEY-iZAKSkNype7_-7USjP2HIXo0Zv8
                                  expires_at:
                                    type: number
                                    description: Logo expires at
                                    example: 1748476800000
                    description: List of user honors
        '400':
          description: Bad Request
          content:
            application/json:

```
Tokens:
Raw