proweblook-com Whats App API

openapi: 3.2.0
info:
  title: ProWebLook WhatsApp 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: Whats App
  description: WhatsApp number verification, including lookup-host validation and batch
paths:
  /checkwanumber:
    get:
      summary: Verify WhatsApp Number
      description: Legacy WhatsApp presence check. Does not send a message or OTP. Prefer GET/POST https://lookup.proweblook.com/api/v1/wavalidation for new integrations. Query parameter is `number`, not `mobile`.
      operationId: checkWhatsAppNumber
      tags:
      - Whats App
      parameters:
      - name: number
        in: query
        required: true
        description: Phone number with country calling code. Parameter name is number, not mobile.
        schema:
          type: string
          example: '+1234567890'
      responses:
        '200':
          description: WhatsApp verification result
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WhatsAppCheckResponse'
  /sendwasms:
    get:
      summary: Send WhatsApp Message
      description: Send a WhatsApp message programmatically. Supports text, images, documents, and media files up to 2MB.
      operationId: sendWhatsAppMessage
      tags:
      - Whats App
      parameters:
      - name: number
        in: query
        required: true
        description: Recipient phone number with country code
        schema:
          type: string
          example: '+1234567890'
      - name: message
        in: query
        required: true
        description: Message text to send
        schema:
          type: string
          example: Hello from ProWebLook!
      responses:
        '200':
          description: Message send result
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: boolean
                  message:
                    type: string
  /wavalidation:
    servers:
    - url: https://lookup.proweblook.com/api/v1
      description: Lookup API host
    get:
      summary: WhatsApp Validation
      description: Canonical WhatsApp presence + business detection. Prefer this over /checkwanumber.
      operationId: validateWhatsApp
      tags:
      - Whats App
      externalDocs:
        description: WhatsApp Validation documentation
        url: https://docs.proweblook.com/api-reference/wa-validation
      parameters:
      - name: phone_number
        in: query
        required: true
        schema:
          type: string
          example: '+14155552671'
      - name: country_code
        in: query
        required: false
        description: Optional ISO 3166-1 alpha-2 hint
        schema:
          type: string
          example: US
      responses:
        '200':
          description: WhatsApp validation result
    post:
      summary: WhatsApp Validation
      operationId: validateWhatsAppPost
      tags:
      - Whats App
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - api_key
              - phone_number
              properties:
                api_key:
                  type: string
                phone_number:
                  type: string
                country_code:
                  type: string
      responses:
        '200':
          description: WhatsApp validation result
  /wavalidation/batch:
    servers:
    - url: https://lookup.proweblook.com/api/v1
      description: Lookup API host
    post:
      summary: WhatsApp Batch Submit
      description: Submit up to 1,000 numbers. Credits deducted upfront, one per number. Returns batch_id (HTTP 202).
      operationId: submitWhatsAppBatch
      tags:
      - Whats App
      externalDocs:
        description: WA batch submit
        url: https://docs.proweblook.com/api-reference/wa-batch-submit
      responses:
        '202':
          description: Batch accepted
  /wavalidation/batch/{batch_id}:
    servers:
    - url: https://lookup.proweblook.com/api/v1
      description: Lookup API host
    get:
      summary: WhatsApp Batch Poll
      operationId: pollWhatsAppBatch
      tags:
      - Whats App
      parameters:
      - name: batch_id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Batch status and per-number results
components:
  schemas:
    WhatsAppCheckResponse:
      type: object
      properties:
        balance:
          type: integer
          example: 1003
        status:
          type: boolean
          example: true
        numberstatus:
          type: boolean
          description: Whether the number is registered on WhatsApp
          example: true
        businessnumber:
          type: boolean
          description: Whether the number is a WhatsApp Business account
          example: true
        error:
          type: string
  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/