proweblook-com Security API

openapi: 3.2.0
info:
  title: ProWebLook Security 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: Security
  description: Blacklist and spam scoring
paths:
  /check:
    get:
      summary: Blacklist Checker (monolith compatible path)
      description: Check an IP, domain, or URL against DNSBL/spam sources. Canonical lookup host path is GET/POST https://lookup.proweblook.com/api/v1/blacklistchecker. This monolith path is not caller ID; caller ID is GET/POST https://lookup.proweblook.com/api/v1/calleridvalidation.
      operationId: checkBlacklistMonolith
      tags:
      - Security
      externalDocs:
        description: Blacklist Checker documentation
        url: https://docs.proweblook.com/api-reference/blacklist-checker
      parameters:
      - name: target
        in: query
        required: true
        description: IP address, domain, or URL to check
        schema:
          type: string
          example: proweblook.com
      - name: target_type
        in: query
        required: true
        description: ip, domain, url, or auto
        schema:
          type: string
          enum:
          - ip
          - domain
          - url
          - auto
          example: auto
      - name: sources
        in: query
        required: false
        description: Optional comma-separated source list. All sources when omitted.
        schema:
          type: string
      responses:
        '200':
          description: Blacklist check result
        '400':
          description: Missing or invalid target / target_type
        '401':
          description: Invalid API key
        '402':
          description: Insufficient blacklist credits
  /blacklistchecker:
    servers:
    - url: https://lookup.proweblook.com/api/v1
      description: Lookup API host
    get:
      summary: Blacklist Checker
      description: Canonical blacklist endpoint on the lookup host.
      operationId: checkBlacklist
      tags:
      - Security
      externalDocs:
        description: Blacklist Checker documentation
        url: https://docs.proweblook.com/api-reference/blacklist-checker
      parameters:
      - name: target
        in: query
        required: true
        schema:
          type: string
          example: proweblook.com
      - name: target_type
        in: query
        required: true
        schema:
          type: string
          enum:
          - ip
          - domain
          - url
          - auto
          example: auto
      responses:
        '200':
          description: Blacklist check result
  /spamchecker:
    servers:
    - url: https://lookup.proweblook.com/api/v1
      description: Lookup API host
    post:
      summary: Spam Checker
      description: Score email subject/body 0-100 for spam triggers. At least one of subject or content is required.
      operationId: checkSpam
      tags:
      - Security
      externalDocs:
        description: Spam Checker documentation
        url: https://docs.proweblook.com/api-reference/spam-checker
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                api_key:
                  type: string
                subject:
                  type: string
                content:
                  type: string
      responses:
        '200':
          description: Spam score result
components:
  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/