Adding SEMA Data as a Vendor (API)
Pull product data for your approved SEMA Data brands straight from the SEMA Data API into a catalog you can push to your store.
SEMA Data as a vendor is a catalog-only source. It brings in product titles, descriptions, images and other product data for the brands you're approved for. It doesn't update stock, send orders or bring back tracking, so you'll still need the supplier that actually ships the parts set up as its own vendor.
Already have a vendor such as Keystone and want to fill in its product data from SEMA? Use How to Enrich Your Vendors Catalog Using the SEMA Data Reseller API instead.
What you need from SEMA Data
- A SEMA Data Co-op reseller account. Joining is free for resellers. Sign up at www.semadata.org under Resellers, or email info@semadatacoop.org. See How to Sign Up for SEMA Data.
- A subscription with API access. Since April 8, 2024, SEMA Data requires a paid subscription to use the API. Ask SEMA Data to make sure your plan includes API access and API calls.
- Brand approvals. Log in to apps.semadata.org, click Brand Data, find each brand and click Request Data. The brand's supplier has to approve each request. Brands without an approval don't return any data.
1. Add the vendor and connect
- Go to Vendors, find SemaData in the integrations list and click Add Vendor.
- Click Credentials and enter:
- API Username and API Password: the same username and password you use to log in to the SEMA Data portal.
- Skip Fitment Data: leave this checked (it's the default). Fitment takes one extra API call per product, which can turn a catalog pull of minutes into hours and use up your API calls.
- Click Test Connection.
A successful test loads the list of brands you're approved for. If it says "Connected successfully, but no brands were found", your brand requests haven't been approved yet. Test again once they are.
2. Choose your brands
- Click Options.
- In Selected Brands AAIDs for Catalog, pick the brands to import. You have to choose at least one; the catalog won't run without a selection.
- Optional: check Include Prop65 Image to keep Prop 65 warning graphics. They're skipped by default, and when included they're added as the last image so they never become the main photo.
- Save.
The brand list only refreshes when you test the connection, so after SEMA approves a new brand, click Test Connection again and then select it.
How SKUs are built
SEMA Data identifies parts by brand and part number, so each catalog item's vendor SKU is the brand's AAIA ID and the part number joined by an underscore, for example ABCD_12345. Keep this in mind if you map products to this vendor yourself.
If you run out of API calls
When your SEMA Data plan's API limit is used up, the catalog stops and the job log shows "API quota exceeded". A connection test at that point fails with "API quota exceeded — cannot verify connection", even though your login is fine. Wait for your quota to reset or ask SEMA Data for more calls. See Why Am I Not Seeing SEMA Data in My Vendor Catalog? for other causes.