Professional Buyer API

Professional Buyer API - Acquestizer (a solution to choose the right product/service to buy) is a cross browsers REST API supporting now a maximum of 1000 products per request, each product having a maximum of 500 features.

Allthough this Professional Buyer API is intended for software development and therefore developers, we have also here an online application that may be used to see the result and the input JSONs. Basically for Professional Buyer API you send an authorized POST request in JSON format to the API endpoint and you get as JSON response a list with product names and product ratings. You may use it for commercial purposes for paid packages.
The role of this Professional Buyer API is to select the most competitive product / service in relation to the competing products / services and which belong to the same dimension class. In order to achieve this, the following steps are taken in order: the technical and possibly subjective criteria common to these products / services are established so that each criterion will have a numerical value and the subjective criteria will also have numerical values ​​which can be, for example, notes of 1 to 10; A hierarchical vector is established on three levels of priority for these criteria and which will include all the criteria, depending on the importance that the buyer gives to the respective criteria. Thus, on level 1 will be the most important criteria, on level 2, the less important criteria and on level 3, the criteria that matter the least; a criterion cannot be found on several levels. The maximum and minimum criteria are set so that the maximum criteria will be those criteria whose values ​​are to be as high as possible and the minimum criteria are those criteria whose values ​​are to be as low as possible. The JSON string is formed in the format you see below and this string is sent using the POST method to the API.

The result will also be a JSON containing the name of each product and the rating that each product has obtained as a result of executing the specific algorithm. The product with the highest rating is the most competitive and it must be chosen. The limits of this Professional Buyer API are: maximum 1000 products per request, maximum 500 criteria can be defined for each product. A minimum of 3 products and a minimum of 3 criteria are required. For example: if we intend to purchase a TV we may consider the following criteria: diagonal size (cm), power consumed (W), resolution (pixels), weight (kg), price (USD), warranty (years), design (note). The hierarchical vector is established, subjective: on level 1, the size of the diagonal, the price; on level 2, the resolution, the design, the power consumed; on level 3, the weight.
The maximum criteria are: the size of the diagonal, the resolution, the design.
The minimum criteria are: price, power consumed and weight.
These are all the input data that the Professional Buyer API needs. The JSON input/result are given below:

Professional Buyer APP or API is useful for a large number of domains like: marketing, acquisitions for expensive products, buyer software, acquisition software etc.

For using our API and/or APP you must create an account (free of charge, no card required), activate it from your received email, login and then start your TRIAL package with no fees as you can see at our pricing packages. After you have tested the Professional Buyer API and/or APP and if you are satisfied, you may buy a paid package. You will always see at your Admin Console page the real resources consumption in real time, your invoices, you may see/edit/delete your profile or export log consents as GDPR instructed, you may read our FAQs.

Professional Buyer APP





