proweblook-com IP API

openapi: 3.2.0
info:
  title: ProWebLook IP 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: Ip
  description: IP address geolocation
paths:
  /:
    servers:
    - url: https://ipapi.proweblook.com
      description: Primary edge IP API server
    get:
      summary: Check GEO IP
      description: Retrieve geolocation, ISP, organization, ASN, and timezone details for an IPv4 or IPv6 address from the primary edge IP API endpoint.
      operationId: checkGeoIP
      tags:
      - Ip
      externalDocs:
        description: Check GEO IP API documentation
        url: https://docs.proweblook.com/api-reference/check-geo-ip
      parameters:
      - name: ip
        in: query
        required: true
        description: 'The IP address (IPv4 or IPv6) to look up. Example: 8.8.8.8'
        schema:
          type: string
          example: 8.8.8.8
      responses:
        '200':
          description: Geolocation data
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GeoIPResponse'
        '400':
          description: Missing or invalid IP address
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Missing or invalid API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /checkgeoip:
    get:
      summary: Compatible GEO IP Lookup
      description: Compatible path for existing Geo IP integrations. New integrations should use GET https://ipapi.proweblook.com/?ip=8.8.8.8&api_key=YOUR_API_KEY.
      operationId: checkGeoIPCompatible
      tags:
      - Ip
      servers:
      - url: https://ipapi.proweblook.com/api/v1
        description: Compatible edge IP API path
      - url: https://proweblook.com/api/v1
        description: Legacy fallback API path
      externalDocs:
        description: Check GEO IP API documentation
        url: https://docs.proweblook.com/api-reference/check-geo-ip
      parameters:
      - name: ip
        in: query
        required: true
        description: 'The IP address (IPv4 or IPv6) to look up. Example: 8.8.8.8'
        schema:
          type: string
          example: 8.8.8.8
      responses:
        '200':
          description: Geolocation data
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GeoIPResponse'
components:
  schemas:
    GeoIPResponse:
      type: object
      properties:
        status:
          type: boolean
          description: true if the IP was successfully resolved, otherwise false.
          example: true
        ip:
          type: string
          example: 8.8.8.8
        range:
          type: array
          description: Latitude/longitude pair returned by the edge API.
          items:
            type: number
          example:
          - 37.751
          - -97.822
        country:
          type: string
          description: Two-letter ISO country code.
          example: US
        country_name:
          type: string
          description: Full country name.
          example: United States
        region:
          type:
          - string
          - 'null'
          description: State or region name.
          example: null
        region_iso:
          type:
          - string
          - 'null'
          description: Region ISO code, when available.
          example: null
        city:
          type:
          - string
          - 'null'
          description: City name, when available.
          example: null
        postal_code:
          type:
          - string
          - 'null'
          description: Postal or ZIP code, when available.
          example: null
        isp:
          type: string
          description: Internet Service Provider name.
          example: Level 3 Communications
        organization:
          type: string
          description: Organization associated with the IP address.
          example: Google
        latitude:
          type: number
          example: 37.751
        longitude:
          type: number
          example: -97.822
        asn:
          type: integer
          description: Autonomous System Number.
          example: 15169
        asn_organization:
          type: string
          description: Organization associated with the ASN.
          example: GOOGLE
        timezone:
          type: string
          description: Timezone of the IP location.
          example: America/Chicago
    ErrorResponse:
      type: object
      properties:
        status:
          type: boolean
          example: false
        error:
          type: string
          example: Invalid API key
  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/