Queries
seller
Retrieve a seller's public profile and policies by slug.
Last updated:
seller returns a seller visible in the resolved store. In addition to identity and reputation, it exposes policies that can be shown on the seller's storefront.
Signature
seller(slug: String!): StorefrontSellerProfileDto!Arguments
| Argument | Type | Rule |
|---|---|---|
slug | String! | Required. It is trimmed before lookup, cannot be empty, and accepts up to 100 characters. |
Fields
| Field | Type | Description |
|---|---|---|
id | String! | Opaque public seller ID. |
name | String! | Public name. |
slug | String! | Public slug. |
logo | String | Public logo URL or reference. |
rating.average | Decimal! | Public rating average. |
rating.totalReviews | Int! | Number of reviews included. |
deliveryPolicy | String | Public delivery policy, when configured. |
privacyAndSecurityPolicy | String | Public privacy and security policy, when configured. |
Query
query Seller($slug: String!) {
seller(slug: $slug) {
id
name
slug
logo
rating {
average
totalReviews
}
deliveryPolicy
privacyAndSecurityPolicy
}
}{
"slug": "acme"
}cURL
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 rating { average totalReviews } deliveryPolicy privacyAndSecurityPolicy } }",
"variables": { "slug": "acme" }
}'Response
{
"data": {
"seller": {
"id": "456",
"name": "Acme",
"slug": "acme",
"logo": null,
"rating": {
"average": 4.5,
"totalReviews": 10
},
"deliveryPolicy": "Delivery in 2 to 4 business days.",
"privacyAndSecurityPolicy": null
}
}
}Errors
| Code | When it occurs |
|---|---|
BAD_USER_INPUT | slug is empty or exceeds 100 characters. |
NOT_FOUND | The seller does not exist or is not visible in the store. |
STORE_CONTEXT_REQUIRED | x-Store-Domain cannot resolve a store. |