Written by Josh Hutter
Welcome to the latest edition of FMTC’s Tech Corner. We’re excited to announce the integration of AI and are introducing a new API field: metadata.
Overview
FMTC is enhancing the efficiency of deal distribution with our new AI-powered tool. This innovative tool is designed to streamline the process of parsing deal label information, ensuring that all deals are presented in a consistent format with standardized data. By leveraging AI capabilities, the metadata accurately identifies crucial deal attributes such as currency type, discount values, percentage vs. flat amounts, maximum values, and a price or quantity triggers. This technology not only simplifies the integration of deals from various sources but also guarantees the reliability and accuracy of the information provided — essential for both merchants and consumers in making informed decisions.
New Fields
The latest edition to the v3 Deals API endpoint is the metadata field. This contains an array object with the following information from the provided labels:
Field Name | Definition |
currency | Specifies the currency type as indicated in the label. |
value | Represents the discount value extracted from the label. If a range is provided, it reflects the lower end. |
max_value | If a range is provided, the maximum discount value in the range. |
is_percent | Boolean value that specifies whether the discount values are percentages (0 for fixed amounts). |
old_price | Displays the original price before any discounts. |
new_price | Shows the price after applying the discount. |
price_trigger | Specifies the price threshold for the discount to be applicable. |
quantity_trigger | Indicates the quantity required for the discount to be applied. |
coupon_code | Provides the discount code if applicable. |
free_shipping | Boolean value that indicates if free shipping is offered. |
Example Input:
label = “Save $5 on regular tickets to Disneyland Resort with promo code SUMMER”
Example Output:
“metadata”: [
{
“currency”: “USD”,
“value”: “5.00”,
“max_value”: null,
“is_percent”: 0,
“old_price”: null,
“new_price”: null,
“price_trigger”: null,
“quantity_trigger”: null,
“coupon_code”: “SUMMER”,
“free_shipping”: 0
}
]
Our system detects the currency symbol ‘$’ in the label, and extracts ‘5’ as the discount value. Since these are fixed values, is_percent remains 0.
Example Input:
label = “Earn a $50-$500 gift card with a select regular-priced purchase. Use code JULYGC.”
Example Output:
“metadata”: [
{
“currency”: “USD”,
“value”: “50.00”,
“max_value”: 500.00,
“is_percent”: 0,
“old_price”: null,
“new_price”: null,
“price_trigger”: null,
“quantity_trigger”: null,
“coupon_code”: “JULYGC”,
“free_shipping”: 0
}
]
Our system detects the currency symbol ‘$’ in the label, and extracts the ‘50’ and ‘500’ as the discount value range. Since these are fixed values, is_percent remains 0.
Example Input:
label = “Shop & Save | 20% off orders over £150”
Example Output:
“metadata”: [
{
“currency”: “GBP”,
“value”: “20.00”,
“max_value”: null,
“is_percent”: 1,
“old_price”: null,
“new_price”: null,
“price_trigger”: 150.00,
“quantity_trigger”: null,
“coupon_code”: null,
“free_shipping”: 0
}
]
Our system detects the currency symbol ‘£’ in the label, and extracts the ‘20’ as the discount value. Since this is a percentage, is_percent is set to 1.
As always, a dedicated team is here to assist you! If you have any questions or concerns, feel free to contact your account manager or email us at [email protected].
Curious about other FMTC technologies? Find more information on FMTC’s tools in Tech Corner: