Contents

Changelog

REMOVAL
Effective from:

March 31, 2021

Removal of the /*/find, /searchResults, and /searchResults/field endpoints, replaced by 6 new endpoints

Announced: April 8, 2020

Effective from:
March 31, 2021

Removal of the /*/find, /searchResults, and /searchResults/field endpoints, replaced by 6 new endpoints

What will change?

We have now deprecated and will soon be removing the following 6 API endpoints:

We strongly advise you to avoid the use of these 6 deprecated API endpoints.

Why?

We are introducing 6 new endpoints:

The new Search API endpoints offer extended functionality over the old search API and have a unified future-proof response format. The extended functionality allows you to do complicated queries from several item types and fields at once.

For example you can use /v1/itemSearch?item_types=deal,person&fields=title,name,custom_fields&term=example to search from all persons and deals by the person’s name, deal title and both items custom fields and order them by relevance.

The /*/search endpoints are aliases for /v1/itemSearch?item_types=* endpoint with narrower OAuth2 scopes for if you are a marketplace app owner and would like your app to only have read access to specific item types instead of the full search scope.

Who is affected?

Anyone depending on the previously listed 6 deprecated endpoints in any way is affected. In case you are using the previously listed 6 deprecated API endpoints in your code or 3rd party app/integration, please remove any dependency on these endpoints as soon as possible, or by March 31, 2021 the latest. For additional help, check out new search API migration guide.

Published on April 8, 2020

Subscribe to our
Changelog

You may unsubscribe anytime using the unsubscribe link in our emails. For more information, please see our privacy notice.

Subscribe to our
Changelog

You may unsubscribe anytime using the unsubscribe link in our emails. For more information, please see our privacy notice.