Pricefy API API Reference

Pricefy API

API Endpoint

https://api.pricefy.io/v1/

Schemes: https

Version: 1.1.0

Authentication

Bearer

Ex. Authorization: Bearer xxxx

type

apiKey

name

Authorization

header

Catalog Management

Catalog management

Catalog Management

importProducts

POST /catalog/import

Import a list of products

Request Example

{
  "append_only": "integer",
  "products": [
    {
      "name": "Test",
      "price": 10,
      "sku": "test1234",
      "ean": "1234567812",
      "status": "ready"
    }
  ]
}

200 OK

ImportSummary

Import summary

Response Content-Types: application/json

Response Example (200 OK)

{
  "total": 1,
  "skipped": 1,
  "imported": 0,
  "missing_barcode": 1,
  "invalid_barcode": 0
}


Bearer

Catalog Management

Product Import

POST /catalog

Import a product in user catalog

ProductData

Products data

Request Example

{
  "name": "Test",
  "price": 10,
  "sku": "test1234",
  "ean": "1234567812",
  "status": "ready"
}

200 OK

OkResponse

Generic success response

Response Content-Types: application/json

Response Example (200 OK)

{
  "status": "integer",
  "message": "string"
}


Bearer

Catalog Management

Catalog List

GET /catalog

Catalog products

page

in query

integer

Page number

200 OK

CatalogResponse

Catalog products

Response Content-Types: application/json

Response Example (200 OK)

{
  "current_page": "integer",
  "from": "integer",
  "to": "integer",
  "next_page_url": "string",
  "prev_page_url": "string",
  "path": "string",
  "per_page": "integer",
  "data": [
    {
      "composite_id": "EAN:8015654212114",
      "code_type": "EAN",
      "code": "8015654212114",
      "name": "HIGIENIC*MUT INC 1(EROS)C/F*****",
      "picture_url": "",
      "cost": 14.02,
      "price": 21,
      "status": "ready"
    }
  ]
}


Bearer

Catalog Management

Delete a list of Products

DELETE /catalog

Delete a list of products from catalog. Note: the product will be set as deleted and not physically removed.

Request Example

{
  "composite_ids": [
    "string"
  ]
}

200 OK

OkResponse

Generic success response

Response Content-Types: application/json

Response Example (200 OK)

{
  "status": "integer",
  "message": "string"
}


Bearer

Account

Account management

Account

getAccount

GET /account/me

Provides the account details together with enabled countries and sources

200 OK

Account information together with allowed sources and countries

Response Content-Types: application/json

Response Example (200 OK)

{
  "id": 1,
  "email": "accountemail@domain.com",
  "picture_path": "https://s3.amazonaws.com/img.pricefy.io/avatar/default_profile_img.png",
  "firstname": "Fabrizio",
  "lastname": "D'Ammassa",
  "country": "",
  "currency": "EUR",
  "tax_value": 0,
  "country_code": "",
  "zip": "",
  "address": "",
  "city": "",
  "company_name": "",
  "website_name": "",
  "website_type": "",
  "phone_prefix": "+39",
  "phone": "",
  "created_at": "2016-11-28T20:59:19.000Z"
}


Bearer

Common

Common API

Common

Amazon Bestseller Categories

GET /common/categories/{country}

Provides the list of Amazon bestesellers categories for a specific country

country

in path

string

Country ISO Code

200 OK

AmazonCategory

List of Amazon Bestseller Categories

type

AmazonCategory

Response Content-Types: application/json

Response Example (200 OK)

[
  {
    "id": "string",
    "name": "string"
  }
]


Bearer

Query

Prices query

Query Catalog Analysis

Catalog Analysis

GET /analysis/catalog/{country}

Provides the analysis result for the entire catalog

country

in path

string

Country ISO Code

page

in query

number

Result page to return

200 OK

CatalogAnalysisResponse

Catalog Analysis

Response Content-Types: application/json

Response Example (200 OK)

{
  "current_page": "integer",
  "from": "integer",
  "to": "integer",
  "next_page_url": "string",
  "prev_page_url": "string",
  "path": "string",
  "per_page": "integer",
  "data": [
    {
      "product": "BENDA ELASTOMULL 4X400CM",
      "pricefy_id": "EAN:4042809022421",
      "code_type": "EAN",
      "code": "4042809022421",
      "competitors": 4,
      "demand": "Low",
      "competition": "Medium",
      "rating": 0,
      "cost": 1.91,
      "min_price": 0.59,
      "avg_price": 10.44,
      "max_price": 21,
      "min_markup": -69.11,
      "avg_markup": 446.73,
      "max_markup": 999.48
    }
  ]
}


