💡 A comprehensive solution for searching and retrieving individual or multiple profiles.

This article explains the available endpoints for the Profiles API. The Profiles API enables you to search for and retrieve profiles. Below are the available endpoints:

1. Search Profiles

The Search Profiles endpoint allows you to search for profiles in a specified collection. You can use the endpoint to search for profiles by product ID, collection name, search string, and more.

Request Parameters

The Search Profiles endpoint supports the following parameters:

ParametersRequired/OptionalData TypeDescription
product_IdRequiredstringThe unique product ID.
collectionRequiredstringThe collection name of the profile to search from.
searchOptionalstringThe search string.
pageOptionalintegerFetch results from the given page number.
perpageOptionalintegerNumber of results per page.
facetsOptionalarray of stringFetch the facet information, should be comma-separated.
filterQueryOptionalstringQuery to filter listings.
retrieveAttributesOptionalarray of stringAttributes to retrieve.
referrencesOptionalarray of stringField references to fill, should be comma separated.

Response Payload

The response payload of the Search Profiles endpoint will contain the search results based on the provided parameters. Below is an example of a response object:

{
  "results": [
    {
      "address": "45 Saint Clair Avenue West, 1001, Toronto, Ontario, M4V 1K9, Canada",
      "listings": [],
      "logo": "https://storage.googleapis.com/precon-app.appspot.com/d2d7751a-f463-44b3-8cc4-02ed7fcef6e2.png",
      "name": "Knightstone Capital Management Inc.",
      "website": "http://www.k-cap.com/",
      "path": "Builders/zlVMmcdJv3yv3e3VZam3",
      "objectID": "zlVMmcdJv3yv3e3VZam3"
    },
    {
      "address": "3389 Steeles Avenue East, 100, Toronto, Ontario, M2H 0A1, Canada\n\n",
      "listings": [],
      "logo": "https://storage.googleapis.com/precon-app.appspot.com/f0a21e8c-ba53-4128-8dab-9e616353335c.png",
      "name": "Kingdom Development",
      "website": "https://kingdomcanada.com/",
      "path": "Builders/zR9k4ao6zQgMJdxqs3Vf",
      "objectID": "zR9k4ao6zQgMJdxqs3Vf"
    }
  ],
  "total": 419,
  "page": 0,
  "pages": 210,
  "perPage": 2
}

2. Get A Profile

The Get A Profile endpoint allows you to retrieve a specific profile by ID. You can use this endpoint to retrieve a single profile from a specified collection.

Request Parameters

The Get A Profile endpoint supports the following parameters:

ParameterRequired/OptionalData TypeDescription
product_idRequiredstringThe unique product ID.
idRequiredstringProfile ID to fetch.
collectionRequiredstringName of the profile collection, for example, Architects, Builders, etc.
referrencesOptionalarray of stringField referrences to fill, should be comma separated

Response Payload

The response payload of the Get A Profile endpoint will contain the requested profile information, as shown in the example below.

{
  "address": "45 Saint Clair Avenue West, 1001, Toronto, Ontario, M4V 1K9, Canada",
  "listings": [],
  "logo": "https://storage.googleapis.com/precon-app.appspot.com/d2d7751a-f463-44b3-8cc4-02ed7fcef6e2.png",
  "name": "Knightstone Capital Management Inc.",
  "website": "http://www.k-cap.com/",
  "path": "Builders/zlVMmcdJv3yv3e3VZam3",
  "id": "zlVMmcdJv3yv3e3VZam3"
}

3. Get Multiple Profiles

The Get Multiple Profiles endpoint allows you to retrieve multiple profiles at once. You can use this endpoint to retrieve multiple profiles from a specified collection by providing a list of profile paths.

Request Parameters

The Get Multiple Profiles endpoint supports the following parameters:

ParameterRequired/OptionalData TypeDescription
product_idRequiredstringThe unique product ID.
pathsRequiredarray of stringPaths of profiles. Paths are made up of collection name and id.
referrencesOptionalarray of stringFields to attach references, should be comma separated.

Response Payload

The response payload of the Get Multiple Profiles endpoint will contain the requested profile information for multiple profiles. Below is a response example for multiple profiles.

{
  "results": [
    {
      "address": "317 Adelaide St W, Toronto, Ontario, M5V 1P9, Canada",
      "listings": [
        "Listings/Q2TAED"
      ],
      "logo": "https://storage.googleapis.com/precon-app.appspot.com/3d16b6f7-c5ce-428e-87bd-651cc09d6ecd.png",
      "name": "Niche Development",
      "website": "nichedevelopment.ca",
      "path": "Builders/06K1RDAiqm543AVo72BE",
      "sample": "[email protected]",
      "objectID": "06K1RDAiqm543AVo72BE"
    },
    {
      "address": "602 King St W Suite 102, Toronto, ON M5V 1M6",
      "listings": [
        "Listings/IP1NDL"
      ],
      "logo": "https://storage.googleapis.com/precon-app.appspot.com/4077aa42-671c-4b3e-90c6-eb2cf2cebb4f.png",
      "name": "MarketVision Real Estate Corporation",
      "website": "marketvisionrealty.com",
      "path": "Marketers/1NuWRj06ZHFddQVzZfVt",
      "objectID": "1NuWRj06ZHFddQVzZfVt"
    }
  ]
}