{"id":14963030,"url":"https://github.com/dylanon/gatsby-source-etsy","last_synced_at":"2025-08-20T12:11:31.515Z","repository":{"id":35089172,"uuid":"205291757","full_name":"dylanon/gatsby-source-etsy","owner":"dylanon","description":"Gatsby.js plugin that sources listing info and images from your Etsy shop! 🛍","archived":false,"fork":false,"pushed_at":"2023-07-19T07:42:10.000Z","size":952,"stargazers_count":14,"open_issues_count":11,"forks_count":8,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-10-30T00:35:53.172Z","etag":null,"topics":["etsy","gatsby","gatsby-source","gatsby-source-plugin","gatsbyjs"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dylanon.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-08-30T02:46:14.000Z","updated_at":"2024-09-26T02:45:23.000Z","dependencies_parsed_at":"2024-06-21T03:56:06.221Z","dependency_job_id":"df8d39e1-3a24-491c-9d32-bde754672280","html_url":"https://github.com/dylanon/gatsby-source-etsy","commit_stats":{"total_commits":68,"total_committers":3,"mean_commits":"22.666666666666668","dds":0.08823529411764708,"last_synced_commit":"9d09d6807ac7435a09d9df966349cb43afafdd35"},"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dylanon%2Fgatsby-source-etsy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dylanon%2Fgatsby-source-etsy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dylanon%2Fgatsby-source-etsy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dylanon%2Fgatsby-source-etsy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dylanon","download_url":"https://codeload.github.com/dylanon/gatsby-source-etsy/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238053514,"owners_count":19408699,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["etsy","gatsby","gatsby-source","gatsby-source-plugin","gatsbyjs"],"created_at":"2024-09-24T13:30:56.055Z","updated_at":"2025-02-10T03:31:21.133Z","avatar_url":"https://github.com/dylanon.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# gatsby-source-etsy 🛍\n\n**Note: This plugin is no longer maintained.**\n\n[![Current npm package version](https://img.shields.io/npm/v/gatsby-source-etsy)](https://www.npmjs.com/package/gatsby-source-etsy)\n\nDownloads listing info and images from your Etsy shop!\n\n## Installation\n\n### Sites on Gatsby v3+\n\nInstall the package from npm:\n\n`npm i gatsby-source-etsy`\n\nInstall peer dependencies:\n\n`npm i gatsby-source-filesystem`\n\n### Sites on Gatsby v2\n\nInstall version 1 from npm:\n\n`npm i gatsby-source-etsy@release-1.x`\n\n### Sites on Gatsby v1\n\nGatsby v1 is not supported.\n\n## Configuration\n\nNext, add the plugin to your `gatsby-config.js` file:\n\n```javascript\nmodule.exports = {\n  plugins: [\n    {\n      resolve: 'gatsby-source-etsy',\n      options: {\n        api_key: 'your api key here',\n        shop_id: 'your shop id here',\n        // The following properties are optional - Most of them narrow the results returned from Etsy.\n        //\n        // You don't have to use them, and in fact, you probably shouldn't!\n        // You're probably here because you need to source *all* your listings.\n        language: 'en',\n        translate_keywords: true,\n        keywords: 'coffee',\n        sort_on: 'created',\n        sort_order: 'up',\n        min_price: 0.01,\n        max_price: 999.99,\n        color: '#333333',\n        color_accuracy: 0,\n        tags: 'diy,coffee,brewing',\n        taxonomy_id: 18,\n        include_private: true,\n      },\n    },\n  ],\n}\n```\n\nThis plugin supports the options specified in Etsy's documentation under [findAllShopListingsActive](https://www.etsy.com/developers/documentation/reference/listing#method_findallshoplistingsactive).\n\nFor information on the `language` and `translate_keywords` properties, please see [Searching Listings](https://www.etsy.com/developers/documentation/reference/listing#section_searching_listings).\n\n## Example GraphQL queries\n\nListing info:\n\n```graphql\n{\n  allEtsyListing(sort: { fields: featured_rank, order: ASC }, limit: 4) {\n    nodes {\n      currency_code\n      title\n      listing_id\n      price\n      url\n    }\n  }\n}\n```\n\nQuery transformed/optimized images for a listing (e.g. for use with `gatsby-image` - see below):\n\n```graphql\n{\n  allEtsyListing(sort: { fields: featured_rank, order: ASC }, limit: 4) {\n    nodes {\n      childrenEtsyListingImage {\n        rank\n        childFile {\n          childImageSharp {\n            fluid {\n              base64\n              tracedSVG\n              aspectRatio\n              src\n              srcSet\n              srcWebp\n              srcSetWebp\n              originalName\n              originalImg\n              presentationHeight\n              presentationWidth\n              sizes\n            }\n          }\n        }\n      }\n    }\n  }\n}\n```\n\n## Queryable entities\n\n- allEtsyListing\n- allEtsyListingImage\n- etsyListing\n  - childrenEtsyListingImage\n- etsyListingImage\n  - childFile\n\n## Usage with `gatsby-image`\n\nInstall the necessary packages:\n\n`npm install gatsby-image gatsby-plugin-sharp gatsby-transformer-sharp`\n\nQuery:\n\n```graphql\n{\n  etsyListing {\n    childrenEtsyListingImage {\n      childFile {\n        childImageSharp {\n          fluid {\n            ...GatsbyImageSharpFluid\n          }\n        }\n      }\n    }\n  }\n}\n```\n\nSee [`gatsby-image`](https://www.gatsbyjs.org/packages/gatsby-image/) for more.\n\n## Contributing\n\nDid something break, or is there additional functionality you'd like to add to this plugin? Consider contributing to this project!\n\nFeel free to open an issue to discuss what's happening first, or dive right in and open a PR.\n\n### Developing this plugin locally\n\nYou can use `yalc` to test changes you make to this plugin against a local Gatsby site:\n\n```bash\n# Install yalc globally on your system\nyarn global add yalc\n\n# Publish the package to your local repository\n# (Run this from this repo's root directory)\nyalc publish\n\n# Use the package from your local repository instead of one from npm\n# (Run this from your Gatsby site's root directory)\nyalc add gatsby-source-etsy\n```\n\nFor up-to-date information and troubleshooting, see `yalc`'s [documentation](https://github.com/wclr/yalc).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdylanon%2Fgatsby-source-etsy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdylanon%2Fgatsby-source-etsy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdylanon%2Fgatsby-source-etsy/lists"}