Vendor Data Integration

Welcome to the Terpdrop Vendor Data Integration documentation. This guide provides detailed instructions for integrating your product data with Terpdrop, ensuring accurate and up-to-date listings for your products. Whether you choose to implement a REST API or manually format your product descriptions, we aim to make the integration process as smooth as possible.

If you have the technical resources we highly recommend implementing a simple REST API that provides your product data in a structured format. This significantly reduces the maintenance burden on both sides and ensures your products are always up-to-date on Terpdrop.

The API should return a JSON object with an array of products, each containing the following fields:

TYPE: GET
ENDPOINT: https://yourdomain.com/api/products
RESPONSE:
{
  "products": [
    {
      "id": 1,
      "strain": "Blue Dream",
      "available": true,
      "link": "https://yourdomain.com/products/blue-dream",
      "lastUpdate": "2025-01-01T00:00:00.000Z",
      "createDate": "2025-01-01T00:00:00.000Z",
      "lastAvailable": "2025-01-01T00:00:00.000Z",
      "price": "10.99",
      "attributes": {
        "lineage": ["Blueberry", "Haze"],
        "environment": "indoor",
        "method": "living soil",
        "priceRange": [10, 20],
        "isSativa": true,
        "sativa": 60,
        "indica": 40,
        "thca": 27,
        "totalCannabinoids": 27,
        "terpenePercentage": 4,
        "terpenes": ["myrcene", "limonene", "pinene"],
        "qualities": ["relaxing", "energetic", "uplifting"],
        "palate": ["sweet", "blueberry", "citrus"],
        "tags": ["flower", "sativa", "indica"],
      }
    }
      ....
  ]
}

We provide guidelines for your API for smooth integration but Terpdrop can work on our end to transform and normalize that data upon ingestion. Our goal is to work with high-quality vendors and ensure your products are accurately represented on Terpdrop.

The most efficient way to get your products listed accurately is by providing a direct API endpoint that we can query to pull in your data. Sometimes we can find this data through your publicly available API endpoints; however, this is not always the case.

product: {
...
isIndica: true,
isSativa: false,
indica: 70,
sativa: 30
...
}

product: {
  ...
  terpenes: ["Limonene", "Myrcene", "Caryophyllene"]
  terpenePercentage: 4.2
  ...
}