JSON API – GET Fetch Amazon Listings

Overview

This endpoint retrieves Amazon marketplace listings managed through Feedvisor.

It allows integrators to programmatically retrieve listing configuration, pricing, inventory, and repricing settings using a JSON API request.

Common API behavior such as authentication, pagination, and filter syntax is described in:

JSON API – Listings (Overview & Common Concepts)

---

Endpoint

GET /external/{accountId}/v2/listings

Base URL

https://api-gateway.feedvisor.com

Example:

https://api-gateway.feedvisor.com/external/1234/v2/listings

---

Supported Query Parameters

All parameters are optional and may be combined.

Multiple filters are applied using logical AND.

Example:

GET /external/{accountId}/v2/listings?asin=B00ABC123&active=true

---

Listing Identifiers

Parameter	Description
asin	Amazon ASIN
parentASIN	Parent ASIN
sku	Seller SKU
parentSku	Parent SKU

---

Product Information

Parameter	Description
name	Product title
brand	Brand name
condition	Item condition
vendorName	Vendor name
vendorPartNumber	Vendor part number

---

Product Identifiers

Parameter	Description
upc	UPC code
ean	EAN code
isbn	ISBN identifier

---

Listing Status

Parameter	Description
active	Whether listing is active
repricerActivated	Whether Feedvisor repricer is enabled
repricingMethod	Repricing method
repricingStrategy	Repricing strategy
cohort	Listing cohort
listingComment	Listing comment

---

Inventory

Parameter	Description
warehouseInventory	Warehouse inventory
availableQuantity	Available inventory
fulfillableQuantity	Fulfillable inventory
reservedQuantity	Reserved inventory
unitsInPack	Units per pack
leadTime	Lead time in days
minQuantityForOrder	Minimum order quantity
isReplenishable	Replenishable indicator

---

Pricing & Cost

Parameter	Description
currentListingPrice	Current Amazon listing price
cost	Product cost
mapPrice	Minimum advertised price
additionalSellingCosts	Additional selling cost
additionalSellingCostPercent	Additional cost percent
isAdditionalSellingCostByPercent	Indicates if cost is percent-based
variableClosingFee	Variable closing fee

---

Repricing Configuration

Parameter	Description
floorPrice	Repricing floor price
ceilingPrice	Repricing ceiling price
floorMarkupPercent	Floor markup percent
ceilingMarkupPercent	Ceiling markup percent
competitivePriceThreshold	Competitive price threshold
competeAllChannels	Compete across all channels
totalDomination	Total domination strategy

---

Inventory Health Strategies

Parameter	Description
fbaExcessInventoryStateType	FBA excess inventory state
fbaLowStockInventoryStateType	FBA low stock state
fbaExcessInventoryStrategy	Strategy for excess inventory
fbaLowStockInventoryStateStrategy	Strategy for low stock inventory

---

Amazon AWD Inventory

Parameter	Description
totalAwdOnhandQuantity	AWD on-hand inventory
totalAwdInboundQuantity	AWD inbound inventory

---

Query Operations Guide

Query operations define how filters are applied.

---

Text-Based Query Operations

Operator	Meaning	Example
EQCS	Equals (case-sensitive)	[EQCS:Abcd]
NEQCS	Not equals (case-sensitive)	[NEQCS:abcd]
BW	Begins with	[BW:Ab]
EW	Ends with	[EW:cd]
CON	Contains	[CON:bc]
NCON	Not contains	[NCON:xyz]

---

Numeric Query Operations

Operator	Meaning	Example
RNG	In range	[RNG:5.5,12]
NRNG	Not in range	[NRNG:10.50,12]

---

Numeric & Date Operations

Operator	Meaning	Example
GT	Greater than	[GT:5.5]
GTE	Greater than or equal	[GTE:10]
LT	Less than	[LT:12]
LTE	Less than or equal	[LTE:9]
NGT	Not greater than	[NGT:9]
NLT	Not less than	[NLT:10]

---

Text & Numeric Operations

Operator	Meaning	Example
EQ	Equals	[EQ=10]
NEQ	Not equals	[NEQ=5.5]
IN	In list	[IN:5.5,10]

---

Example Request

GET /external/1234/v2/listings?asin=[EQCS:B00ABC123]&active=true&floorPrice=[RNG:10,20]

Authorization: Bearer YOUR_TOKEN

---

Example Response

{
  "totalItemsCount": 2,
  "totalPagesCount": 1,
  "page": 0,
  "items": [
    {
      "sku": "SKU 1",
      "asin": "B00C654321",
      "brand": "My Brand",
      "name": "my listings name",
      "active": true,
      "repricerActivated": true,
      "repricingMethod": "FIXED",
      "repricingStrategy": "NA",
      "floorPrice": 14.89,
      "ceilingPrice": 23.11,
      "currentListingPrice": 14.89,
      "cost": 4.09,
      "mapPrice": 1.0,
      "fulfillmentMethod": "FBM",
      "availableQuantity": 1300,
      "fulfillableQuantity": 1200,
      "reservedQuantity": null,
      "vendorName": "Vendor 1"
    }
  ]
}

---

Response Fields

Field	Description
totalItemsCount	Total number of matching items
totalPagesCount	Total number of pages
page	Current page returned
items	Array of listing configurations

Each item contains listing configuration attributes, including pricing, inventory, and repricing settings.

---

Important Notes

Pagination

Results are returned in pages.

Example response fields:

totalItemsCount
totalPagesCount
page

---

Filter Logic

All filters are applied using logical AND.

Example:

asin=[EQCS:B00ABC123]&active=true