Bearer

Query Catalog Analysis

Single Product Analysis

GET /analysis/catalog/{country}/{id}

Provides the offer details of a single product

country

in path

string

Country ISO Code

in path

string

Product composite ID, e.g. EAN:123123123

200 OK

ProductAnalysisResponse

Product Analysis

Response Content-Types: application/json

Response Example (200 OK)

{
  "current_page": "integer",
  "from": "integer",
  "to": "integer",
  "next_page_url": "string",
  "prev_page_url": "string",
  "path": "string",
  "per_page": "integer",
  "data": [
    {
      "name": "Frauenland Apotheke",
      "competitor_id": 175,
      "type": "Amazon",
      "competitor_price": 16.77,
      "my_price": 2.64,
      "price_diff": 535
    }
  ]
}


Bearer

Query Price Analysis

Price Analysis

GET /analysis/price/{country}

Provides the price analysis for the entire catalog

country

in path

string

Country ISO Code

200 OK

PriceAnalysisResponse

Price Analysis

Response Content-Types: application/json

Response Example (200 OK)

{
  "current_page": "integer",
  "from": "integer",
  "to": "integer",
  "next_page_url": "string",
  "prev_page_url": "string",
  "path": "string",
  "per_page": "integer",
  "data": [
    {
      "product": "BENDA ELASTOMULL 4X400CM",
      "code_type": "EAN",
      "code": "4042809022421",
      "price": 2.64,
      "amazon_price": 0.59,
      "ebay_price": 0,
      "min_price": 0.59,
      "avg_price": 10.44,
      "max_price": 21,
      "min_diff": -77.65,
      "avg_diff": 295.55,
      "max_diff": 695.45
    }
  ]
}


Bearer

Query Marketplace Analysis

Marketplace Catalog Analysis

GET /analysis/marketplace/{country}/{code}

Provides the catalog analysis restricted to a single marketplace

country

in path

string

Country ISO Code

code

in path

string

Marketplace code (ebay or amazon)

200 OK

MarketplaceAnalysisResponse

Marketplace Catalog Analysis

Response Content-Types: application/json

Response Example (200 OK)

{
  "current_page": "integer",
  "from": "integer",
  "to": "integer",
  "next_page_url": "string",
  "prev_page_url": "string",
  "path": "string",
  "per_page": "integer",
  "data": [
    {
      "product": "APROTEN ANELLINI 500G",
      "pricefy_id": "EAN:8001040079034",
      "code_type": "EAN",
      "code": "8001040079034",
      "cost": 8.6,
      "min_price": 9.57,
      "avg_price": 9.57,
      "max_price": 9.57,
      "min_markup": 11.28,
      "avg_markup": 11.28,
      "max_markup": 11.28
    }
  ]
}


Bearer

Query Competitor Analysis Catalog Analysis

Competitor Catalog Analysis

GET /analysis/competitors/{country}/{id}

Provides the catalog analysis of a specific competitor

country

in path

string

Country ISO Code

in path

number

Competitor ID

200 OK

CompetitorAnalysisResponse

Competitor Catalog Analysis

Response Content-Types: application/json

Response Example (200 OK)

{
  "current_page": "integer",
  "from": "integer",
  "to": "integer",
  "next_page_url": "string",
  "prev_page_url": "string",
  "path": "string",
  "per_page": "integer",
  "data": [
    {
      "product": "Plasmon Stelline Pasta (340g)",
      "pricefy_id": "EAN:8001040012352",
      "code_type": "EAN",
      "code": "8001040012352",
      "price": 4.35,
      "my_price": 2.39,
      "price_diff": 82.01
    }
  ]
}


Bearer

Query Competitors Analysis

Competitors Analysis

GET /analysis/competitors/{country}

Provides the analysis of all competitors

country

in path

string

Country ISO Code

200 OK

CompetitorsAnalysisResponse

Competitors Analysis

Response Content-Types: application/json

Response Example (200 OK)

