proweblook-com Email API

openapi: 3.2.0
info:
  title: ProWebLook Email API
  description: ProWebLook APIs for WhatsApp verification, phone validation, email verification, caller identification, IP geolocation, blacklist checking, social scraping, Google SERP, and AI visibility audits. Phone, WhatsApp validation, caller ID, blacklist, spam, email validation, and URL scrape live on lookup.proweblook.com; social scrapers, SERP, and audits live on proweblook.com. Authentication placement is endpoint-specific; consult each operation for its required API-key location. New accounts receive 50 one-time free credits for each of WhatsApp verification, phone validation, caller ID, email verification, social scrapers (shared across Reddit, X, and LinkedIn), blacklist checking, Google SERP, AI visibility audits, spam checking, and URL scraping/screenshots. Granted once per account, never expires, and never renews. GeoIP remains 20,000 free requests per month with no extra 50-credit signup grant. Anonymous SERP playground requests remain limited to 10 per day and are separate from account credits.
  version: 1.0.0
  contact:
    name: ProWebLook Support
    url: https://proweblook.com/contact
    email: support@proweblook.com
  termsOfService: https://proweblook.com/generic/terms_conditions
  x-logo:
    url: https://proweblook.com/upload/logo.png
servers:
- url: https://proweblook.com/api/v1
  description: Production API server
security:
- apiKey: []
tags:
- name: Email
  description: Email address verification
paths:
  /emailvalidation:
    servers:
    - url: https://lookup.proweblook.com/api/v1
      description: Lookup API host
    get:
      summary: Email Verification
      description: Verify email format and mailbox deliverability in real time without sending an email. Supported on lookup.proweblook.com with GET and POST methods. Returns deliverability signals including mailbox existence, verdict, and reason codes.
      operationId: verifyEmailLookup
      tags:
      - Email
      externalDocs:
        description: Email Verification documentation
        url: https://docs.proweblook.com/api-reference/email-verification
      parameters:
      - name: email
        in: query
        required: true
        description: Address to verify. Invalid syntax returns a completed invalid_format result and consumes one email credit.
        schema:
          type: string
          example: user@example.com
      responses:
        '200':
          description: Completed verification or application-level error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EmailCheckResponse'
              examples:
                completed:
                  summary: Completed deliverable check
                  value:
                    balance: 9992
                    status: true
                    email: user@example.com
                    emailformat: true
                    emailexist: true
                    verdict: deliverable
                    reason_code: mailbox_accepted
                refunded:
                  summary: Provider timeout refund
                  value:
                    balance: 9990
                    status: false
                    error: Service temporarily unavailable, please try again.
                    reason_code: network_timeout
        '401':
          description: Invalid API key
        '402':
          description: Insufficient email credits
  /checkemail:
    get:
      summary: Verify Email Address
      description: Legacy monolith path for email format and mailbox deliverability. Prefer GET https://lookup.proweblook.com/api/v1/emailvalidation for new integrations. A completed result uses status=true and consumes one email credit, including invalid syntax or an undeliverable address. Provider, configuration, or inconclusive lookup failures use status=false with error and reason_code; the reserved credit is refunded to its original pool row. If restoration fails, reason_code is credit_refund_pending. Responses use HTTP 200 for completed checks and application-level errors.
      operationId: verifyEmail
      tags:
      - Email
      parameters:
      - name: email
        in: query
        required: true
        description: Address to verify. Invalid syntax returns a completed invalid_format result and consumes one email credit.
        schema:
          type: string
          example: user@example.com
      responses:
        '200':
          description: Completed verification or application-level error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EmailCheckResponse'
              examples:
                completed:
                  summary: Completed deliverable check
                  value:
                    balance: 99
                    status: true
                    email: user@example.com
                    emailformat: true
                    emailexist: true
                    verdict: deliverable
                    reason_code: mailbox_accepted
                lookupFailure:
                  summary: Lookup failed; reserved credit restored
                  value:
                    balance: 100
                    status: false
                    error: Service temporarily unavailable, please try again.
                    reason_code: network_timeout
  /checkemailcron:
    get:
      summary: Verify Email Address (Cron-Compatible)
      description: Compatibility path with the same query parameters, response, and email-credit reservation and refund behavior as GET /checkemail.
      operationId: verifyEmailCronCompatible
      tags:
      - Email
      parameters:
      - name: email
        in: query
        required: true
        description: Address to verify. Invalid syntax returns a completed invalid_format result and consumes one email credit.
        schema:
          type: string
          example: user@example.com
      responses:
        '200':
          description: Completed verification or application-level error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EmailCheckResponse'
components:
  schemas:
    EmailCheckResponse:
      type: object
      required:
      - status
      properties:
        balance:
          type: integer
          description: Current remaining email credits after the check or refund attempt. Omitted when API authentication fails.
          example: 99
        status:
          type: boolean
          description: True for a completed check, including an invalid address; false for authentication, credit, or lookup failure.
          example: true
        email:
          type: string
          description: Checked address; present on completed checks.
          example: user@example.com
        emailformat:
          type: boolean
          description: Whether the address has valid syntax; present on completed checks.
          example: true
        emailexist:
          type: boolean
          description: True for deliverable or catch-all results; present on completed checks.
          example: true
        verdict:
          type: string
          description: 'Completed check verdict: deliverable, undeliverable, unknown (catch-all), or invalid_format.'
          example: deliverable
        reason_code:
          type: string
          description: Lookup reason on completed checks or lookup failures; credit_refund_pending means restoration could not complete. Omitted for authentication or insufficient-credit errors.
          example: mailbox_accepted
        error:
          type: string
          description: Human-readable error when status is false.
          example: Service temporarily unavailable, please try again.
  securitySchemes:
    apiKey:
      type: apiKey
      in: query
      name: api_key
      description: Your ProWebLook API key. Get a free key at https://proweblook.com/auth/signup
externalDocs:
  description: ProWebLook Documentation
  url: https://docs.proweblook.com/api-reference/