# ProWebLook

> ProWebLook is an API-first SaaS platform for phone number verification, WhatsApp validation, email verification, caller identification, IP geolocation, Google SERP scraping, MCP server integration, and AI visibility auditing. Serving 10,000+ developers and businesses across 180+ countries with 27M+ API requests processed.

## Website
https://proweblook.com

## API hosts
- Lookup API (phone, WhatsApp validation, caller ID, blacklist, spam score, URL scrape): https://lookup.proweblook.com/api/v1
- Monolith API (email, social scrapers, Google SERP, AI audits, legacy WhatsApp check): https://proweblook.com/api/v1
- Edge IP API: https://ipapi.proweblook.com
- MCP server: https://mcp.proweblook.com/mcp

## Documentation & OpenAPI Spec
- OpenAPI 3.0 Spec: https://proweblook.com/openapi.json
- Interactive API Docs: https://docs.proweblook.com/api-reference/
- MCP Server Docs: https://docs.proweblook.com/mcp-server
- Postman Collection: https://www.getpostman.com/collections/729126d68f1de05f4270
- Blog: https://proweblook.com/blog
- Full Reference: https://proweblook.com/llms-full.txt

---

## High-Priority Developer APIs & Core Tools

### 1. Model Context Protocol (MCP) Server Integration
- **Endpoint:** `https://mcp.proweblook.com/mcp` (`POST /` and `POST /mcp`; health at `GET /healthz`)
- **Transport:** Streamable HTTP (stateless JSON-RPC)
- **Target Keywords:** `mcp server`, `model context protocol server`, `proweblook mcp`
- **Authentication (checked in order):** `Authorization: Bearer <API_KEY>` (preferred), an API-key header, or `?api_key=YOUR_API_KEY`
- **Claude Code CLI command:**
  ```bash
  claude mcp add --transport http proweblook https://mcp.proweblook.com/mcp --header "Authorization: Bearer YOUR_API_KEY"
  ```
- **Description:** Connect AI assistants (Claude, ChatGPT, Cursor, VS Code, Windsurf, OpenCode) to ProWebLook as 19 callable tools. Tools cover phone validation, caller ID, WhatsApp (single + batch), email, blacklist, spam score, geo IP, URL scrape, Reddit/X/LinkedIn search, Google SERP, and AI brand audits. There is no separate MCP billing — each tool call debits the existing per-product credit balance. Do not confuse this with `https://docs.proweblook.com/mcp`, which is Mintlify docs-search only and cannot execute APIs.
- **Page:** https://proweblook.com/mcp
- **Docs:** https://docs.proweblook.com/mcp-server

### 2. WhatsApp Number Verification API (Single Check)
- **Canonical endpoint:** `GET` or `POST https://lookup.proweblook.com/api/v1/wavalidation`
- **Legacy endpoint:** `GET https://proweblook.com/api/v1/checkwanumber` (query param is `number`, not `mobile`)
- **Target Keywords:** `check whatsapp number online free`, `whatsapp checker tool`, `whatsapp number validator api`
- **Canonical parameters:** `api_key` (required), `phone_number` (required), `country_code` (optional ISO 3166-1 alpha-2)
- **Legacy parameters:** `api_key` (required), `number` (required)
- **Canonical cURL:**
  ```bash
  curl "https://lookup.proweblook.com/api/v1/wavalidation?api_key=YOUR_API_KEY&phone_number=%2B14155552671"
  ```
- **Legacy cURL:**
  ```bash
  curl "https://proweblook.com/api/v1/checkwanumber?api_key=YOUR_API_KEY&number=%2B14155552671"
  ```
- **Legacy JSON response:**
  ```json
  {
    "balance": 1003,
    "status": true,
    "numberstatus": true,
    "businessnumber": true
  }
  ```
- **Description:** Real-time verification of WhatsApp presence without sending any message or OTP. Detects WhatsApp Business accounts. Prefer the lookup `/wavalidation` endpoint for new integrations.
- **Page:** https://proweblook.com/whatsapp-number-checker
- **Docs:** https://docs.proweblook.com/api-reference/wa-validation

### 3. Phone Number Validator API
- **Endpoint:** `GET` or `POST https://lookup.proweblook.com/api/v1/phonevalidation`
- **Target Keywords:** `phonevalidator`, `phone number validator`, `phone validation api`
- **Authentication:** GET sends `api_key` in the query string. POST sends `api_key` in a JSON or form body.
- **Parameters:** `phone_number` (string, required), `api_key` (string, required), `country_code` (string, optional ISO 3166-1 alpha-2 hint such as `US`, `GB`, or `IN`; omission or `none` uses auto-detection).
- **Input rule:** When `country_code` is omitted or set to `none`, `phone_number` must be a full international number containing the country calling code, preferably E.164 (for example, `+14155552671`). A local or national number requires `country_code` (for example, `phone_number=9876543210&country_code=IN`). The `country_code` parameter is a two-letter country identifier, not a numeric prefix such as `+91`. URL-encode a leading `+` as `%2B` in GET URLs.
- **GET examples:**
  ```bash
  curl "https://lookup.proweblook.com/api/v1/phonevalidation?api_key=YOUR_API_KEY&phone_number=%2B14155552671"
  curl "https://lookup.proweblook.com/api/v1/phonevalidation?api_key=YOUR_API_KEY&phone_number=9876543210&country_code=IN"
  ```