{
  "current_page": "integer",
  "from": "integer",
  "to": "integer",
  "next_page_url": "string",
  "prev_page_url": "string",
  "path": "string",
  "per_page": "integer",
  "data": [
    {
      "name": "Farmacosmo",
      "competitor_id": 11,
      "type": "Amazon",
      "rating": 0,
      "products_match": 31,
      "catalog_similarity": 46
    }
  ]
}


Bearer

Query Discovered Competitors Analysis

Discovered Competitor Analysis

GET /sources/discovered/{country}/{domain}

Provides the discovered competitor's urls in a specific country

country

in path

string

Country ISO Code

domain

in path

string

Competitor domain (e.g. test.com)

200 OK

DiscoveredCompetitorAnalysisResponse

Discovered Competitor Analysis

Response Content-Types: application/json

Response Example (200 OK)

{
  "current_page": "integer",
  "from": "integer",
  "to": "integer",
  "next_page_url": "string",
  "prev_page_url": "string",
  "path": "string",
  "per_page": "integer",
  "data": [
    {
      "keyword": "KERN e figlio conteggio, 1 pezzi, CPB 15 K0.2 N",
      "url": "http://www.022.org/abeplusplus/gm/archives/00000109.html",
      "last_check": "2018-03-13",
      "serp": 16
    }
  ]
}


Bearer

Query Discovered Competitors Analysis

Discovered Competitors Analysis

GET /sources/discovered/{country}

Provides the list of discovered competitor in a specific country

country

in path

string

Country ISO Code

200 OK

DiscoveredCompetitorsAnalysisResponse

Discovered Competitors Analysis

Response Content-Types: application/json

Response Example (200 OK)

{
  "current_page": "integer",
  "from": "integer",
  "to": "integer",
  "next_page_url": "string",
  "prev_page_url": "string",
  "path": "string",
  "per_page": "integer",
  "data": [
    {
      "domain": "022.org",
      "urls": 1,
      "monitoring": 0,
      "date_found": "2018-03-13",
      "fraud": 0
    }
  ]
}


Bearer

Query Opportunities Analysis

Opportunities analysis

GET /opportunities

Provides the list of Amazon bestesellers

country_code

in query

string

Country ISO code

Response Content-Types: application/json

Response Example (200 OK)

{
  "current_page": "integer",
  "from": "integer",
  "to": "integer",
  "next_page_url": "string",
  "prev_page_url": "string",
  "path": "string",
  "per_page": "integer",
  "data": [
    {
      "asin": "B0744CM8CP",
      "title": "Batman batarang Spinner, the dark knight spinner, Justice league collectible, Fidget Spinner, plastic, Anti Stress Toys",
      "demand": "High",
      "rating": 0,
      "price": 13.07,
      "position": 92,
      "last_position": 0,
      "woc": 0
    }
  ]
}


Bearer

Catalog Analysis

Catalog analysis query

Query Catalog Analysis

Catalog Analysis

GET /analysis/catalog/{country}

Provides the analysis result for the entire catalog

country

in path

string

Country ISO Code

page

in query

number

Result page to return

200 OK

CatalogAnalysisResponse

Catalog Analysis

Response Content-Types: application/json

Response Example (200 OK)

{
  "current_page": "integer",
  "from": "integer",
  "to": "integer",
  "next_page_url": "string",
  "prev_page_url": "string",
  "path": "string",
  "per_page": "integer",
  "data": [
    {
      "product": "BENDA ELASTOMULL 4X400CM",
      "pricefy_id": "EAN:4042809022421",
      "code_type": "EAN",
      "code": "4042809022421",
      "competitors": 4,
      "demand": "Low",
      "competition": "Medium",
      "rating": 0,
      "cost": 1.91,
      "min_price": 0.59,
      "avg_price": 10.44,
      "max_price": 21,
      "min_markup": -69.11,
      "avg_markup": 446.73,
      "max_markup": 999.48
    }
  ]
}


Bearer

Query Catalog Analysis

Single Product Analysis

GET /analysis/catalog/{country}/{id}

Provides the offer details of a single product

country

in path

string

Country ISO Code

in path

string

Product composite ID, e.g. EAN:123123123

200 OK

ProductAnalysisResponse

Product Analysis

Response Content-Types: application/json

Response Example (200 OK)