API Endpoint (method POST):
https://gatiosoft.ro/acquestizer.aspx
Headers:
Authorization: Basic //Your username:password are base64 encoded string
Content-Type: application/json
Accept: application/json
JSON Request Body (change inputs here and see in real time below):
                   [
  {
    "product_name": "TV 1",
    "product_feats": [
      {
        "feature_name": "Diagonal size (cm)",
        "feature_value": 100.0,
        "feature_level": 1,
        "feature_max": true
      },
      {
        "feature_name": "Electric Power (W)",
        "feature_value": 70.0,
        "feature_level": 2,
        "feature_max": false
      },
      {
        "feature_name": "Resolution (pixels)",
        "feature_value": 2000000.0,
        "feature_level": 2,
        "feature_max": true
      },
      {
        "feature_name": "Price (USD)",
        "feature_value": 500.0,
        "feature_level": 1,
        "feature_max": false
      },
      {
        "feature_name": "Design (rate)",
        "feature_value": 9.0,
        "feature_level": 2,
        "feature_max": true
      },
      {
        "feature_name": "Weight (kg)",
        "feature_value": 4.0,
        "feature_level": 3,
        "feature_max": false
      }
    ]
  },
  {
    "product_name": "TV 2",
    "product_feats": [
      {
        "feature_name": "Diagonal size (cm)",
        "feature_value": 110.0,
        "feature_level": 1,
        "feature_max": true
      },
      {
        "feature_name": "Electric Power (W)",
        "feature_value": 72.0,
        "feature_level": 2,
        "feature_max": false
      },
      {
        "feature_name": "Resolution (pixels)",
        "feature_value": 2200000.0,
        "feature_level": 2,
        "feature_max": true
      },
      {
        "feature_name": "Price (USD)",
        "feature_value": 540.0,
        "feature_level": 1,
        "feature_max": false
      },
      {
        "feature_name": "Design (rate)",
        "feature_value": 8.0,
        "feature_level": 2,
        "feature_max": true
      },
      {
        "feature_name": "Weight (kg)",
        "feature_value": 5.0,
        "feature_level": 3,
        "feature_max": false
      }
    ]
  },
  {
    "product_name": "TV 3",
    "product_feats": [
      {
        "feature_name": "Diagonal size (cm)",
        "feature_value": 130.0,
        "feature_level": 1,
        "feature_max": true
      },
      {
        "feature_name": "Electric Power (W)",
        "feature_value": 80.0,
        "feature_level": 2,
        "feature_max": false
      },
      {
        "feature_name": "Resolution (pixels)",
        "feature_value": 2500000.0,
        "feature_level": 2,
        "feature_max": true
      },
      {
        "feature_name": "Price (USD)",
        "feature_value": 600.0,
        "feature_level": 1,
        "feature_max": false
      },
      {
        "feature_name": "Design (rate)",
        "feature_value": 6.0,
        "feature_level": 2,
        "feature_max": true
      },
      {
        "feature_name": "Weight (kg)",
        "feature_value": 6.0,
        "feature_level": 3,
        "feature_max": false
      }
    ]
  },
  {
    "product_name": "TV 4",
    "product_feats": [
      {
        "feature_name": "Diagonal size (cm)",
        "feature_value": 140.0,
        "feature_level": 1,
        "feature_max": true
      },
      {
        "feature_name": "Electric Power (W)",
        "feature_value": 90.0,
        "feature_level": 2,
        "feature_max": false
      },
      {
        "feature_name": "Resolution (pixels)",
        "feature_value": 2600000.0,
        "feature_level": 2,
        "feature_max": true
      },
      {
        "feature_name": "Price (USD)",
        "feature_value": 620.0,
        "feature_level": 1,
        "feature_max": false
      },
      {
        "feature_name": "Design (rate)",
        "feature_value": 5.0,
        "feature_level": 2,
        "feature_max": true
      },
      {
        "feature_name": "Weight (kg)",
        "feature_value": 7.0,
        "feature_level": 3,
        "feature_max": false
      }
    ]
  }
]
               
JSON Response From API (change inputs here and see in real time below):
[
  {
    "product_name": "TV 1",
    "product_rating": 1000.0
  },
  {
    "product_name": "TV 2",
    "product_rating": 1015.76
  },
  {
    "product_name": "TV 3",
    "product_rating": 896.53
  },
  {
    "product_name": "TV 4",
    "product_rating": 1128.83
  }
]
JSON Response (Example) From API in case of ERROR:

 {
  "cd": "1001",
  "description": "The authorization header is either empty or isn't Basic"
}

Sorted Products By Rating

Product Name
TV 4
Product Rating
1128.83

Product Name
TV 2
Product Rating
1015.76

Product Name
TV 1
Product Rating
1000

Product Name
TV 3
Product Rating
896.53

Request Parameters Table

Parameter Name
Parameter Description
product_name
This is the input product name [string] typed in plain text. Example:  TV Samsung F6300
product_feats
This is an array, a list of [product_features] with minimum 3 and maximum 500 features which contains:  feature_name, feature_value, feature_level, feature_max
feature_name
This is the name of the criterion or feature [string] typed in plain text. You may also include here the units of measure. Example: Diagonal size (cm)
feature_value
This parameter defines the numerical value [real] which will be considered for the feature_name above. Example:  120 
feature_level
This parameter defines the level of the feature (its values may be 1, 2 or 3) in the hierarchy vector of priorities [integer] as for 1 means the top level priority, 2 means less priority and 3 means the lowest priority.
feature_max
This parameter shows us if the feature is a max feature or min feature. The type is [boolean] so if max feature then the value is true otherwise is false.

Response Parameter Table

Parameter Name
Parameter Description
product_name
This is the input product name [string] in plain text. Example:  TV Samsung F6300
product_rating
This is the rating calculated by the algorythm for each product  [real] as the winner is the product with the highest rating. Example: 998.25

Response Error Codes Tablee Error Codes Table

Parameter Name
Parameter Description
cd

This is the error code which may be:

  • 1001
  • 1002
  • 1003
  • 1004
  • 1005
  • 1006
  • 1007
  • 1008
  • 1009
  • 1010
  • 1011
  • 1012
  • 1013
  • 1014
  • 1015
  • 2001
description

