Skip to content
Guides
Queries

sellers

List sellers visible in the store and their public reputation.

Last updated:

sellers returns every active seller visible in the resolved context. Use it for marketplace directories, filters, and discovery pages.

Signature

sellers: [StorefrontSellerDto!]!

The query has no arguments and returns an empty list when no sellers are visible.

Fields

FieldTypeDescription
idString!Opaque public seller ID.
nameString!Public name.
slugString!Public slug used in links and by seller.
logoStringPublic logo URL or reference, when present.
rating.averageDecimal!Public rating average.
rating.totalReviewsInt!Number of reviews included in the average.

Query

Sellers.graphql
query Sellers {
  sellers {
    id
    name
    slug
    logo
    rating {
      average
      totalReviews
    }
  }
}

cURL

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 rating { average totalReviews } } }"
  }'

Response

Response
{
  "data": {
    "sellers": [
      {
        "id": "seller-1",
        "name": "Acme",
        "slug": "acme",
        "logo": null,
        "rating": {
          "average": 4.5,
          "totalReviews": 10
        }
      }
    ]
  }
}

Errors

CodeWhen it occurs
STORE_CONTEXT_REQUIREDx-Store-Domain cannot resolve a store.
NOT_FOUNDThe resolved store is no longer available.

Read GraphQL errors before using data.

On this page