{
  "current_page": "integer",
  "from": "integer",
  "to": "integer",
  "next_page_url": "string",
  "prev_page_url": "string",
  "path": "string",
  "per_page": "integer",
  "data": [
    {
      "name": "Frauenland Apotheke",
      "competitor_id": 175,
      "type": "Amazon",
      "competitor_price": 16.77,
      "my_price": 2.64,
      "price_diff": 535
    }
  ]
}


Bearer

Query Competitor Analysis Catalog Analysis

Competitor Catalog Analysis

GET /analysis/competitors/{country}/{id}

Provides the catalog analysis of a specific competitor

country

in path

string

Country ISO Code

in path

number

Competitor ID

200 OK

CompetitorAnalysisResponse

Competitor Catalog Analysis

Response Content-Types: application/json

Response Example (200 OK)

{
  "current_page": "integer",
  "from": "integer",
  "to": "integer",
  "next_page_url": "string",
  "prev_page_url": "string",
  "path": "string",
  "per_page": "integer",
  "data": [
    {
      "product": "Plasmon Stelline Pasta (340g)",
      "pricefy_id": "EAN:8001040012352",
      "code_type": "EAN",
      "code": "8001040012352",
      "price": 4.35,
      "my_price": 2.39,
      "price_diff": 82.01
    }
  ]
}


Bearer

Price Analysis

Price analysis query

Query Price Analysis

Price Analysis

GET /analysis/price/{country}

Provides the price analysis for the entire catalog

country

in path

string

Country ISO Code

200 OK

PriceAnalysisResponse

Price Analysis

Response Content-Types: application/json

Response Example (200 OK)

{
  "current_page": "integer",
  "from": "integer",
  "to": "integer",
  "next_page_url": "string",
  "prev_page_url": "string",
  "path": "string",
  "per_page": "integer",
  "data": [
    {
      "product": "BENDA ELASTOMULL 4X400CM",
      "code_type": "EAN",
      "code": "4042809022421",
      "price": 2.64,
      "amazon_price": 0.59,
      "ebay_price": 0,
      "min_price": 0.59,
      "avg_price": 10.44,
      "max_price": 21,
      "min_diff": -77.65,
      "avg_diff": 295.55,
      "max_diff": 695.45
    }
  ]
}


Bearer

Opportunities Analysis

Opportunities analysis query

Query Opportunities Analysis

Opportunities analysis

GET /opportunities

Provides the list of Amazon bestesellers

country_code

in query

string

Country ISO code

Response Content-Types: application/json

Response Example (200 OK)

{
  "current_page": "integer",
  "from": "integer",
  "to": "integer",
  "next_page_url": "string",
  "prev_page_url": "string",
  "path": "string",
  "per_page": "integer",
  "data": [
    {
      "asin": "B0744CM8CP",
      "title": "Batman batarang Spinner, the dark knight spinner, Justice league collectible, Fidget Spinner, plastic, Anti Stress Toys",
      "demand": "High",
      "rating": 0,
      "price": 13.07,
      "position": 92,
      "last_position": 0,
      "woc": 0
    }
  ]
}


Bearer

Marketplace Analysis

Query Marketplace Analysis

Marketplace Catalog Analysis

GET /analysis/marketplace/{country}/{code}

Provides the catalog analysis restricted to a single marketplace

country

in path

string

Country ISO Code

code

in path

string

Marketplace code (ebay or amazon)

200 OK

MarketplaceAnalysisResponse

Marketplace Catalog Analysis

Response Content-Types: application/json

Response Example (200 OK)

{
  "current_page": "integer",
  "from": "integer",
  "to": "integer",
  "next_page_url": "string",
  "prev_page_url": "string",
  "path": "string",
  "per_page": "integer",
  "data": [
    {
      "product": "APROTEN ANELLINI 500G",
      "pricefy_id": "EAN:8001040079034",
      "code_type": "EAN",
      "code": "8001040079034",
      "cost": 8.6,
      "min_price": 9.57,
      "avg_price": 9.57,
      "max_price": 9.57,
      "min_markup": 11.28,
      "avg_markup": 11.28,
      "max_markup": 11.28
    }
  ]
}


Bearer

Competitor Analysis

Query Competitor Analysis Catalog Analysis

Competitor Catalog Analysis

GET /analysis/competitors/{country}/{id}