This is the description of the error code which may be:

  • 1001 - The authorization header is either empty or isn't Basic.
  • 1002 - Daily requests number exceeded in TRIAL mode!
  • 1003 - Trial expired!
  • 1004 - Addresses number exceeded!
  • 1005 - Package expired!
  • 1006 - No invoice!
  • 1007 - Reader is NULL for TRIAL!
  • 1008 - Cannot Read if TRIAL exists!
  • 1009 - Error connecting to database looking for TRIAL! (and a detailed description message of the encountered error)
  • 1010 - Reader is NULL for Invoice!
  • 1011 - Cannot Read if Invoice exists!
  • 1012 - Error connecting to database! (and a detailed description message of the encountered error)
  • 1013 - At least 3 products and maximum 1000 products required!
  • 1014 - Invalid request data! (and a detailed description message of the encountered error)
  • 1015 - At least 3 features required and maximum 500 features required for each product!
  • 2001 - Invalid request data after passing to the API (and a detailed description message of the encountered error)

Source Code Examples for Using Our Professional Buyer API

                       
Imports System
Imports System.Text
Imports System.Net
Imports Newtonsoft.Json

Public Class professional_buyer_api
    Public Class ResponseFields
        Public Property product_name As String
        Public Property product_rating As Double
    End Class

    Public Class ErrorFields
        Public Property cd As String
        Public Property description As String
    End Class

    Protected Sub SendRequest()
        Dim Client As WebClient = New WebClient()
        Dim credentials As String = Convert.ToBase64String(Encoding.ASCII.GetBytes("your_username:your_password"))
        Client.Headers(HttpRequestHeader.Authorization) = String.Format("Basic {0}", credentials)
        Client.Headers(HttpRequestHeader.Accept) = "application/json"
        Client.Headers(HttpRequestHeader.ContentType) = "application/json"
        Client.BaseAddress = "https://gatiosoft.ro/acquestizer.aspx"
        Dim resString As String = ""

        Try
            Dim js As String = "Replace this string with your JSON Request Body string like in the example above on the website"
            Dim reqString As Byte() = Encoding.UTF8.GetBytes(js)
            Dim url As Uri = New Uri(Client.BaseAddress)
            Dim resByte As Byte() = Client.UploadData(url, "post", reqString)
            resString = Encoding.UTF8.GetString(resByte)

            If resString.IndexOf("product_name") > 0 Then
                Dim r As ResponseFields = New ResponseFields()
                r = JsonConvert.DeserializeObject(Of ResponseFields)(resString)
                Console.Write(resString)
            Else
                Dim e As ErrorFields = New ErrorFields()
                e = JsonConvert.DeserializeObject(Of ErrorFields)(resString)
                Console.Write(e.cd)
                Console.Write(e.description)
            End If

            Client.Dispose()
        Catch exception As Exception
            Dim ex As System.Exception = exception
            Console.Write("ERROR: " & resString & ex.Message)
        End Try
    End Sub

    Public Shared Sub Main()
        Dim b As professional_buyer_api = New professional_buyer_api()
        b.SendRequest()
    End Sub
End Class



Professional Buyer API Video Presentation

Choosing the right product/service solved by our Professional Buyer Software - Acquestizer - is in the video presentation below. Our acquisition software or buyer software is a very useful tool for any kind of activity that implies marketing or purchasing goods or services. You can use it as a standalone app or, as a developer, you can access it from your own app or apps.

 



Pricing Packages

Please choose one of the below pricing packages for start using our Professional Buyer API - Acquestizer and online APP!

Start TRIAL
No catches

  • 7 days TRIAL
  • Use our cloud REST API and online APP
  • Maximum 1000 products/services per each request and minimum 3
  • Maximum 500 product/service features or criteria and minimum 3
  • Maximum 50 requests per DAY in trial period
  • You do NOT own the commercial copyright in trial period.
  • Get product ratings, the winner is the product/service with the highest rating
  • Administration console
  • Support through online chat and/or tickets
  • We do NOT allow spam accounts for TRIAL



Monthly TIER
Popular

  • 90 USD per month
  • Use our cloud REST API and online APP
  • Maximum 1000 products/services per each request and minimum 3
  • Maximum 500 product/service features or criteria and minimum 3
  • Maximum 50 requests per MINUTE
  • You own the commercial copyright
  • 30000 requests/month
  • Call the API into your own applications and sell your apps with no other fee
  • Get product ratings, the winner is the product/service with the highest rating
  • Administration console
  • Support through online chat and/or tickets



Yearly TIER
(15% Discount)

  • 918 USD per year
  • Use our cloud REST API and online APP
  • Maximum 1000 products/services per each request and minimum 3
  • Maximum 500 product/service features or criteria and minimum 3
  • Maximum 50 requests per MINUTE
  • You own the commercial copyright
  • 30000 requests/month
  • Call the API into your own applications and sell your apps with no other fee
  • Get product ratings, the winner is the product/service with the highest rating
  • Administration console
  • Support through online chat and/or tickets



Notes:
VAT rate may be added or not, function to your country and/or if you are a taxable person or company.
The remaining requests per month are reset to 0 for the next month.
If you consume all 30000 requests before the end of the paid month you may buy another package.