AMALYZE Falcon API

portfolios

Endpoint

Endpoint portfolios searches for portfolios (available for merchants, brands, categories and custom portfolios)

Method
POST portfolios
Example call

JSON Payload

PropertyTypeDescriptionFurther informationVersion
filters.marketplacestringString containing the marketplace idvalid marketplaces ids0.4.0
filters.typestringString containing the portfolios type
  • brand
  • merchant
  • category
  • custom
0.4.0
filters.statusstringString containing the portfolios status
  • active
  • paused
  • archived
0.5.0
  • brand
  • brand
  • brand
  • brand
  • 0.4.0
  • merchant
  • merchant
  • merchant
  • merchant
  • 0.4.0
  • category
  • category
  • category
  • category
  • 0.4.0
  • custom
  • custom
  • custom
  • custom
  • 0.4.0
    0.4.00.4.00.4.0
    filters.visiblesTotal.minintegerMinimumoptional0.4.0
    filters.visiblesTotal.maxintegerMaximumoptional0.4.0
    filters.visiblesRateobjectRate of visible ASINs within the portfoliooptional0.4.0
    filters.visiblesRate.minfloatMinimumoptional0.4.0
    filters.visiblesRate.maxfloatMaximumoptional0.4.0
    filters.primeTotalobjectNumber of ASINs offered as Prime within in the portfoliooptional0.4.0
    filters.primeTotal.minintegerMinimumoptional0.4.0
    filters.primeTotal.maxintegerMaximumoptional0.4.0
    filters.primeRateobjectRate of ASINs offered as Prime within in the portfoliooptional0.4.0
    filters.primeRate.minfloatMinimumoptional0.4.0
    filters.primeRate.maxfloatMaximumoptional0.4.0
    filters.bsrMainRankAvgobjectAverage BSR (main category) of ASINs within the portfoliooptional0.4.0
    filters.bsrMainRankAvg.minfloatMinimumoptional0.4.0
    filters.bsrMainRankAvg.maxfloatMaximumoptional0.4.0
    filters.offersAvgobjectAverage number of offers of ASINs within the portfoliooptional0.4.0
    filters.offersAvg.minfloatMinimumoptional0.4.0
    filters.offersAvg.maxfloatMaximumoptional0.4.0
    filters.buyboxTotalobjectNumber of ASINs having a Buyboxoptional0.4.0
    filters.buyboxTotal.minintegerMinimumoptional0.4.0
    filters.buyboxTotal.maxintegerMaximumoptional0.4.0
    filters.buyboxAmountobjectAverage amount of Buyboxesoptional0.4.0
    filters.buyboxAmount.minfloatMinimumoptional0.4.0
    filters.buyboxAmount.maxfloatMaximumoptional0.4.0
    filters.buyboxRateobjectRate of ASINs having a Buyboxoptional0.4.0
    filters.buyboxRate.minfloatMinimumoptional0.4.0
    filters.buyboxRate.maxfloatMaximumoptional0.4.0
    filters.buyboxMerchantsobjectNumber of differnt merchants having a Buyboxoptional0.4.0
    filters.buyboxMerchants.minintegerMinimumoptional0.4.0
    filters.buyboxMerchants.maxintegerMaximumoptional0.4.0
    filters.subscriptionsTotalobjectNumber of ASINs available as "subscribe & save"optional0.4.0
    filters.subscriptionsTotal.minintegerMinimumoptional0.4.0
    filters.subscriptionsTotal.maxintegerMaximumoptional0.4.0
    filters.subscriptionsRateobjectRate of ASINs having available as "subscribe & save"optional0.4.0
    filters.subscriptionsRate.minfloatMinimumoptional0.4.0
    filters.subscriptionsRate.maxfloatMaximumoptional0.4.0
    filters.typesStandalonesTotalobjectNumber of standalone ASINs (non-variations)optional0.4.0
    filters.typesStandalonesTotal.minintegerMinimumoptional0.4.0
    filters.typesStandalonesTotal.maxintegerMaximumoptional0.4.0
    filters.typesStandalonesRateobjectRate of standalone ASINs (non-variations)optional0.4.0
    filters.typesStandalonesRate.minintegerMinimumoptional0.4.0
    filters.typesStandalonesRate.maxintegerMaximumoptional0.4.0
    filters.typesVariationsTotalobjectNumber of variationsoptional0.4.0
    filters.typesVariationsTotal.minintegerMinimumoptional0.4.0
    filters.typesVariationsTotal.maxintegerMaximumoptional0.4.0
    filters.typesVariationsRateobjectRate of variationsoptional0.4.0
    filters.typesVariationsRate.minfloatMinimumoptional0.4.0
    filters.typesVariationsRate.maxfloatMaximumoptional0.4.0
    filters.bestsellersTotalobjectNumber of ASINs having a bestseller badgeoptional0.4.0
    filters.bestsellersTotal.minintegerMinimumoptional0.4.0
    filters.bestsellersTotal.maxintegerMaximumoptional0.4.0
    filters.bestsellersRateobjectRate of ASINs having a bestseller badgeoptional0.4.0
    filters.bestsellersRate.minfloatMinimumoptional0.4.0
    filters.bestsellersRate.maxfloatMaximumoptional0.4.0
    filters.ratingAllAvgobjectAverage rating (stars) for all ASINsoptional0.4.0
    filters.ratingAllAvg.minfloatMinimumoptional0.4.0
    filters.ratingAllAvg.maxfloatMaximumoptional0.4.0
    filters.ratingExistsAvgobjectAverage rating (stars) for all ASINs having at least one reviewoptional0.4.0
    filters.ratingExistsAvg.minfloatMinimumoptional0.4.0
    filters.ratingExistsAvg.maxfloatMaximumoptional0.4.0
    filters.reviewsAllAvgobjectAverage number of reviews for all ASINsoptional0.4.0
    filters.reviewsAllAvg.minfloatMinimumoptional0.4.0
    filters.reviewsAllAvg.maxfloatMaximumoptional0.4.0
    filters.reviewsExistsAvgobjectAverage number of reviews for all ASINs having at least one reviewoptional0.4.0
    filters.reviewsExistsAvg.minfloatMinimumoptional0.4.0
    filters.reviewsExistsAvg.maxfloatMaximumoptional0.4.0
    filters.plusTotalobjectNumber of ASINs available as Plusoptional0.4.0
    filters.plusTotal.minintegerMinimumoptional0.4.0
    filters.plusTotal.maxintegerMaximumoptional0.4.0
    filters.plusRateobjectRate of ASINs available as Plusoptional0.4.0
    filters.plusRate.minfloatMinimumoptional0.4.0
    filters.plusRate.maxfloatMaximumoptional0.4.0
    filters.rankingsOrganicPositionAvgobjectAverage position of organic rankingsoptional0.4.0
    filters.rankingsOrganicPositionAvg.minfloatMinimumoptional0.4.0
    filters.rankingsOrganicPositionAvg.maxfloatMaximumoptional0.4.0
    filters.rankingsOrganicRankingsAvgobjectNumber of organic rankingsoptional0.4.0
    filters.rankingsOrganicRankingsAvg.minfloatMinimumoptional0.4.0
    filters.rankingsOrganicRankingsAvg.maxfloatMaximumoptional0.4.0
    filters.rankingsOrganicChoicesAvgobjectAverage number, each ASIN has a choice badgeoptional0.4.0
    filters.rankingsOrganicChoicesAvg.minfloatMinimumoptional0.4.0
    filters.rankingsOrganicChoicesAvg.maxfloatMaximumoptional0.4.0
    filters.promotionsTotalobjectNumber of ASINs having a promotionoptional0.4.0
    filters.promotionsTotal.minintegerMinimumoptional0.4.0
    filters.promotionsTotal.maxintegerMaximumoptional0.4.0
    filters.promotionsRateobjectRate of ASINs having a promotionoptional0.4.0
    filters.promotionsRate.minfloatMinimumoptional0.4.0
    filters.promotionsRate.maxfloatMaximumoptional0.4.0
    filters.statsAsAvgobjectAverage AMASCORE for all ASINsoptional0.4.0
    filters.statsAsAvg.minfloatMinimumoptional0.4.0
    filters.statsAsAvg.maxfloatMaximumoptional0.4.0
    paginationobjectObject containing the pagination informationpagination object definition0.4.0
    sortingarrayArray containing the sorting information0.4.0
    sorting.columnstringThe column to sort
    • score
    • marketplace.id
    • name
    • status
    • visibles.total
    • visibles.rate
    • prime.total
    • prime.rate
    • bsr.main.avg
    • offers.avg
    • buybox.total
    • buybox.amount.avg
    • buybox.rate
    • buybox.merchants
    • subscriptions.total
    • subscriptions.rate
    • types.standalones.total
    • types.standalones.rate
    • types.variations.total
    • types.variations.rate
    • bestsellers.total
    • bestsellers.rate
    • rating.all.avg
    • rating.exists.avg
    • reviews.all.avg
    • reviews.exists.avg
    • plus.total
    • plus.rate
    • rankings.organic.position.avg
    • rankings.organic.rankings,avg
    • rankings.choices.avg
    • promotions.total
    • promotions.rate
    • stats.as.avg
    • timestamp.update
    0.4.0
    sorting.directionstringThe direction to sortvalid direction values0.4.0
    JSON Response

    PropertyTypeDescriptionVersion
    itemsarrayArray containing the portfolio items0.4.0
    items.scorefloatInternal match score0.4.0
    items.typestringPortfolios type
    • brand
    • merchant
    • category
    • custom
    0.4.0
    items.namestringPortfolios name0.4.0
    items.subscriptionobjectObject containing information, if the account is subscribed to the portfolio0.4.0
    items.subscription.usersarrayArray containing the user ids, which shall received the portfolio report via email0.4.0
    items..subscription.subscribedbooleanIndicates, if the account has subscribed to this portfolio0.4.0
    items.marketplaceobjectObject containing the marketplace information0.4.0
    items.marketplace.idstringThe marketplace ID for the returned product (see marketplace definitions for more informations.0.4.0
    items.marketplace.namestringMarketplace name0.4.0
    items.totalobjectObject containing information about the total number of ASINs within the portfolio0.4.0
    items.total.currentintegerThe number of total ASINs within the portfolio0.4.0
    items.total.historyarrayArray containing the last 10 items of items.total.current0.4.0
    items.visiblesobjectObject containing information about the visible ASINs within the portfolio0.4.0
    items.visibles.totalobjectObject containing information about the number of visible ASINs within the portfolio0.4.0
    items.visibles.total.currentintegerNumber of visible ASINs within the portfolio0.4.0
    items.visibles.total.historyarrayArray containing the last 10 items of items.visibles.total.current0.4.0
    items.visibles.rateobjectObject containing information about the rate of visible ASINs within the portfolio0.4.0
    items.visibles.rate.currentfloatRate of visible ASINs within the portfolio0.4.0
    items.visibles.rate.historyarrayArray containing the last 10 items of items.visibles.rate.current0.4.0
    items.primeobjectObject containing information about the visible ASINs within the portfolio, available as Prime0.4.0
    items.prime.totalobjectObject containing information about the number of visible ASINs within the portfolio, available as Prime0.4.0
    items.prime.total.currentintegerNumber of visible ASIns within the portfolio available as Prime0.4.0
    items.prime.total.historyarrayArray containing the last 10 items of items.prime.total.current.0.4.0
    items.prime.rateobjectObject containing information about the rate of visible ASINs within the portfolio, available as Prime0.4.0
    items.prime.rate.currentfloatRate of visible ASIns within the portfolio available as Prime0.4.0
    items.prime.rate.historyarrayArray containing the last 10 items of items.prime.rate.current.0.4.0
    items.bsrobjectObject containing information about the BSRs of visible ASINs within the portfolio0.4.0
    items.bsr.mainobjectObject containing information about the (main category) BSRs of visible ASINs within the portfolio0.4.0
    items.bsr.main.rankobject0.4.0
    items.bsr.main.rank.avgobjectObject containing information about the average (main category) BSRs of visible ASINs within the portfolio0.4.0
    items.bsr.main.rank.avg.currentfloatAverage (main category) BSRs of visible ASINs within the portfolio0.4.0
    items.bsr.main.rank.avg.historyarrayArray containing the last 10 items of items.bsr.main.rank.avg.history.0.4.0
    items.offersobjectObject containing about the number of offers of visible ASINs within the portfolio0.4.0
    items.offers.avgobjectObject containing about the average number of offers of visible ASINs within the portfolio0.4.0
    items.offers.avg.currentIntegerNumber of average offers of visible ASINs within the portfolio0.4.0
    items.offers.avg.historyarrayArray containing the last 10 items of items.offers.avg.history.0.4.0
    items.buyboxobjectObject containing information about visible ASINs within the portfolio, having a buybox0.4.0
    items.buybox.totalobjectObject containing information about the number of visible ASINs within the portfolio, having a buybox0.4.0
    items.buybox.total.currentintegerNumber of visible ASINs within the portfolio, having a buybox0.4.0
    items.buybox.total.historyarrayArray containing the last 10 items of items.buybox.total.history.0.4.0
    items.buybox.amountobjectObject containing information about the amount of visible ASINs within the portfolio, having a buybox0.4.0
    items.buybox.amount.avgobjectObject containing information about the average amount of visible ASINs within the portfolio, having a buybox0.4.0
    items.buybox.amount.avg.currentfloatAverage amount of visible ASINs within the portfolio, having a buybox0.4.0
    items.buybox.amount.avg.historyarrayArray containing the last 10 items of items.buybox.amount.avg.current.0.4.0
    items.buybox.rateobjectObject containing information about the rate of visible ASINs within the portfolio, having a buybox0.4.0
    items.buybox.rate.currentfloatRate of visible ASIns within the portfolio, having a buybox0.4.0
    items.buybox.rate.historyarrayArray containing the last 10 items of items.buybox.rate.current.0.4.0
    items.buybox.merchantsobjectObject containing information about the number of different merchants owning the buybox for visible ASINs within the portfolio0.4.0
    items.buybox.merchants.currentintegerNumber of different merchants owning the buybox for visible ASINs within the portfolio0.4.0
    items.buybox.merchants.historyarrayArray containing the last 10 items of items.buybox.merchants.current.0.4.0
    items.subscriptionsobjectObject containing information about the visible ASINs within the portfolio being offered as "subscribe & save"0.4.0
    items.subscriptions.totalobjectObject containing information about the number of visible ASINs within the portfolio being offered as "subscribe & save"0.4.0
    items.subscriptions.total.currentintegerNumber of visible ASINs within the portfolio being offered as "subscribe & save"0.4.0
    items.subscriptions.total.historyarrayArray containing the last 10 items of items.subscriptions.total.current.0.4.0
    items.subscriotions.total.rateobjectObject containing information about the rate of visible ASINs within the portfolio being offered as "subscribe & save"0.4.0
    items.subscriotions.total.rate.currentfloatRate of visible ASINs within the portfolio being offered as "subscribe & save"0.4.0
    items.subscriotions.total.rate.historyarrayArray containing the last 10 items of items.subscriptions.rate.current.0.4.0
    items.typesobjectObject containing information about the types of visible ASINs within the portfolio0.4.0
    items.types.standalonesobjectObject containing information about the visible ASINs (standalones, non-variations) within the portfolio0.4.0
    items.types.standalones.totalobjectObject containing information about the number of visible ASINs (standalones, non-variations) within the portfolio0.4.0
    items.types.standalones.total.currentintegerNumber of visible ASINs (standalones, non-variations) within the portfolio0.4.0
    items.types.standalones.total.historyarrayArray containing the last 10 items of items.types.standalones.total.current.0.4.0
    items.types.standalones.rateobjectObject containing information about the rate of visible ASINs (standalones non-variations) within the portfolio0.4.0
    items.types.standalones.rate.currentfloatRate of standalones (non-variations) visible ASINs within the portfolio0.4.0
    items.types.standalones.rate.historyarrayArray containing the last 10 items of items.types.standalones.rate.current.0.4.0
    items.types.variationsobjectObject containing information about the visible ASINs (variations) within the portfolio0.4.0
    items.types.variations.totalobjectObject containing information about the number of visible ASINs (variations) within the portfolio0.4.0
    items.types.variations.total.currentintegerNumber of visible ASINs (variations) within the portfolio0.4.0
    items.types.variations.total.historyarrayArray containing the last 10 items of items.types.variations.total.current.0.4.0
    items.bestsellersobjectObject containing information about the visible ASINs within the portfolio, having a bestseller badge0.4.0
    items.bestsellers.totalobjectObject containing information about the number of visible ASINs within the portfolio, having a bestseller badge0.4.0
    items.bestsellers.total.curentintegerNumber of visible ASINs within the portfolio, having a bestseller badge0.4.0
    items.bestsellers.total.historyarrayArray containing the last 10 items of items.bestsellers.total.current.0.4.0
    items.bestsellers.rateobjectObject containing information about the rate of visible ASINs within the portfolio, having a bestseller badge0.4.0
    items.bestsellers.rate.currentfloatRate of visible ASINs within the portfolio, having a bestseller badge0.4.0
    items.bestsellers.rate.historyarrayArray containing the last 10 items of items.bestsellers.rate.current.0.4.0
    items.ratingobjectObject containing information about the rating (stars) of visible ASINs within the portfolio0.4.0
    items.rating.allobjectObject containing information about the rating (stars) of visible ASINs within the portfolio (regardless, if they have at least one review)0.4.0
    items.rating.all.avgobjectObject containing information about the average rating (stars) of visible ASINs within the portfolio (regardless, if they have at least one review)0.4.0
    items.rating.all.avg.currentfloatAverage rating (stars) of visible ASINs within the portfolio (regardless, if they have at least one review)0.4.0
    items.rating.all.avg.historyarrayArray containing the last 10 items of items.rating.all.avg.current.0.4.0
    items.rating.existsobjectObject containing information about the rating (stars) of visible ASINs within the portfolio (having at least one review)0.4.0
    items.rating.exists.avgobjectObject containing information about the average rating (stars) of visible ASINs within the portfolio (having at least one review)0.4.0
    items.rating.exists.avg.currentfloatAverage rating (stars) of visible ASINs within the portfolio (having at least one review)0.4.0
    items.rating.exists.avg.historyarrayArray containing the last 10 items of items.rating.exists.avg.current.0.4.0
    items.reviewsobjectObject containing information about the number of reviews of visible ASINs within the portfolio0.4.0
    items.reviews.allobjectObject containing information about the number of reviews of visible ASINs within the portfolio (regardless, if they have at least one review)0.4.0
    items.reviews.all.avgobjectObject containing information about the average number reviews of visible ASINs within the portfolio (regardless, if they have at least one review)0.4.0
    items.reviews.all.avg.currentintegerAverage number reviews of visible ASINs within the portfolio (regardless, if they have at least one review)0.4.0
    items.reviews.all.avg.historyarrayArray containing the last 10 items of items.reviews.all.avg.current.0.4.0
    items.reviews.existsobjectObject containing information about the number of reviews of visible ASINs within the portfolio (having at least one review)0.4.0
    items.reviews.exists.avgobjectObject containing information about the average number reviews of visible ASINs within the portfolio (having at least one review)0.4.0
    items.reviews.exists.avg.currentintegerAverage number reviews of visible ASINs within the portfolio (having at least one review)0.4.0
    items.reviews.exists.avg.historyarrayArray containing the last 10 items of items.reviews.exists.avg.current.0.4.0
    items.rankingsobjectObject containing information about the rankings of visible ASINs within the portfolio0.4.0
    items.rankings.organicobjectObject containing information about the organic rankings of visible ASINs within the portfolio0.4.0
    items.rankings.organic.positionobjectObject containing information about the position of organic rankings of visible ASINs within the portfolio0.4.0
    items.rankings.organic.position.avgobjectObject containing information about the average position of organic rankings of visible ASINs within the portfolio0.4.0
    items.rankings.organic.position.avg.currentflaotThe average position of organic rankings of visible ASINs within the portfolio0.4.0
    items.rankings.organic.position.avg.historyarrayArray containing the last 10 items of items.rankings.organic.position.avg.history.0.4.0
    items.rankings.organic.rankingsobjectObject containing information about the number of organic rankings of visible ASINs within the portfolio0.4.0
    items.rankings.organic.rankings.avgobjectObject containing information about the average number of organic rankings of visible ASINs within the portfolio0.4.0
    items.rankings.organic.rankings.avg.currentfloatThe average number of organic rankings of visible ASINs within the portfolio0.4.0
    items.rankings.organic.rankings.avg.historyarrayArray containing the last 10 items of items.rankings.organic.rankings.avg.current.0.4.0
    items.rankings.organic.choicesobjectObject containing information about the number of choice badges, the visible ASINs within the portfolio have0.4.0
    items.rankings.organic.choices.avgobjectObject containing information about the average number of choice badges, the visible ASINs within the portfolio have0.4.0
    items.rankings.organic.choices.avg.currentfloatThe average number of choice badges, the visible ASINs within the portfolio have0.4.0
    items.rankings.organic.choices.avg.historyarrayArray containing the last 10 items of items.rankings.organic.choices.avg.current.0.4.0
    items.promotionsobjectObject containing information about the promotions of the visible ASINs within the portfolio0.4.0
    items.promotions.totalobjectObject containing information about the number of promotions of the visible ASINs within the portfolio0.4.0
    items.promotions.total.currentintegerThe number of promotions of the visible ASINs within the portfolio0.4.0
    items.promotions.total.historyarrayArray containing the last 10 items of items.promotions.total.current.0.4.0
    statsobjectObject containing general stats of the visible ASINs within the portfolio0.4.0
    stats.asobjectObject containing information about the AMASCORE of the visible ASINs within the portfolio0.4.0
    stats.as.avgobjectObject containing information about the average AMASCORE of the visible ASINs within the portfolio0.4.0
    stats.as.avg.currentfloatThe average AMASCORE of the visible ASINs within the portfolio0.4.0
    stats.as.avg.historyarrayArray containing the last 10 items of stats.as.avg.current.0.4.0
    timestampsobjectObject containing timestamp of the portfolio0.4.0
    timestamps.createdateTimePortfolios creation timestamp0.4.0
    timestamps.updatedateTimePortfolios last-update timestamp0.4.0
    requestobjectThe request information object (see Request information for more information)0.4.0
    Updates / Changes
    VersionDescription
    0.5.0added filters.status
    added status as valid column to sort for
    0.4.0created
    Menu