Provides the catalog analysis of a specific competitor

country

in path

string

Country ISO Code

in path

number

Competitor ID

200 OK

CompetitorAnalysisResponse

Competitor Catalog Analysis

Response Content-Types: application/json

Response Example (200 OK)

{
  "current_page": "integer",
  "from": "integer",
  "to": "integer",
  "next_page_url": "string",
  "prev_page_url": "string",
  "path": "string",
  "per_page": "integer",
  "data": [
    {
      "product": "Plasmon Stelline Pasta (340g)",
      "pricefy_id": "EAN:8001040012352",
      "code_type": "EAN",
      "code": "8001040012352",
      "price": 4.35,
      "my_price": 2.39,
      "price_diff": 82.01
    }
  ]
}


Bearer

Competitors Analysis

Query Competitors Analysis

Competitors Analysis

GET /analysis/competitors/{country}

Provides the analysis of all competitors

country

in path

string

Country ISO Code

200 OK

CompetitorsAnalysisResponse

Competitors Analysis

Response Content-Types: application/json

Response Example (200 OK)

{
  "current_page": "integer",
  "from": "integer",
  "to": "integer",
  "next_page_url": "string",
  "prev_page_url": "string",
  "path": "string",
  "per_page": "integer",
  "data": [
    {
      "name": "Farmacosmo",
      "competitor_id": 11,
      "type": "Amazon",
      "rating": 0,
      "products_match": 31,
      "catalog_similarity": 46
    }
  ]
}


Bearer

Discovered Competitors Analysis

Query Discovered Competitors Analysis

Discovered Competitor Analysis

GET /sources/discovered/{country}/{domain}

Provides the discovered competitor's urls in a specific country

country

in path

string

Country ISO Code

domain

in path

string

Competitor domain (e.g. test.com)

200 OK

DiscoveredCompetitorAnalysisResponse

Discovered Competitor Analysis

Response Content-Types: application/json

Response Example (200 OK)

{
  "current_page": "integer",
  "from": "integer",
  "to": "integer",
  "next_page_url": "string",
  "prev_page_url": "string",
  "path": "string",
  "per_page": "integer",
  "data": [
    {
      "keyword": "KERN e figlio conteggio, 1 pezzi, CPB 15 K0.2 N",
      "url": "http://www.022.org/abeplusplus/gm/archives/00000109.html",
      "last_check": "2018-03-13",
      "serp": 16
    }
  ]
}


Bearer

Query Discovered Competitors Analysis

Discovered Competitors Analysis

GET /sources/discovered/{country}

Provides the list of discovered competitor in a specific country

country

in path

string

Country ISO Code

200 OK

DiscoveredCompetitorsAnalysisResponse

Discovered Competitors Analysis

Response Content-Types: application/json

Response Example (200 OK)

{
  "current_page": "integer",
  "from": "integer",
  "to": "integer",
  "next_page_url": "string",
  "prev_page_url": "string",
  "path": "string",
  "per_page": "integer",
  "data": [
    {
      "domain": "022.org",
      "urls": 1,
      "monitoring": 0,
      "date_found": "2018-03-13",
      "fraud": 0
    }
  ]
}


Bearer

Schema Definitions

OkResponse:

status: integer: will be always 1
message: string: Success message

Example

{
  "status": "integer",
  "message": "string"
}

ProductID:

status: integer: will be always 1
message: string: Success message

Example

{
  "status": "integer",
  "message": "string"
}

CatalogResponse:

current_page: integer: current page
from: integer: results start offset
to: integer: results end offset
next_page_url: string: next result page url
prev_page_url: string: previous result page url
path: string: page path
per_page: integer: results per page
data: Product

Example

{
  "current_page": "integer",
  "from": "integer",
  "to": "integer",
  "next_page_url": "string",
  "prev_page_url": "string",
  "path": "string",
  "per_page": "integer",
  "data": [
    {
      "composite_id": "EAN:8015654212114",
      "code_type": "EAN",
      "code": "8015654212114",
      "name": "HIGIENIC*MUT INC 1(EROS)C/F*****",
      "picture_url": "",
      "cost": 14.02,
      "price": 21,
      "status": "ready"
    }
  ]
}

DiscoveredCompetitorsAnalysisResponse:

