API to push custom content to Findify


The Content API allows a client to push and then search content-based documents (articles, pictures, videos, etc).

A document can be:

  • a category page
  • an article from a blog
  • the content of a web page (e.g. FAQ, Sizing Charts, etc)
  • an Instagram post
  • a Youtube video
  • any content that has been generated by the user (UGC = User Generated Content)

Content API

The content search feature is composed of two main components:

  • The content API that allows a client to add, modify, or delete documents. This API is available under the domain push.findify.io.
  • The content search API that lets the client search into their content index. This API has a different endpoint and is available under the domain api-v3.findify.io.

When an operation has been submitted to the content API (addition/modification/deletion), it will take maximum five minutes for the system to propagate the operation in the Findify search engine.


Batch Operations Considerations

At the moment, we cannot guarantee that we will preserve the order of the operations exactly as we received them.

API Authentication

In order to push documents to the Content API, you need to request a private API key.

At the moment, the only way to get a private API key is to contact the Findify support, as Content Search is not yet available to all merchants.

When you have your private API key, you simply need to provide a header Authorization with the value Bearer PRIVATE_ACCESS_KEY.

You will obtain the Private Access Key and the source to be used in the API in the Merchant Dashboard when creating the Custom Content Source integration.

Contact [email protected] for more information.

API Limits

You can pass maximum 6MB of payload per each request.

API Error Codes

HTTP Error CodeDescription
400Payload is not valid
401Your Private Access Key is not valid
404Content source provided is not found
405Content source is not a Custom content source
500Internal server error