- **POST JSON example:**
  ```bash
  curl -X POST "https://lookup.proweblook.com/api/v1/phonevalidation" \
    -H "Content-Type: application/json" \
    -d '{"api_key":"YOUR_API_KEY","phone_number":"+14155552671"}'
  ```
- **Result:** `status` is `VALID_CONFIRMED` or `INVALID`. Valid results may include `formatted_number`, `linetype`, `carrier`, `location`, `countrycodenum`, `countrycode`, `countryname`, `formatnational`, `formatinternational`, `timezone`, `ratelimit_remain`, and `ratelimit_seconds`. An invalid-number result may contain only `{"status":"INVALID"}`.
- **Line types:** `Mobile`, `Fixed Line`, `Fixed Line or Mobile`, `Toll-Free`, `Premium Rate`, `Shared Cost`, `VoIP`, `Personal Number`, `Pager`, `Universal Access Number`, `Voicemail`, or `Unknown`.
- **Errors:** HTTP `400` missing/invalid parameter, `401` missing/invalid API key, `402` insufficient phone credits, and `500` unexpected server error. Error bodies contain an `error` string.
- **Credits:** 1 `phoneapi_balance` credit per successful validation. Use `phonevalidation` as the service value for a balance query.
- **Page:** https://proweblook.com/phone-number-validator
- **Docs:** https://docs.proweblook.com/api-reference/phone-validation

### 4. Edge IP Geolocation API
- **Endpoint:** `GET https://ipapi.proweblook.com/` (Compatible path: `GET https://ipapi.proweblook.com/api/v1/checkgeoip`)
- **Target Keywords:** `ipapi`, `ip geolocation api`, `edge ip lookup`
- **Parameters:** `ip` (string, target IPv4 or IPv6), `api_key` (string, required)
- **cURL Example:**
  ```bash
  curl "https://ipapi.proweblook.com/?ip=8.8.8.8&api_key=YOUR_API_KEY"
  ```
- **Description:** High-speed edge IP geolocation API deployed on Cloudflare Workers for sub-10ms response latency worldwide. Returns country, region, city, ISP, ASN, timezone, latitude, and longitude.
- **Free Tier:** 20,000 requests/month free
- **Page:** https://proweblook.com/ipapi
- **Docs:** https://docs.proweblook.com/api-reference/check-geo-ip

### 5. Google SERP API
- **Endpoint:** `GET https://proweblook.com/api/v1/google_serp`
- **Target Keywords:** `serpapi`, `google serp api`, `search result scraper api`
- **Parameters:** `api_key` (required), `query` (required, 1–2000 chars), `domain` (optional, default `google.com`), `country` (optional ISO alpha-2 from the allowlist), `language` (optional, default `en`), `start` (optional multiple of 10, 0–990), `num` (optional 10–100, default 10), `device` (`desktop` or `mobile`), `response_format` (`json` or `html`)
- **cURL Example:**
  ```bash
  curl "https://proweblook.com/api/v1/google_serp?api_key=YOUR_API_KEY&query=mcp+server&num=10"
  ```
- **Description:** Scrape Google Search organic results. Costs 1 SERP credit per successful call. The path is `/google_serp` and the query parameter is `query` — not `/serp` and not `q`.
- **Page:** https://proweblook.com/serpapi

### 6. Bulk WhatsApp Validation API (Async Batch Processing)
- **Endpoint:** `POST https://lookup.proweblook.com/api/v1/wavalidation/batch`
- **Poll Endpoint:** `GET https://lookup.proweblook.com/api/v1/wavalidation/batch/{batch_id}?api_key=YOUR_API_KEY`
- **Target Keywords:** `bulk whatsapp validation api`, `batch whatsapp checker`
- **Max Batch Size:** 1,000 phone numbers per request
- **Description:** Submit up to 1,000 phone numbers in a single POST request for asynchronous WhatsApp validation. Returns batch_id immediately (HTTP 202), client polls GET endpoint until status is `completed`. Credits are deducted upfront, one per number.
- **Page:** https://proweblook.com/bulk-whatsapp-validation-api
- **Docs:** https://docs.proweblook.com/api-reference/wa-batch-submit