current_page: integer: current page
from: integer: results start offset
to: integer: results end offset
next_page_url: string: next result page url
prev_page_url: string: previous result page url
path: string: page path
per_page: integer: results per page
data: DiscoveredCompetitorsAnalysisData

Example

{
  "current_page": "integer",
  "from": "integer",
  "to": "integer",
  "next_page_url": "string",
  "prev_page_url": "string",
  "path": "string",
  "per_page": "integer",
  "data": [
    {
      "domain": "022.org",
      "urls": 1,
      "monitoring": 0,
      "date_found": "2018-03-13",
      "fraud": 0
    }
  ]
}

DiscoveredCompetitorAnalysisResponse:

current_page: integer: current page
from: integer: results start offset
to: integer: results end offset
next_page_url: string: next result page url
prev_page_url: string: previous result page url
path: string: page path
per_page: integer: results per page
data: DiscoveredCompetitorAnalysisData

Example

{
  "current_page": "integer",
  "from": "integer",
  "to": "integer",
  "next_page_url": "string",
  "prev_page_url": "string",
  "path": "string",
  "per_page": "integer",
  "data": [
    {
      "keyword": "KERN e figlio conteggio, 1 pezzi, CPB 15 K0.2 N",
      "url": "http://www.022.org/abeplusplus/gm/archives/00000109.html",
      "last_check": "2018-03-13",
      "serp": 16
    }
  ]
}

CompetitorsAnalysisResponse:

current_page: integer: current page
from: integer: results start offset
to: integer: results end offset
next_page_url: string: next result page url
prev_page_url: string: previous result page url
path: string: page path
per_page: integer: results per page
data: CompetitorsAnalysisData

Example

{
  "current_page": "integer",
  "from": "integer",
  "to": "integer",
  "next_page_url": "string",
  "prev_page_url": "string",
  "path": "string",
  "per_page": "integer",
  "data": [
    {
      "name": "Farmacosmo",
      "competitor_id": 11,
      "type": "Amazon",
      "rating": 0,
      "products_match": 31,
      "catalog_similarity": 46
    }
  ]
}

CompetitorAnalysisResponse:

current_page: integer: current page
from: integer: results start offset
to: integer: results end offset
next_page_url: string: next result page url
prev_page_url: string: previous result page url
path: string: page path
per_page: integer: results per page
data: CompetitorAnalysisData

Example

{
  "current_page": "integer",
  "from": "integer",
  "to": "integer",
  "next_page_url": "string",
  "prev_page_url": "string",
  "path": "string",
  "per_page": "integer",
  "data": [
    {
      "product": "Plasmon Stelline Pasta (340g)",
      "pricefy_id": "EAN:8001040012352",
      "code_type": "EAN",
      "code": "8001040012352",
      "price": 4.35,
      "my_price": 2.39,
      "price_diff": 82.01
    }
  ]
}

MarketplaceAnalysisResponse:

current_page: integer: current page
from: integer: results start offset
to: integer: results end offset
next_page_url: string: next result page url
prev_page_url: string: previous result page url
path: string: page path
per_page: integer: results per page
data: MarketplaceAnalysisData

Example

{
  "current_page": "integer",
  "from": "integer",
  "to": "integer",
  "next_page_url": "string",
  "prev_page_url": "string",
  "path": "string",
  "per_page": "integer",
  "data": [
    {
      "product": "APROTEN ANELLINI 500G",
      "pricefy_id": "EAN:8001040079034",
      "code_type": "EAN",
      "code": "8001040079034",
      "cost": 8.6,
      "min_price": 9.57,
      "avg_price": 9.57,
      "max_price": 9.57,
      "min_markup": 11.28,
      "avg_markup": 11.28,
      "max_markup": 11.28
    }
  ]
}

PriceAnalysisResponse:

current_page: integer: current page
from: integer: results start offset
to: integer: results end offset
next_page_url: string: next result page url
prev_page_url: string: previous result page url
path: string: page path
per_page: integer: results per page
data: PriceAnalysisData

Example

{
  "current_page": "integer",
  "from": "integer",
  "to": "integer",
  "next_page_url": "string",
  "prev_page_url": "string",
  "path": "string",
  "per_page": "integer",
  "data": [
    {
      "product": "BENDA ELASTOMULL 4X400CM",
      "code_type": "EAN",
      "code": "4042809022421",
      "price": 2.64,
      "amazon_price": 0.59,
      "ebay_price": 0,
      "min_price": 0.59,
      "avg_price": 10.44,
      "max_price": 21,
      "min_diff": -77.65,
      "avg_diff": 295.55,
      "max_diff": 695.45
    }
  ]
}

