Skip to content
Queries

seller

A seller's profile by slug: identity, links, rating and policies.

seller returns a seller's profile from their slug, with what a seller page needs: description, links, rating and policies.

seller(slug: String!): StorefrontSellerProfileDto!

Arguments

ArgumentTypeRule
slugString!Up to 100 characters. Surrounding spaces are trimmed.

StorefrontSellerProfileDto

FieldTypeDescription
idString!Seller ID.
nameString!Name.
slugString!Slug.
logoStringLogo URL.
bannerStringBanner URL.
taglineStringShort tagline.
verifiedBoolean!true when verified.
descriptionStringDescription.
linksStorefrontSellerLinksDto!website, facebook, instagram, tikTok, youTube, twitter, linkedIn and whatsApp, all String.
linkStyleSellerLinkStyle!ICONS or TEXT: how to display the links.
memberSinceDateTime!Date the seller joined the marketplace.
rating.averageDecimal!Average rating.
rating.totalReviewsInt!Reviews counted in the average.
deliveryPolicyStringDelivery policy.
privacyAndSecurityPolicyStringPrivacy and security policy.

Example

Seller.graphql
query Seller($slug: String!) {
  seller(slug: $slug) {
    id
    name
    slug
    logo
    description
    links { website instagram whatsApp }
    linkStyle
    rating { average totalReviews }
    deliveryPolicy
    privacyAndSecurityPolicy
  }
}
Terminal
curl --request POST "https://storefront.ecomiq.pe/graphql" \
  --header "Content-Type: application/json" \
  --header "x-Store-Domain: my-store" \
  --data-binary '{
    "query": "query Seller($slug: String!) { seller(slug: $slug) { id name slug logo description links { website instagram whatsApp } linkStyle rating { average totalReviews } deliveryPolicy privacyAndSecurityPolicy } }",
    "variables": { "slug": "acme" }
  }'
Response
{
  "data": {
    "seller": {
      "id": "7204558912004325310",
      "name": "Acme",
      "slug": "acme",
      "logo": null,
      "description": "Kitchen and tableware.",
      "links": { "website": "https://acme.pe", "instagram": null, "whatsApp": null },
      "linkStyle": "ICONS",
      "rating": { "average": 4.5, "totalReviews": 10 },
      "deliveryPolicy": "Delivery in 2 to 4 business days.",
      "privacyAndSecurityPolicy": null
    }
  }
}

Errors

CodeCause
BAD_USER_INPUTslug is empty or longer than 100 characters.
NOT_FOUNDThe seller doesn't exist in the store.
STORE_CONTEXT_REQUIREDx-Store-Domain is missing or doesn't match a store.

REST equivalent

GET /v1/sellers/{slug} returns the same profile.

Last updated:

On this page