POST /artworks/byCreator

Search for a creator's artworks

POST https://api.mallow.art/v1/artworks/byCreator

Returns artwork info for artworks created by the given creator address. Each page contains 30 results.

Request Body

Name	Type	Description
page*	number	Page to fetch. Starts at 0.
sort*	string	Sort by recently-listed or ending-soon
filter.creator*	string	Creator's address
filter.listingTypes	string[]	Listing types to filter by. Can be any of auction, buy-now, raffle, unlisted. Omit field to get artworks in any state.
filter.includeLinkedWallets	boolean	Include artworks created by the creator's linked wallets, defaults to false.

200 Listed artwork results

{
    "result": [{
        "url": "https://mallow.art/artwork/5Y44wPAX3yJButY74AfRKt8sFbZTXGZwxDmp9Uqfbyjd",
        "mintAccount": "5Y44wPAX3yJButY74AfRKt8sFbZTXGZwxDmp9Uqfbyjd",
        "description": "Dr. Guulileo Guunstein, also known as Dr. Guu, is a mastermind of boundless ingenuity. His origins trace back to the unique realm known as the Guuniverse. Despite the \"Dr.\" title, Guulileo reigns as a revered professor in the intricate field of Biology, with his intellect devoted to unraveling the various lifeforms roaming the Web3 space.\n\nJourneying alongside him is Deniguu, a pint-sized companion with an extraordinary gift – the ability to replicate the chemical elements of whatever she consumes. Her unique ability stands as a vital tool in Dr. Guu's relentless pursuit of knowledge.\n\nAdorned with mystical Nenju beads, an heirloom granted by a benevolent monk, and the bio earring gifted by Lucha, Dr. Guu exists in an ethereal threshold, bridging the realms of science and the extraordinary.\n\n\"Magnificent! Absolutely marvelous!\"\n\nHe tilts his glasses while reviewing specimens, a mix of amazement and curiosity filling his eyes.",
        "imageUrl": "https://shdw-drive.genesysgo.net/2iHNWQtfUsth1F7dy6Mtjr9dHmYPZN7TZS4W2GcEwNTE/94ab618a2ed72f7e42a3d1a0728b55bf.png",
        "isImmutable": false,
        "listingType": "buy-now", // "auction", "raffle"
        "metadataUrl": "https://shdw-drive.genesysgo.net/2iHNWQtfUsth1F7dy6Mtjr9dHmYPZN7TZS4W2GcEwNTE/ecd5372f11084aeee4bd8d6f377a61ca.json",
        "name": "[003] Tiiiny \"Dr.Guu\" Rover",
        "creator": "DsSqaaKvuzkexQophftgPJqZqVi3Ki7VQcpGSwnXe9WZ",
        "owner": "Dyi3AeQcDKPhXLdsF2Avihh1ty43REGuCRGKvU8QEAAd",
        "videoUrl": "https://shdw-drive.genesysgo.net/2iHNWQtfUsth1F7dy6Mtjr9dHmYPZN7TZS4W2GcEwNTE/8e8ac3b818969a07c2f9415c512c56c3.mp4",
        "editionAccount": "4n4jNyMi9vmNLBC7p4hC3D1uRM3B6voju9Kz6cyCcUam",
        "maxSupply": 0, // 0 = 1/1, > 0 = limited edition, null = open edition
        "supply": 0,
        "currentUsdPrice": 2004.20,
        "buyNowMetadata": {
            "date": "2024-01-20T18:44:27.000Z",
            "amount": 20000000000,
            "currencyMint": "So11111111111111111111111111111111111111112",
            "listingAccount": "7SWB1aRhQBnqSrbuXQEZ8FybNEAY3ZHGbSdLzZGHW7uQ",
            "startsAt": "2024-01-20T18:44:27.000Z",
            "buyerSetsPrice": false,
            "editionsLimit": 0
        },
        "listingMetadata": {
            "isLive": false,
            "listedAt": "2024-01-22T19:19:23.000Z",
            // Optional fields
            "endsAt": "2024-01-30T19:19:23.000Z",
            "whitelistConfig": {
                "collectionsOrCreators": [
                    "5bLLG5gQLU2htdScXdyXYTFp8t1XqXTEiQbinj5ys5FF"
                ],
                "duration": 172800,
                "endsAt": "2024-01-26T17:11:00.000Z"
            },
            "rewardsDescription": "after sell out, there are 2 prizes you can win by holding an edition in your wallet.\ni. a 308 satin 11x14 white bordered premium fine art print\nii. a 1/1 from my long form photography collection ‘moments past’\nthe more editions you hold the higher your chances"
        },
        // If listed on auction
        "auctionMetadata": AuctionMetadata,
        // If listed on raffle
        "raffleMetadata": {
            "wlCreators": [],
            "entrants": [
                "6KjW9hT3YNqH3VMr7VvwfhLjorNRJREMBYfafsaYtKCu"
            ],
            "creator": "3aLqEkFQCMqnThGeXJg87XmJFThGuGWmK6Q1PhciqxTK",
            "entrantsAccount": "6dzkWokQa4XViXTGRXRX2huoAUX6rKC3REMz6uPyh85C",
            "raffleAccount": "DsfWd5AFQJYgdP7YUqoUUHiF54yNsyoESAJMgotuvorD",
            "countByEntrant": {
                "6KjW9hT3YNqH3VMr7VvwfhLjorNRJREMBYfafsaYtKCu": 1
            },
            "currencyMint": "So11111111111111111111111111111111111111112",
            "endsAt": "2024-01-24T14:59:04.000Z",
            "isExpired": false,
            "price": 69000000,
            "sold": 1,
            "supply": 50,
            "ticketLimit": 0,
        },
        // On edition prints only
        "editionNumber": 14
    }],
    // Total number of listings matching the filter
    "total": 1,
    // Present when another page is available
    "nextPage": 1
}

401 Permission denied

{
    "error": { 
        "message": "Invalid API Key" 
    }
}

400: Bad Request Bad request

{
    "error": { 
        "message": "Missing search params" 
    }
}