ProductAnalysisResponse:

current_page: integer: current page
from: integer: results start offset
to: integer: results end offset
next_page_url: string: next result page url
prev_page_url: string: previous result page url
path: string: page path
per_page: integer: results per page
data: ProductAnalysisData

Example

{
  "current_page": "integer",
  "from": "integer",
  "to": "integer",
  "next_page_url": "string",
  "prev_page_url": "string",
  "path": "string",
  "per_page": "integer",
  "data": [
    {
      "name": "Frauenland Apotheke",
      "competitor_id": 175,
      "type": "Amazon",
      "competitor_price": 16.77,
      "my_price": 2.64,
      "price_diff": 535
    }
  ]
}

OpportunitiesAnalysisResponse:

current_page: integer: current page
from: integer: results start offset
to: integer: results end offset
next_page_url: string: next result page url
prev_page_url: string: previous result page url
path: string: page path
per_page: integer: results per page
data: OpportunitiesAnalysisData

Example

{
  "current_page": "integer",
  "from": "integer",
  "to": "integer",
  "next_page_url": "string",
  "prev_page_url": "string",
  "path": "string",
  "per_page": "integer",
  "data": [
    {
      "asin": "B0744CM8CP",
      "title": "Batman batarang Spinner, the dark knight spinner, Justice league collectible, Fidget Spinner, plastic, Anti Stress Toys",
      "demand": "High",
      "rating": 0,
      "price": 13.07,
      "position": 92,
      "last_position": 0,
      "woc": 0
    }
  ]
}

CatalogAnalysisResponse:

current_page: integer: current page
from: integer: results start offset
to: integer: results end offset
next_page_url: string: next result page url
prev_page_url: string: previous result page url
path: string: page path
per_page: integer: results per page
data: CatalogAnalysisData

Example

{
  "current_page": "integer",
  "from": "integer",
  "to": "integer",
  "next_page_url": "string",
  "prev_page_url": "string",
  "path": "string",
  "per_page": "integer",
  "data": [
    {
      "product": "BENDA ELASTOMULL 4X400CM",
      "pricefy_id": "EAN:4042809022421",
      "code_type": "EAN",
      "code": "4042809022421",
      "competitors": 4,
      "demand": "Low",
      "competition": "Medium",
      "rating": 0,
      "cost": 1.91,
      "min_price": 0.59,
      "avg_price": 10.44,
      "max_price": 21,
      "min_markup": -69.11,
      "avg_markup": 446.73,
      "max_markup": 999.48
    }
  ]
}

ImportSummary:

imported: integer: imported products
skipped: integer: skipped products (due to validation failure)
missing_barcode: integer: skipped products due to missing EAN and UPC
invalid_barcode: integer: skipped products due to invalid barcode (EAN or UPC)

Example

{
  "total": 1,
  "skipped": 1,
  "imported": 0,
  "missing_barcode": 1,
  "invalid_barcode": 0
}

AmazonCategory:

id: string: Amazon Category ID
name: string: Amazon Category Name

Example

{
  "id": "string",
  "name": "string"
}

ProductData:

name: string: product name
price: number: your price
tax_value: integer: tax percentage
map: number: minimum advertised price
sku: string: product SKU
ean: string: product EAN. EAN or UPC required
upc: string: product UPC. EAN or UPC required
picture_url: string: product picture url
status: string: any of ready, suspended, or deleted

Example

{
  "name": "Test",
  "price": 10,
  "sku": "test1234",
  "ean": "1234567812",
  "status": "ready"
}

CatalogAnalysisData:

Example

{
  "product": "BENDA ELASTOMULL 4X400CM",
  "pricefy_id": "EAN:4042809022421",
  "code_type": "EAN",
  "code": "4042809022421",
  "competitors": 4,
  "demand": "Low",
  "competition": "Medium",
  "rating": 0,
  "cost": 1.91,
  "min_price": 0.59,
  "avg_price": 10.44,
  "max_price": 21,
  "min_markup": -69.11,
  "avg_markup": 446.73,
  "max_markup": 999.48
}

