Generect Linked In API

openapi: 3.2.0
info:
  title: Generect LinkedIn API
  description: 'Welcome to the Generect API documentation. Here we will help you integrate and use our API.


    API base url: `https://api.generect.com` — every path below is relative to this host. Newer endpoints live under `/api/v1/...`, legacy endpoints under `/api/...`; use each path exactly as documented.

    Protocol: `HTTPS`


    # Authentication


    Get your API token from the Generect app settings and send it in the `Authorization` header with the required `Token` prefix.


    Example: `Authorization: Token xxxxxxxxx`


    # Rate limits


    There is no monthly request quota. What you can run is bounded by your account balance and by the parallel-request caps on the Limits page. Pricing depends on the operation and the number of results returned, and may increase with additional data flags. For exact pricing, see each endpoint''s Pricing section or your billing settings: https://app.generect.com/settings/billing


    # Note


    _Every endpoint must include the trailing `/`. Requests without the trailing slash may fail._'
  version: 1.0.0
  contact: {}
servers:
- url: https://api.generect.com
security:
- apiKey: []
tags:
- name: Linked In
paths:
  /api/linkedin/email_finder/:
    post:
      summary: Generate valid email
      description: Generate and validate corporate email addresses using first name, last name, and domain. All generated emails are automatically validated and ready for use - no additional validation required.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: array
              items:
                type: object
                properties:
                  first_name:
                    type: string
                  last_name:
                    type: string
                  domain:
                    type: string
              example:
              - first_name: Jack
                last_name: Kennedy
                domain: platformscience.com
      responses:
        '200':
          description: Successful response with email details
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    first_name:
                      type: string
                    last_name:
                      type: string
                    domain:
                      type: string
                    result:
                      type: string
                    catch_all:
                      type: string
                    error:
                      type:
                      - string
                      - 'null'
                    valid_email:
                      type: string
                    source:
                      type: string
                    email_format:
                      type: string
                    mx_domain:
                      type: string
                    logs:
                      type: string
                    exist:
                      type: string
              example:
              - first_name: Jack
                last_name: Kennedy
                domain: platformscience.com
                result: valid
                catch_all: true
                error: null
                valid_email: jkennedy@platformscience.com
                source: name2email
                email_format: flast
                mx_domain: pphosted.com
                logs: 'get mx_record: pphosted.com

                  check outlook,gmail,onedrive,o365,o365_get_creds

                  '
                exist: 'yes'
      tags:
      - Linked In
      operationId: postApiLinkedinEmailFinder
      x-operation-id-source: derived
  /api/linkedin/email_validator/:
    post:
      summary: Validate an email address
      description: Validate email addresses for deliverability, including catch-all domains, using our proprietary system.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: array
              items:
                type: string
              example:
              - jkennedy@platformscience.com
      responses:
        '200':
          description: Successful email validation
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    result:
                      type: string
                    catch_all:
                      type: string
                    error:
                      type:
                      - string
                      - 'null'
                    source:
                      type: string
                    mx_domain:
                      type: string
                    exist:
                      type: string
                    email:
                      type: string
                    logs:
                      type: array
                      items:
                        type: string
              example:
              - result: valid
                catch_all: true
                error: null
                source: name2email
                mx_domain: pphosted.com
                exist: 'yes'
                email: jkennedy@platformscience.com
                logs:
                - get mx_record: pphosted.com
                - check outlook,gmail,onedrive,o365,o365_get_creds
      tags:
      - Linked In
      operationId: postApiLinkedinEmailValidator
      x-operation-id-source: derived
components:
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: Authorization
      description: 'Use the required Token prefix. Example: Authorization: Token xxxxxxxxx'