suggestions Query

Description

Retrieves item suggestions based on filters and criteria.

query suggestions(
  $limit: Int
  $id: Float
  $genre: String
  $style: String
  $type: String
  $styles: [String]
  $genres: [String]
  $categories: [String]
  $country: String
) {
  suggestions(
    limit: $limit
    id: $id
    genre: $genre
    style: $style
    type: $type
    styles: $styles
    genres: $genres
    categories: $categories
    country: $country
  ) {
    _id
    id
    created
    wanted
    path
    seo {
      index
      description
      slug
      title
    }
    uri
    type
    isForbiddenForSale
    data {
      title
      cat
      type
      manufacturer
      discogsId
      assetLink
      weight
      genres
      styles
      country
      releaseDate
      subtitle
      authors
      publisher
      publishedDate
      pageCount
      categories
      maturityRating
      language
      format
    }
    handle
    bitly
    descriptions {
      main
    }
    listings {
      _id
      id
      available
      preOrder
      secondHand
      categories
      onePerCustomer
      comments
    }
  }
}

Variables

{
    "limit": 20,
    "id": 30.7,
    "genre": "genre",
    "style": "style",
    "type": "type",
    "styles": [
        "styles"
    ],
    "genres": [
        "genres"
    ],
    "categories": [
        "categories"
    ],
    "country": "Canada"
}

Response

{
    "suggestions": [
        {
            "_id": "35a6acae49fcfb43257b2ed7",
            "id": 1.23,
            "created": 1708975807690,
            "wanted": true,
            "path": "/release/1763553751/release-artist-release-name",
            "seo": {
                "index": true,
                "description": "example",
                "slug": "example",
                "title": "example"
            },
            "uri": "https://www.my-common-ground-store.com/release/1763553751/release-artist-release-name",
            "type": "example",
            "isForbiddenForSale": true,
            "data": {
                "title": "example",
                "cat": "example",
                "type": "example",
                "manufacturer": "example",
                "discogsId": 987654321,
                "assetLink": "example",
                "weight": 1.23,
                "genres": [
                    "example"
                ],
                "styles": [
                    "example"
                ],
                "country": "example",
                "releaseDate": 1748393357442,
                "subtitle": "example",
                "authors": [
                    "example"
                ],
                "publisher": "example",
                "publishedDate": 1719818354050,
                "pageCount": 42,
                "categories": [
                    "example"
                ],
                "maturityRating": "example",
                "language": "example",
                "format": "example"
            },
            "handle": "example",
            "bitly": "example",
            "descriptions": {
                "main": "example"
            },
            "listings": [
                {
                    "_id": "68badd4ce0c397b167a88bba",
                    "id": 1.23,
                    "available": 1715428508138,
                    "preOrder": true,
                    "secondHand": true,
                    "categories": [
                        "example"
                    ],
                    "onePerCustomer": true,
                    "comments": "example"
                }
            ]
        }
    ]
}

Arguments

Name	Type	Description
limit	Int	Maximum number of suggestions to return.
id	Float	Item ID to base suggestions on.
genre	String	Filter by genre.
style	String	Filter by style.
type	String	Filter by item type.
styles	[String]	Filter by multiple styles.
genres	[String]	Filter by multiple genres.
categories	[String]	Filter by categories.
country	String	Filter by country.

Returns

[Item!]