ProductAnalysisData:

Example

{
  "name": "Frauenland Apotheke",
  "competitor_id": 175,
  "type": "Amazon",
  "competitor_price": 16.77,
  "my_price": 2.64,
  "price_diff": 535
}

PriceAnalysisData:

Example

{
  "product": "BENDA ELASTOMULL 4X400CM",
  "code_type": "EAN",
  "code": "4042809022421",
  "price": 2.64,
  "amazon_price": 0.59,
  "ebay_price": 0,
  "min_price": 0.59,
  "avg_price": 10.44,
  "max_price": 21,
  "min_diff": -77.65,
  "avg_diff": 295.55,
  "max_diff": 695.45
}

MarketplaceAnalysisData:

Example

{
  "product": "APROTEN ANELLINI 500G",
  "pricefy_id": "EAN:8001040079034",
  "code_type": "EAN",
  "code": "8001040079034",
  "cost": 8.6,
  "min_price": 9.57,
  "avg_price": 9.57,
  "max_price": 9.57,
  "min_markup": 11.28,
  "avg_markup": 11.28,
  "max_markup": 11.28
}

CompetitorAnalysisData:

Example

{
  "product": "Plasmon Stelline Pasta (340g)",
  "pricefy_id": "EAN:8001040012352",
  "code_type": "EAN",
  "code": "8001040012352",
  "price": 4.35,
  "my_price": 2.39,
  "price_diff": 82.01
}

CompetitorsAnalysisData:

Example

{
  "name": "Farmacosmo",
  "competitor_id": 11,
  "type": "Amazon",
  "rating": 0,
  "products_match": 31,
  "catalog_similarity": 46
}

DiscoveredCompetitorAnalysisData:

Example

{
  "keyword": "KERN e figlio conteggio, 1 pezzi, CPB 15 K0.2 N",
  "url": "http://www.022.org/abeplusplus/gm/archives/00000109.html",
  "last_check": "2018-03-13",
  "serp": 16
}

DiscoveredCompetitorsAnalysisData:

Example

{
  "domain": "022.org",
  "urls": 1,
  "monitoring": 0,
  "date_found": "2018-03-13",
  "fraud": 0
}

OpportunitiesAnalysisData:

Example

{
  "asin": "B0744CM8CP",
  "title": "Batman batarang Spinner, the dark knight spinner, Justice league collectible, Fidget Spinner, plastic, Anti Stress Toys",
  "demand": "High",
  "rating": 0,
  "price": 13.07,
  "position": 92,
  "last_position": 0,
  "woc": 0
}

Me:

id: integer: account id
email: string: account email
picture_path: string: account picture
firstname: string: first name
lastname: string: last name
country: string: account country
currency: string: currency code, e.g. USD or EUR
tax_value: integer: tax percentage
country_code: string: country ISO code
zip: string: zip code
address: string: street address
city: string: city
company_name: string: company name
website_name: string: website name
website_type: string: website type, e.g, magento, woocommerce, shopify
phone_prefix: string: phone international prefix
phone: string: phone number
created_at: string: creation date
sources: object[]
countries: object[]

Example

{
  "id": 1,
  "email": "accountemail@domain.com",
  "picture_path": "https://s3.amazonaws.com/img.pricefy.io/avatar/default_profile_img.png",
  "firstname": "Fabrizio",
  "lastname": "D'Ammassa",
  "country": "",
  "currency": "EUR",
  "tax_value": 0,
  "country_code": "",
  "zip": "",
  "address": "",
  "city": "",
  "company_name": "",
  "website_name": "",
  "website_type": "",
  "phone_prefix": "+39",
  "phone": "",
  "created_at": "2016-11-28T20:59:19.000Z"
}

Product:

composite_id: string: product Composite ID
code_type: string: product code type (e.g. EAN, UPC)
code: string: product code
name: string: product name
price: number: your price
cost: number: your cost
picture_url: string: product picture url
status: string: any of ready, suspended, or deleted

Example

{
  "composite_id": "EAN:8015654212114",
  "code_type": "EAN",
  "code": "8015654212114",
  "name": "HIGIENIC*MUT INC 1(EROS)C/F*****",
  "picture_url": "",
  "cost": 14.02,
  "price": 21,
  "status": "ready"
}

Documentation by Spectacle