REST API

Meridian has developed a new REST API that uses a consistent underlying structure. The original API is still available.

Only documented APIs are supported. Undocumented APIs are unsupported and subject to change.

The API Structure

The new API structure is consistent, regardless of the resource you're accessing and the method you're using.

https://edit.meridianapps.com/api/{resource1}/{unique id1}/{resource2}/{unique id2}

API Example

For example, if you wanted to get data on a specific campaign for a location, you'd use:

https://edit.meridianapps.com/api/locations/{app_id}/placemarks/{placemark_id}

or

https://edit.meridianapps.com/api/locations/12345678901234/placemarks/987654321987

Get a List of Items

Requesting data from an endpoint without a specific ID will return a paged list of items. By default, the list is limited to 100 items.

https://edit.meridianapps.com/api/locations/{app_id}/placemarks

Get the Next Page of Items

If the list of items is greater than the page limit, the API will provide a URL to the next list page:

https://edit.meridianapps.com/api/locations/12345678901234/placemarks?page={next page ID}