Developer

Public API

OpenYP listing data is freely accessible via our REST API. No API key required for read operations within reasonable use limits. All responses are JSON. Base URL: https://openyp.com

GET/api/search

Search listings by keyword, category, and location.

Param	Type	Notes
q	string	Search query
city	string	City slug, e.g. new-york-ny
category	string	business \| professional
limit	number	Max results (default 20, max 100)

GET/api/listings/[id]

Fetch a single listing by its unique ID.

Param	Type	Notes
id	string	Listing UUID

Fair Use & Limits

• Unauthenticated requests are subject to rate limiting at our discretion.
• Bulk scraping, indexing for competing directories, or reselling data is prohibited.
• We reserve the right to block access that degrades service for other users.
• The API is provided as-is. OpenYP, LLC makes no uptime guarantees during the beta period.

Need higher limits or commercial access? Reach out — we're open to it.