Listadum API
The Listadum API lets you programmatically access your store data, manage listings, and build custom integrations. Whether you want to automate bulk updates, connect Listadum to your own tools, or build reporting dashboards, the API gives you full flexibility.
Early access
The Listadum API is currently available as an early access feature. It will require an add-on to your subscription once generally available. To get access, reach out to our support team.
Documentation
The full API reference, including available endpoints, request and response formats, and authentication details, is available at:
The documentation is interactive and lets you try out API calls directly from your browser once you have an API key.
Managing API keys
API keys are used to authenticate your requests. You can create and manage your keys from your store settings, under the API tab.
When creating an API key, you can configure:
- Name: a label to help you identify what the key is used for (e.g. "My reporting script")
- Scopes: choose between Read (access store data) and Write (modify listings and store data) access
Only store owners can create and revoke API keys. For security, the full key is only shown once at creation. Make sure to copy it and store it securely.
If a key is compromised, you can revoke it at any time from the same settings page. Revoked keys stop working immediately.
Rate limiting
To ensure fair usage and platform stability, the API enforces rate limits on all endpoints. If you exceed the limit, requests will return a 429 Too Many Requests status code.
When rate limited, check the response headers for information on when you can retry. We recommend implementing exponential backoff in your integration to handle rate limits gracefully.
Rate limits are applied per API key. Using multiple keys for the same store does not increase your overall limit.
Best practices
- Use the most restrictive scope your integration needs. Prefer Read when you only need to fetch data
- Store your API keys securely and never expose them in client-side code or public repositories
- Implement proper error handling and respect rate limits with exponential backoff
- Rotate your keys periodically and revoke any that are no longer in use
Ready to dive in?
Start improving your shop today.
Connect your Etsy store to receive personalized recommendations to improve your shop and listings, get more views, and drive more sales.