Documentation Disclaimer

🚧

Please read before using this documentation

This documentation is not exhaustive. It does not constitute a complete specification of the Yelp Ads API's functionality, limitations, error states, or business rules. Integrators are responsible for testing their implementations against actual API responses and should not rely solely on this documentation as a guarantee of system behavior. In the event of any conflict between this documentation and the terms of your API agreement, the agreement controls.

What this documentation covers

These pages document known behavioral patterns, non-obvious edge cases, and integration guidance for the Yelp Ads API. The content is maintained by Yelp's Solutions Engineering team and draws from internal engineering documentation, partner support escalations, and observed API behavior.

What this documentation does not cover

• All possible error states or edge cases
• Internal platform behavior that may change without notice
• Guarantees of uptime, response time, or data freshness
• Billing disputes or contractual obligations

Questions and discrepancies

If you observe behavior that conflicts with what is documented here, or encounter an undocumented error state, contact [email protected].

For billing disputes or questions about your API agreement, contact your Yelp account team.