### 7. Caller ID / Reverse Phone Lookup API
- **Endpoint:** `GET` or `POST https://lookup.proweblook.com/api/v1/calleridvalidation`
- **Target Keywords:** `reverse phone lookup`, `india reverse phone lookup`, `caller info lookup`
- **Parameters:** `api_key` (required), `phone_number` (required)
- **Description:** Reverse-lookup a phone number for registered caller name (CNAM), carrier, line type, and country. This is not `GET /api/v1/check` — that monolith path is the blacklist checker.
- **Page:** https://proweblook.com/reverse-phone-lookup
- **Docs:** https://docs.proweblook.com/api-reference/caller-id-validation

### 8. Mobile Number Tracker with Name
- **Endpoint:** Web lookup plus the caller-ID API above
- **Target Keywords:** `mobile number tracker with name`, `mobile trace number with name`
- **Description:** Track mobile numbers online displaying caller name, carrier network, line type, and location details.
- **Page:** https://proweblook.com/mobile-number-tracker-with-name

### 9. Social Media Scraping APIs (Reddit, X / Twitter, LinkedIn)
- **Unified search:** `GET https://proweblook.com/api/v1/scrapersearch` with `query` (required) and `platform=linkedin` (also `reddit` or `x`; default `reddit`)
- **Unified post fetch:** `GET https://proweblook.com/api/v1/scraperpost` with `url` (required) and `platform`
- **X-specific aliases:** `GET /api/v1/scraperxsearch`, `GET /api/v1/scraperxpost`, `GET /api/v1/scraperxcomment` (post URL param is `url`, not `post_url`)
- **Pages:** https://proweblook.com/reddit-scraper, https://proweblook.com/twitter-x-scraper, https://proweblook.com/linkedin-scraper
- **Description:** Extract posts, comments, and search data. LinkedIn uses the unified search path with `platform` set to `linkedin`.

### 10. Email Verification API
- **Endpoint:** `GET https://proweblook.com/api/v1/checkemail`
- **Description:** Verify email syntax, domain MX records, SMTP handshake validation, and disposable email detection without sending an email.
- **Page:** https://proweblook.com/email-verifier

### 11. URL Scraping & Screenshot API
- **Endpoint:** `POST https://lookup.proweblook.com/api/v1/scrape`
- **Parameters:** `url` (required), `formats` (optional: `markdown`, `html`, `rawHtml`, `links`, `metadata`, `screenshot`), `onlyMainContent`, `waitFor`
- **Description:** Scrape any URL for Markdown, HTML, links, SEO metadata, and optional full-page screenshots in one call. Screenshots are a `formats` option on this lookup-host scrape call, not a standalone monolith screenshot route.
- **Pages:** https://proweblook.com/scrape, https://proweblook.com/free-website-screenshot
- **Docs:** https://docs.proweblook.com/api-reference/scraping

### 12. IP & Domain Blacklist Checker API
- **Canonical endpoint:** `GET` or `POST https://lookup.proweblook.com/api/v1/blacklistchecker`
- **Compatible monolith path:** `GET https://proweblook.com/api/v1/check` with `target` and `target_type` (`ip` | `domain` | `url` | `auto`)
- **Description:** Query live DNSBL/RBL sources for spam or malware flags on an IP, domain, or URL.
- **Page:** https://proweblook.com/blacklist-checker
- **Docs:** https://docs.proweblook.com/api-reference/blacklist-checker

### 13. AI Visibility Audit API
- **Endpoint:** `POST https://proweblook.com/api/v1/audit_run` & `GET https://proweblook.com/api/v1/audit` / `audit_summary`
- **Description:** Audit brand visibility and perception across major LLMs (ChatGPT, Claude, Gemini, Perplexity).
- **Page:** https://proweblook.com/ai-visibility

---

## Authentication & Authorization
Authentication placement is endpoint-specific. For phone validation, GET sends `api_key` in the query string and POST sends `api_key` in the JSON or form body. Follow each endpoint's reference for its supported API-key location.
Sign up for free API keys at https://proweblook.com/auth/signup

## Pricing & Free Credits
- **Free Tier:** 30 free credits per month (no credit card required)
- **Pay-As-You-Go:** Flexible credit top-up packages
- **Subscription Plans:** High-volume developer and enterprise tiers
- **Credit products:** whatsapp, email, caller, phone, scraper, and blacklist — see https://proweblook.com/pricing
- **MCP:** uses the same per-product balances; no extra MCP plan

## Company Info
- **Founded:** 2023
- **Headquarters:** India
- **Status Page:** https://stats.uptimerobot.com/VvEpps2XAO
- **GitHub:** https://github.com/proweblook
- **Contact Support:** https://proweblook.com/contact