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
in
header

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

Import summary

Response Content-Types: application/json
Response Example (200 OK)
{
  "total": 1,
  "skipped": 1,
  "imported": 0,
  "missing_barcode": 1,
  "invalid_barcode": 0
}

Product Import

POST /catalog

Import a product in user catalog

Products data

Request Example
{
  "name": "Test",
  "price": 10,
  "sku": "test1234",
  "ean": "1234567812",
  "status": "ready"
}
200 OK

Generic success response

Response Content-Types: application/json
Response Example (200 OK)
{
  "status": "integer",
  "message": "string"
}

Catalog List

GET /catalog

Catalog products

page
in query
integer

Page number

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"
    }
  ]
}

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

Generic success response

Response Content-Types: application/json
Response Example (200 OK)
{
  "status": "integer",
  "message": "string"
}

Account

Account management

getAccount

GET /account/me

Provides the account details together with enabled countries and sources

200 OK
Me

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"
}

Common

Common API

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

List of Amazon Bestseller Categories

Response Content-Types: application/json
Response Example (200 OK)
[
  {
    "id": "string",
    "name": "string"
  }
]

Query

Prices query

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

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
    }
  ]
}

Single Product Analysis

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

Provides the offer details of a single product

country
in path
string

Country ISO Code

id
in path
string

Product composite ID, e.g. EAN:123123123

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
    }
  ]
}

Price Analysis

GET /analysis/price/{country}

Provides the price analysis for the entire catalog

country
in path
string

Country ISO Code

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
    }
  ]
}

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)

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
    }
  ]
}

Competitor Catalog Analysis

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

Provides the catalog analysis of a specific competitor

country
in path
string

Country ISO Code

id
in path
number

Competitor ID

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
    }
  ]
}

Competitors Analysis

GET /analysis/competitors/{country}

Provides the analysis of all competitors

country
in path
string

Country ISO Code

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
    }
  ]
}

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)

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
    }
  ]
}

Discovered Competitors Analysis

GET /sources/discovered/{country}

Provides the list of discovered competitor in a specific country

country
in path
string

Country ISO Code

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
    }
  ]
}

Opportunities analysis

GET /opportunities

Provides the list of Amazon bestesellers

country_code
in query
string

Country ISO code

category
in query
string

Category ID to restrict the bestesellers list to; you can obtain the categories list from /v1/common/categories

Bestsellers List

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
    }
  ]
}

Catalog Analysis

Catalog analysis query

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

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
    }
  ]
}

Single Product Analysis

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

Provides the offer details of a single product

country
in path
string

Country ISO Code

id
in path
string

Product composite ID, e.g. EAN:123123123

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
    }
  ]
}

Competitor Catalog Analysis

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

Provides the catalog analysis of a specific competitor

country
in path
string

Country ISO Code

id
in path
number

Competitor ID

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
    }
  ]
}

Price Analysis

Price analysis query

Price Analysis

GET /analysis/price/{country}

Provides the price analysis for the entire catalog

country
in path
string

Country ISO Code

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
    }
  ]
}

Opportunities Analysis

Opportunities analysis query

Opportunities analysis

GET /opportunities

Provides the list of Amazon bestesellers

country_code
in query
string

Country ISO code

category
in query
string

Category ID to restrict the bestesellers list to; you can obtain the categories list from /v1/common/categories

Bestsellers List

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
    }
  ]
}

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)

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
    }
  ]
}

Competitor Analysis

Competitor Catalog Analysis

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

Provides the catalog analysis of a specific competitor

country
in path
string

Country ISO Code

id
in path
number

Competitor ID

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
    }
  ]
}

Competitors Analysis

Competitors Analysis

GET /analysis/competitors/{country}

Provides the analysis of all competitors

country
in path
string

Country ISO Code

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
    }
  ]
}

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)

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
    }
  ]
}

Discovered Competitors Analysis

GET /sources/discovered/{country}

Provides the list of discovered competitor in a specific country

country
in path
string

Country ISO Code

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
    }
  ]
}

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"
}