Skip to content
Queries

sellers

The marketplace's active sellers, with their rating.

sellers returns every active seller in the marketplace. Use it for seller directories and filters.

sellers: [StorefrontSellerDto!]!

It takes no arguments. In a store that isn't a marketplace (store.type other than MARKETPLACE), it returns [].

StorefrontSellerDto

FieldTypeDescription
idString!Seller ID.
nameString!Name.
slugString!Slug for seller and products(input: { sellerSlugs }).
logoStringLogo URL.
bannerStringBanner URL.
taglineStringThe seller's short tagline.
verifiedBoolean!true when the seller is verified.
rating.averageDecimal!Average rating.
rating.totalReviewsInt!Reviews counted in the average.

Example

Sellers.graphql
query Sellers {
  sellers {
    id
    name
    slug
    logo
    verified
    rating { average totalReviews }
  }
}
Terminal
curl --request POST "https://storefront.ecomiq.pe/graphql" \
  --header "Content-Type: application/json" \
  --header "x-Store-Domain: my-store" \
  --data-binary '{
    "query": "query Sellers { sellers { id name slug logo verified rating { average totalReviews } } }"
  }'
Response
{
  "data": {
    "sellers": [
      {
        "id": "7204558912004325310",
        "name": "Acme",
        "slug": "acme",
        "logo": null,
        "verified": true,
        "rating": { "average": 4.5, "totalReviews": 10 }
      }
    ]
  }
}

Errors

CodeCause
STORE_CONTEXT_REQUIREDx-Store-Domain is missing or doesn't match a store.

REST equivalent

GET /v1/sellers returns the same list. In a store that isn't a marketplace it responds 404.

Last updated:

On this page