Yext APIs Overview | Yext Hitchhikers Platform

What You’ll Learn

In this section, you will learn:

• The different Yext APIs
• What is an Endpoint?
• What kind of information can be accessed via API?

Overview

At Yext, we currently offer two different APIs:

1. Management API (including the Agreements endpoints — more on this below)
2. Content Delivery API

Each of these APIs offer different “endpoints”, or information access points, for integrations. Endpoints are the only way you can interact with an API. At Yext, you can think of Analytics and Entity data as two separate endpoints.

We have different APIs for different use cases. The Management API exists for use cases like data transfer between internal systems, and the Content Delivery API exists for consumer facing use cases (mobile apps, websites, chatbots).

Management API

The Management API allows you to add, update, or remove your brand facts across all your business applications. This API is capped at 5,000 requests per hour. Some of the Management API endpoints include:

• Entities - Create, Delete, and Update Entity content across different object types:
  • Location, Event, Healthcare Professional, Healthcare Facility, ATM, Restaurant, Custom Entities, etc.
• Listings - Monitor Entity Listings
• Reviews - Monitor, Respond, and Generate Customer Reviews
• Analytics - Build and Receive Performance Metrics
• Account Settings - Manage Users

Agreements API Endpoints

With the Agreements API endpoints you can grant agents, advisors, or franchisees access to Yext. You can update your Yext account and obtain login tokens programmatically. The Agreements API endpoints are designed for partners and let you manage customer accounts, their subscriptions, and their profile-optimization tasks. To learn more, see the Agreements API documentation .

Examples of common use cases:

• Create and manage customer accounts and subscriptions
• Connect SSO

NOTE: You need a sandbox account to test your Agreements API integration. Contact your Client Success Manager or submit a request using this form and select Developers in the ‘What area of the platform do you need help with?’ section.

Content Delivery API

The Content Delivery API is read-only and allows you to pull your content from the Yext platform to any user-facing applications, such as store locators or mobile apps, in real-time. The Content Delivery API has a much higher rate limit and is capped at 100,000 requests per hour. This is because the Content Delivery API is intended to process a high volume of requests. Some of the Content Delivery API endpoints include:

• Entities - Publish any entity content, grab multiple Entities with addresses near a given geographical point
• Entity Language Profiles - Retrieve a Language Profile for an Entity
• Bios - Publish your people bios
• Products - Publish your products & services lists

Example Use Cases

Let’s walk back through a few of our use cases from the previous unit and talk about which API and which endpoints they would leverage.

Financial Services Client uses Read/Write API to maintain ATM Entity Information in the Yext platform

• Management API (because it needs to be read/write)
• Entities endpoint (because they’re dealing with ATM entities!)

Alien Telecom uses Read API to pull Yext Information into POS (Point of Sale) System

• Content Delivery API (because it is read only, and needs to be called frequently)
• Entities Endpoint (because they’re getting store information)