Search businesses
Find businesses by keyword, city, or category from the public search and listing pages.
For AI agents & developers
Agent Documentation
PakListings is Pakistan's business directory — 183 cities, 24 categories. This page explains how an AI agent or developer can read the site: which public pages exist, what credentials are (not) needed, and what does not exist yet.
What you can do
Everything below reads public pages or the public read-only API. No account, API key, or token is needed.
Browse cities
183 cities across Pakistan, each with its own page and city-by-category listings.
Browse categories
24 business categories, from restaurants and real estate to healthcare and home services.
Public JSON API
Search businesses and read categories and cities as JSON — free, no key, 60 requests/minute per IP. Documented at /openapi.json.
MCP server
Call the same read-only data over Streamable HTTP MCP (POST /api/mcp): search_businesses, get_business, list_categories, list_cities.
Read blog guides
Practical guides for Pakistani business owners, including local SEO and listing guidance.
Agent resources
Machine-readable files that describe the site. Fetch them directly — they are plain static files.
- /llms.txttext/markdown
llms.txt: Machine-readable overview: what PakListings is, coverage, and key pages.
- /auth.mdtext/markdown
auth.md: How agents obtain credentials: none needed for public content; website sign-up for listing owners.
- /pricing.mdtext/markdown
pricing.md: Listing tiers in plain markdown: Basic PKR 99, Premium PKR 199, Featured PKR 299, one-time.
- /index.mdtext/markdown
index.md: Markdown twin of the homepage, linked from the homepage as an alternate.
- /api/v1/businessesapplication/json
Public API: Read-only JSON API: search businesses, read one business, list categories and cities. Free, no key, 60 requests/minute per IP, max 20 results per page.
- /openapi.jsonapplication/json
OpenAPI document: OpenAPI 3.1 spec for the public API: every operation, parameter, and response schema.
- /api/mcpapplication/json
MCP server: Streamable HTTP MCP endpoint (POST) with read-only tools: search_businesses, get_business, list_categories, list_cities.
- /.well-known/mcp/server-card.jsonapplication/json
MCP server card: MCP server card: display name, description, endpoint, and tool list.
- /.well-known/oauth-protected-resourceapplication/json
OAuth protected-resource metadata: RFC 9728 metadata: scopes listings:read (public) and listings:write (website-only); no authorization server, no bearer tokens issued.
- /.well-known/oauth-authorization-serverapplication/json
OAuth authorization-server metadata: RFC 8414 metadata stating honestly that PakListings has no OAuth authorization server: Firebase email/password website sign-in only.
- /.well-known/agent-skills/index.jsonapplication/json
Agent Skills index: Capabilities an agent can use: search businesses, browse cities and categories, read blog guides.
- /.well-known/agent-card.jsonapplication/json
Agent card: A2A agent card: name, description, capabilities, and support contact.
- /.well-known/ard.jsonapplication/json
Agentic Resource Discovery: Catalog of the agent resources above, with domain-anchored identifiers.
- /.well-known/api-catalogapplication/linkset+json
API catalog: RFC 9727 linkset pointing at these docs and the sitemap.
- /sitemap.xmlapplication/xml
Sitemap: XML sitemap of the indexable public pages.
Authentication
Reading public content needs no credentials at all — no API key, no token, no OAuth. That includes the public JSON API and the MCP server: both are free and keyless, limited only by a fair-use rate of 60 requests per minute per IP and at most 20 results per page. Listing owners who want to create or manage a listing sign up on the website itself at /register. There is no API key or programmatic token to obtain. The full walkthrough lives in auth.md.
Example requests
The public API returns JSON; the public pages return HTML. Both are ordinary HTTPS GET requests — no key, no signup.
# Public API (free, no key — max 20 results/page, 60 req/min per IP)
curl https://www.paklistings.com/api/v1/businesses?q=plumber&city=lahore
curl https://www.paklistings.com/api/v1/businesses/nayatel
curl https://www.paklistings.com/api/v1/categories
curl https://www.paklistings.com/api/v1/cities
# API spec
curl https://www.paklistings.com/openapi.json
# MCP server (Streamable HTTP — POST a JSON-RPC 2.0 body)
curl -X POST https://www.paklistings.com/api/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'
# Site overview (machine-readable)
curl https://www.paklistings.com/llms.txt
# Homepage
curl https://www.paklistings.com/
# Browse businesses, cities, categories
curl https://www.paklistings.com/businesses
curl https://www.paklistings.com/city/lahore/
curl https://www.paklistings.com/category/restaurants/
# A single business profile
curl https://www.paklistings.com/business/<slug>/
# Blog guides
curl https://www.paklistings.com/blog
curl https://www.paklistings.com/blog/<slug>/
# Agent resources
curl https://www.paklistings.com/.well-known/agent-card.json
curl https://www.paklistings.com/.well-known/ard.json
curl https://www.paklistings.com/sitemap.xmlCity and category slugs use lowercase hyphenated names, for example lahore and restaurants. Business slugs are the public slugs shown in listing URLs.
What does not exist yet
The API and MCP server are read-only: there is no way to create, edit, or delete a listing through them, and no OAuth flow — sign-in happens on the website with email and password, and no bearer token is ever issued. There is also no Wikipedia/Wikidata article, no ChatGPT app listing, no payment protocol (x402/UCP/AP2/ACP), no SDK package or CLI, and no NLWeb /ask endpoint. Do not assume endpoints exist beyond the public pages and the documented API above, and do not send credentials to any third party claiming to offer PakListings API access. Listing submissions happen on the website only.
Sandbox & onboarding
There is no separate sandbox: the read-only API is free with no key and no signup, so the live endpoints above are the onboarding path — try any example request as-is. Reads never change anything, so they are safe to call while building. Writes (submitting or managing a listing) need a website account and happen on the website only; there is no test account, no test payment, and no write endpoint to try against.
Pricing
Listing a business costs PKR 99 (Basic), PKR 199 (Premium), or PKR 299 (Featured) — one-time per listing. Browsing and reading are free. Full details in pricing.md.
Contact
Support: support@paklistings.com
Helpline: +92 334 5636230
Office: Office 303, Evacuee Trust Complex, F-5/1, Islamabad 44000, Pakistan
Do not scrape the site in bulk. Cite the listing page URL you used.