Pricefy API API Reference

Pricefy API

API Endpoint

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

Schemes: https

Version: 1.3.1

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

composite_id

in query

string

It allows to search specific product in the catalog by its Composte ID

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

code

in query

string

Product code (EAN:123456789 or UPC:1231313). If you don't specify EAN or UPC prefix, the system will interpret as EAN

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)

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

code

in query

string

Product code (EAN:123456789 or UPC:1231313). If you don't specify EAN or UPC prefix, the system will interpret as EAN

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)

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

E-commerce Competitors Management

competitorsList

GET /ecommerce/competitors

Provides the list of your e-commerce competitors

200 OK

EcommerceCompetitor

E-commerce Competitors List

type

EcommerceCompetitor

Response Content-Types: application/json

Response Example (200 OK)

[
  {
    "id": 1,
    "website_id": 399,
    "domain": "https://www.my-competitor.com",
    "url_count": 520856
  }
]


Bearer

E-commerce Competitors Management

competitorCatalog

GET /ecommerce/competitors/{id}

Provides the list of your e-commerce competitor catalog

in path

integer

E-commerce competitor ID

page

in query

integer

Page number

200 OK

CompetitorCatalogResponse

E-commerce Competitor Catalog

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": [
    {
      "pictureUrl": "https://www.mycompetitor.com/picture.org",
      "title": "The competitor product title",
      "brand": "The competitor product brand",
      "url": "https://www.mycompetitor.com/test.html",
      "price": 8.5,
      "currency": "EUR",
      "fetched_at": "2018-11-30 11:11:34",
      "matching_type": "AUTO",
      "matching_similarity": 2,
      "account_product_title": "My Product Title",
      "account_product_picture_url": "https://my-ecommerce.it/the-picture.png",
      "composite_id": "EAN:123456789010"
    }
  ]
}


Bearer

E-commerce Competitors Management

importMatchings

POST /ecommerce/matchings

Import a list of matchings

Request Example

{
  "append_only": "integer",
  "matchings": [
    {
      "ecommerce_competitor_id": 1,
      "url": "https://www.mycompetitor.com/test-1.html",
      "title": "Test product 1",
      "composite_id": "EAN:8001090013019"
    }
  ]
}

200 OK

MatchingsImportSummary

Matchings import summary

Response Content-Types: application/json

Response Example (200 OK)

{
  "matchings": 100,
  "invalid_url": 1,
  "invalid_competitor_id": 0,
  "invalid_composite_id": 6
}


Bearer

E-commerce Competitors Management

Catalog List

GET /ecommerce/matchings

Matchings list

page

in query

integer

Page number

composite_id

in query

string

It allows to search specific matchings by the matched product's Composite ID

ecommerce_competitor_id

in query

integer

It allows to search matchings of a specific competitor by its ID

url

in query

string

It allows to search matchings for a specific url

200 OK

MatchingsResponse

Matchings 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": [
    {
      "matching_id": 30,
      "name": "My product",
      "status": "ready",
      "composite_id": "EAN:12345678901234",
      "competitor_url": "https://www.pricefy.io/my-product",
      "matching_type": "AUTO",
      "competitor_title": "Competitor Product Title",
      "competitor_brand": "Competitor Product Brand",
      "competitor_picture_url": "https://mycompetitor.com/product-picture.png",
      "similarity\"": 99,
      "ecommerce_competitor_id": 3
    }
  ]
}


Bearer

E-commerce Competitors Management

Delete a list of Matchings

DELETE /ecommerce/matchings

Delete a list of matchings

composite_id

in query

string

It allows to delete matchings by the matched product's Composite ID

ecommerce_competitor_id

in query

integer

It allows to delete matchings of a specific competitor by its ID

url

in query

string

It allows to delete matchings for a specific url

in query

integer

It allows to delete matchings by ID

200 OK

DeleteResponse

Generic success response

Response Content-Types: application/json

Response Example (200 OK)

{
  "deleted_rows": "integer"
}


Bearer

Schema Definitions

OkResponse:

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

Example

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

DeleteResponse:

deleted_rows: integer: the number of actually deleted rows

Example

{
  "deleted_rows": "integer"
}

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

CompetitorCatalogResponse:

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: CompetitorProduct

Example

{
  "current_page": "integer",
  "from": "integer",
  "to": "integer",
  "next_page_url": "string",
  "prev_page_url": "string",
  "path": "string",
  "per_page": "integer",
  "data": [
    {
      "pictureUrl": "https://www.mycompetitor.com/picture.org",
      "title": "The competitor product title",
      "brand": "The competitor product brand",
      "url": "https://www.mycompetitor.com/test.html",
      "price": 8.5,
      "currency": "EUR",
      "fetched_at": "2018-11-30 11:11:34",
      "matching_type": "AUTO",
      "matching_similarity": 2,
      "account_product_title": "My Product Title",
      "account_product_picture_url": "https://my-ecommerce.it/the-picture.png",
      "composite_id": "EAN:123456789010"
    }
  ]
}

MatchingsResponse:

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: Matching

Example

{
  "current_page": "integer",
  "from": "integer",
  "to": "integer",
  "next_page_url": "string",
  "prev_page_url": "string",
  "path": "string",
  "per_page": "integer",
  "data": [
    {
      "matching_id": 30,
      "name": "My product",
      "status": "ready",
      "composite_id": "EAN:12345678901234",
      "competitor_url": "https://www.pricefy.io/my-product",
      "matching_type": "AUTO",
      "competitor_title": "Competitor Product Title",
      "competitor_brand": "Competitor Product Brand",
      "competitor_picture_url": "https://mycompetitor.com/product-picture.png",
      "similarity\"": 99,
      "ecommerce_competitor_id": 3
    }
  ]
}

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:

name: string: Competitor name
url: string: Competitor product url (available for ecommerce competitors only)
competitor_id: integer: Competitor numerical ID
type: string: competitor type: ebay, amazon or ecommerce
competitor_price: number: competitor price
competitor_base_price: number: competitor price without discount
my_price: number: Account catalog price
price_diff: number: Difference between catalog price and competitor price
availability: string: Product availability (available for ecommerce competitors only)
fetch_status: string: Status of url checking: FOUND, NOT_FOUND, ERROR (available for ecommerce competitors only)
similarity: number: similarity with catalog's product (available for ecommerce competitors only)

Example

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

EcommerceCompetitor:

id: integer: E-commerce competitor ID
website_id: integer: E-commerce website ID
domain: string: E-commerce website domain
url_count: integer: E-commerce website detected urls (only for auto-detectings)

Example

{
  "id": 1,
  "website_id": 399,
  "domain": "https://www.my-competitor.com",
  "url_count": 520856
}

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
}

MatchingsImportSummary:

matchings: integer: submitted matchings
invalid_url: integer: number of skipped matchings for invalid url value
invalid_competitor_id: integer: number of skipped matchings for invalid ecommerce_competitor_id value
invalid_composite_id: integer: skipped products due to invalid composite_id

Example

{
  "matchings": 100,
  "invalid_url": 1,
  "invalid_competitor_id": 0,
  "invalid_composite_id": 6
}

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
brand: string: product Brand
ean: string: product EAN.
upc: string: product UPC.
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"
}

CompetitorProduct:

title: string: competitor product title
url: string: competitor product url
brand: string: competitor product brand
picture_url: string: competitor product picture url
price: number: competitor product price
currency: string: competitor product price currency
fetched_at: string: datetime of the last url fetch
matching_type: string: Type of matching (MANUAL or AUTO)
matching_similarity: number: Matching similarity
account_product_title: string: Matched account product title
account_product_picture_url: string: Matched account product picture url
composite_id: string: composite ID of the account product

Example

{
  "pictureUrl": "https://www.mycompetitor.com/picture.org",
  "title": "The competitor product title",
  "brand": "The competitor product brand",
  "url": "https://www.mycompetitor.com/test.html",
  "price": 8.5,
  "currency": "EUR",
  "fetched_at": "2018-11-30 11:11:34",
  "matching_type": "AUTO",
  "matching_similarity": 2,
  "account_product_title": "My Product Title",
  "account_product_picture_url": "https://my-ecommerce.it/the-picture.png",
  "composite_id": "EAN:123456789010"
}

MatchingData:

title: string: competitor product title
url: string: competitor product url
ecommerce_competitor_id: integer: Competitor ID
composite_id: string: Composite ID of the product you want to match the url with
brand: string: competitor product brand
picture_url: string: competitor product picture url

Example

{
  "ecommerce_competitor_id": 1,
  "url": "https://www.mycompetitor.com/test-1.html",
  "title": "Test product 1",
  "composite_id": "EAN:8001090013019"
}

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
sku: string: product SKU
brand: string: product brand
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"
}

Matching:

matching_id: integer: Matching ID
name: string: product name
composite_id: string: product Composite ID
status: string: any of ready, suspended, or deleted
competitor_url: string: Competitor product URL
matching_type: string: any of AUTO or MANUAL
competitor_title: string: Competitor product title
competitor_brand: string: Competitor product brand
competitor_picture_url: string: Competitor product picture url
similarity: integer: Matching similarity (used by auto matchings only)
ecommerce_competitor_id: integer: Competitor ID

Example

{
  "matching_id": 30,
  "name": "My product",
  "status": "ready",
  "composite_id": "EAN:12345678901234",
  "competitor_url": "https://www.pricefy.io/my-product",
  "matching_type": "AUTO",
  "competitor_title": "Competitor Product Title",
  "competitor_brand": "Competitor Product Brand",
  "competitor_picture_url": "https://mycompetitor.com/product-picture.png",
  "similarity\"": 99,
  "ecommerce_competitor_id": 3
}

Documentation by Spectacle