With this API you can do most things that are available through our website seller panel, including: Add/Edit/Find products, and Order Management.
\nThe AutoParts4Less API consists of two types of calls, GET (pulls information) and POST (creates or updates information)
\nCurrent Version: 1.0
Production Base Url: https://sellers-api.autoparts4less.com/v1
There is no rate limit for any requests.
\nAll requests and responses are paginated with a maximum of 30 results.
\nFirst create a seller account by going to https://seller.autoparts4less.com/
\nYou will need to take 3 steps in your account before listing your first product:
\nAn API access_token is required for all other API requests. The auth_token that is required for successfully creating an API token can be generated by logging into your seller account at https://seller.autoparts4less.com/ then click on \"Seller Business\" -> \"Auth Token\" -> \"Generate New Auth Token\".
The seller_email is the email address used to login to the seller account where you generated the auth_token
The returned access_token will expire after 24 hours. Creating more than one access_token does not invalidate previous ones, the access_token will always be valid for 24 hours.
LIMITS
Up to 30 comma separated product UPCs to be checked in each request. If you add more than 30 comma separated UPCs in a single request, the request will be rejected.
GENERAL
Before trying to sell any product, it is best to check if the product already exists. If a product does exist, then you only need to add your 'seller specifics' (price, quantity, etc.) in order to sell the product. But if the product does not already exist, then you are required to add all other product attributes (name, images, etc.)
LIMITS
Up to 30 products can be added in each request. If you add more than 30 product in a single request, the request will be rejected.
GENERAL
If a product already exists in the AutoParts4Less network, then you can start selling the product by only adding your 'seller specifics'
LIMITS
Up to 30 products can be added in each request. If you add more than 30 product in a single request, the request will be rejected.
GENERAL
If a product does not already exist in the AutoParts4Less network, then use this request to create the new product
LIMITS
Up to 30 products can be updated in each request. If you add more than 30 product in a single request, the request will be rejected.
GENERAL
The only required field in this request is the seller_specifics.vendor_sku because this is used as the product identifier. Any other attribute that is included will be updated.
NOTES
In a successful response to this request, you will receive a queue_id. You can use this queue_id in the \"Queue Status\" API request. The queue is fulfilled 99% of the time within 1 minute, but in a case of an unusually large amount of API requests, it could take slightly longer. You can check if your request has been processed by putting your returned queue_id in the \"Queue Status\" request.
LIMITS
\nThis endpoint has a limit of 10,000 products per request, unlike the other requests with a limit of 30
\nGENERAL
\nThis \"Unified Bulk\" endpoint combines the functionality of the previous 3: \"Sell an Existing\", \"Create New\" and \"Update\".
\nRather than the complications of first needing to determine the current status of a product, with this endpoint, you can just send the product data, and we will make the appropriate action.
\nThe validation for this endpoint is the same as the previous 3 endpoints. The validation automatically changes based on the current status of the product:
\nRESPONSE
\nThe JSON response to this request will include a queue_id which can be used to check the status of this request in the \"Unified Bulk Product Queue\" request
LIMITS
\nOnly use one queue_id in a request
GENERAL
\nThis endpoint is specifically used for the \"Unified Bulk Product Changes\" request. You can put your returned queue_id as the GET parameter here to see the status of your product changes.
LIMITS
If the optional parameter page_size is not set, then the page size will default to 30 . You can set the page_size to a maximum of 10000 . The page_no is also optional, and defaults to 1 if not set.
GENERAL
Use this API request to get a paginated list of your products.
Alternately if you have a large catalog, you could also download a full export by logging into the seller panel at seller.autoparts4less.com and clicking on \"Products\" -> \"My Listing\" -> \"Export\".
LIMITS
Up to 30 products can be requested and returned in each request.
GENERAL
This request returns all of the product details. Unlike the \"View Your Products\" API request which only returns some summary information, this request returns all product attributes
LIMITS
Up to 30 comma separated products can be returned in each request. If you add more than 30 comma separated products in a single request, the request will be rejected.
GENERAL
This API will return list of vehicle fitment associated with the specified vendor_sku.
You can download a list of vehicle_ids by logging into the seller panel at seller.autoparts4less.com and clicking on \"Products\" -> \"Bulk Import\" -> \"Master Vehicle List\".
\n","urlObject":{"host":["/vehicle-fitments"],"query":[{"key":"vendor_skus","value":"SKU-1,SKU-2,SKU-3"}],"variable":[]}},"response":[{"id":"b4929bf8-529b-4488-bf36-04b08936f50a","name":"List Vehicle Fitment","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"key":"Authorization","value":"Bearer {{bearer}}","type":"text"}],"url":{"raw":"//vehicle-fitments?vendor_skus=SKU-1,SKU-2,SKU-3","host":["/"],"path":["vehicle-fitments"],"query":[{"key":"vendor_skus","value":"SKU-1,SKU-2,SKU-3"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 29 May 2022 17:00:30 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"433"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"Kestrel"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"status\": \"error\",\n \"message\": \"Please correct the following detail errors.\",\n \"errors\": {\n \"vendor_sku\": \"'vendor_sku' having no fitments to show.\"\n },\n \"vendor_sku\": \"SKU-1\"\n },\n {\n \"status\": \"success\",\n \"message\": \"\",\n \"errors\": {},\n \"vendor_sku\": \"SKU-2\",\n \"vehicle_ids\": [1100001,1100002,1100003,1100004]\n },\n {\n \"status\": \"success\",\n \"message\": \"\",\n \"errors\": {},\n \"vendor_sku\": \"SKU-3\",\n \"vehicle_ids\": [1100001]\n }\n]"}],"_postman_id":"f06c4c95-1f50-40ca-9165-b8033f791ed5"},{"name":"Add Vehicle Fitment","id":"68a4afd7-5be4-49b4-bf4f-2663284159d9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"},{"key":"Authorization","value":"Bearer {{bearer}}","type":"text"}],"body":{"mode":"raw","raw":"[\n\t{\n\t\t\"vendor_sku\": \"SKU-1\",\n \"vehicle_ids\": [\"1100001\",\"1100002\",\"1100003\",\"1100004\"]\n\t},\n\t{\n\t\t\"vendor_sku\": \"SKU-2\",\n \"vehicle_ids\": [\"1100001\"]\n\t},\n\t{\n\t\t\"vendor_sku\": \"SKU-3\",\n \"vehicle_ids\": [\"1100001\"]\n\t}\n]","options":{"raw":{"language":"json"}}},"url":"/vehicle-fitments/create","description":"LIMITS
Up to 30 products can be updated in each request. If you add more than 30 products in a single request, the request will be rejected. For each product, you can update (add) unlimited fitments in a single request.
GENERAL
This API will add vehicle fitment associations to the specified vendor_sku
You can download a list of vehicle_ids by logging into the seller panel at seller.autoparts4less.com and clicking on \"Products\" -> \"Bulk Import\" -> \"Master Vehicle List\".
\n","urlObject":{"path":["create"],"host":["/vehicle-fitments"],"query":[],"variable":[]}},"response":[],"_postman_id":"68a4afd7-5be4-49b4-bf4f-2663284159d9"},{"name":"Delete Vehicle Fitment","id":"b73ca27e-d045-4250-b30d-2c0626de6cb4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"},{"key":"Authorization","value":"Bearer {{bearer}}","type":"text"}],"body":{"mode":"raw","raw":"[\n\t{\n\t\t\"vendor_sku\": \"SKU-1\",\n \"vehicle_ids\": [\"1100001\",\"1100002\",\"1100003\",\"1100004\"]\n\t},\n\t{\n\t\t\"vendor_sku\": \"SKU-2\",\n \"vehicle_ids\": [\"1100001\"]\n\t},\n\t{\n\t\t\"vendor_sku\": \"SKU-3\",\n \"vehicle_ids\": [\"1100001\"]\n\t}\n]","options":{"raw":{"language":"json"}}},"url":"/vehicle-fitments/delete","description":"LIMITS
Up to 30 products can be updated in each request. If you add more than 30 products in a single request, the request will be rejected. For each product, you can update (delete) unlimited fitments in a single request.
GENERAL
This API will delete vehicle fitment associations to the specified vendor_sku
You can download a list of vehicle_ids by logging into the seller panel at seller.autoparts4less.com and clicking on \"Products\" -> \"Bulk Import\" -> \"Master Vehicle List\".
\n","urlObject":{"path":["delete"],"host":["/vehicle-fitments"],"query":[],"variable":[]}},"response":[],"_postman_id":"b73ca27e-d045-4250-b30d-2c0626de6cb4"},{"name":"Get Orders List","id":"815d4328-bdf1-42ee-9fb6-8b1eb0c2f6b7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[{"key":"Accept","value":"application/json"},{"key":"Authorization","value":"Bearer {{bearer}}","type":"text"}],"url":"/orders?status=[new|processed|shipped|delivered|cancelled|refunded|partial_refunded|partial_cancelled|replaced|partial_delivered]&page_no=1&from_date=YYYY-MM-DD&to_date=YYYY-MM-DD","description":"LIMITS
Results will be returned in a paginated list of 30 orders per page.
GENERAL
Use this API to get a list of your orders with a summary of the order details
NOTES
The returned data will include a seller_order_id and also an order_id. The seller_order_id is specific to an individual product, and should be used in other \"Order\" requests as the identifier. The order_id might show up more than once, in a case where a single buyer placed a single order with more than 1 product that you're selling. The order_id also might be shared with other sellers, in a case where the buyer purchased 1 product from you, and another product from another seller, and checked-out in a single order. The order_id could be helpful if you see that 2 products share the same order_id and you ship your products from a single warehouse, because you could potentially box both products together and ship them in a single box.
LIMITS
Up to 30 orders can be requested and returned in each request.
GENERAL
This request returns all of the product details. Unlike the \"Get Orders List\" API request which only returns some summary information, this request returns all product attributes
LIMITS
Up to 30 tracking numbers can be added in each request.
GENERAL
This request adds tracking numbers to the specified orders
Add order tracking for the current orders.
\n","urlObject":{"path":["add-order-tracking"],"host":["/orders"],"query":[],"variable":[]}},"response":[],"_postman_id":"aabbae06-933d-4bdc-a889-7bc0e3148b43"},{"name":"Queue Status","id":"134afbd2-b647-4afe-9837-d961689c8318","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[{"key":"Accept","value":"application/json"},{"key":"Authorization","value":"Bearer {{bearer}}","type":"text"}],"url":"/products/queue-status?queue_id=10000000-0000-0000-0000-000000000001","description":"LIMITS
Up to 30 comma separated queue_id can be checked in each request. If you add more than 30 comma separated queue_id in a single request, the request will be rejected.
GENERAL
Some of the POST requests will return a queue_id because we don't update all POSTed information instantly. The queue is fulfilled 99% of the time within 1 minute, but in a case of an unusually large amount of API requests, it could take slightly longer. You can check if your request has been processed by putting your returned queue_id in this API request
For each physical location you have, you will need to add specific details, like the actual address, the store hours, and also a unique_identifier . The unique_identifier can be anything you want, and it will be used in subsequent requests to reference that location.
For each physical location you have, you will need to add specific details, like the actual address, the store hours, and also a unique_identifier . The unique_identifier can be anything you want, and it will be used in subsequent requests to reference that location.
This API request is mostly the same as the \"Add New Product\" API for non-BOPIS sellers. You'll notice that the endpoint is actually the same. There is also the additional option locations that can be added, to specify your inventory at each location.
For each new product you add using this request, you are still limited to a maximum of 30 products to be added in a single request, and additionally, you are limited to a maximum of 30 locations in this request.
\nIf you have more than 30 locations that you need to update inventory for at once, there is also the \"Update Product In Locations\" API endpoint, which doesn't have a limit to the number of locations in a single request
\n","urlObject":{"path":["create"],"host":["/products"],"query":[],"variable":[]}},"response":[],"_postman_id":"c19025cf-c6fd-42ff-8895-1302672ced2f"},{"name":"Update Products","id":"cbc25362-e8a4-410e-aabc-119578c0ed10","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"Accept","value":"application/json","type":"text"},{"warning":"This is a duplicate header and will be overridden by the Authorization header generated by Postman.","key":"Authorization","value":"Bearer {{bearer}}","type":"text"}],"body":{"mode":"raw","raw":"[\r\n\t{\r\n\t\t\"general_info\": {\r\n\t\t\t\"category_id\": \"1234\",\r\n\t\t\t\"upc\": \"100000000000\",\r\n\t\t\t\"product_brand\": \"The Product Brand\",\r\n\t\t\t\"part_number\": \"ABC123\",\r\n\t\t\t\"name\": \"Product Name\",\r\n\t\t\t\"description\": \"A detailed description of the product describing its value to customers.\",\r\n\t\t\t\"product_weight\": 5.5,\r\n\t\t\t\"features\": \"A description of the product's notable features, such as purpose, functions, capabilities, and visual traits.\",\r\n\t\t\t\"important_notes\": \"Important notes that you would like to notify the customer about in regards to the product, such as if it only fits a specific type of vehicle, or is illegal in certain states.\",\r\n\t\t\t\"country_of_manufacture\": \"United States\",\r\n\t\t\t\"harmonized_tariff_code\": \"8708.10.30\",\r\n\t\t\t\"instruction_files\": [\"https://example.com/file.pdf\", \"https://example.com/file.png\"],\r\n\t\t\t\"video_urls\": [\"https://www.youtube.com/watch?v=video1\" , \"https://www.youtube.com/watch?v=video2\"],\r\n\t\t\t\"california_proposition65_warn\": 1,\r\n\t\t\t\"old_part_number\": \"OLD-ABC123\"\r\n\t\t},\r\n\t\t\"seller_specifics\": {\r\n\t\t\t\"vendor_sku\": \"SKU-1\",\r\n\t\t\t\"condition\": \"[New|Used-Mint|Used-LikeNew|Used-Good|Used-Fair|Used-Poor]\",\r\n\t\t\t\"condition_note\": \"Optionally add a note that can be shown to buyers to give additional detail about the product’s condition\",\r\n\t\t\t\"price\": 199.99,\r\n\t\t\t\"sale_price\": 149.99,\r\n\t\t\t\"sale_from_date\": \"YYYY-MM-DD\",\r\n\t\t\t\"sale_to_date\": \"YYYY-MM-DD\",\r\n\t\t\t\"quantity\": 10,\r\n\t\t\t\"reorder_level\": 3,\r\n\t\t\t\"handling_time_no_of_days\": 0,\r\n\t\t\t\"eligible_for_return\": [0|1],\r\n\t\t\t\"return_within_days\": 30,\r\n\t\t\t\"allow_free_return\": [0|1],\r\n\t\t\t\"warranty_type\": \"[Manufacturer|Vendor|NoWarranty]\",\r\n\t\t\t\"warranty_description\": \"Optionally add details about the warranty, for example: how long the product is under warranty for and under what circumstances will the warranty be accepted.\",\r\n\t\t\t\"tax_category\": \"[Taxable|Nontaxable]\",\r\n\t\t\t\"shipping_weight\": 10.5,\r\n\t\t\t\"shipping_policy_id\": \"ABC123\",\r\n\t\t\t\"locations\": [\r\n\t\t\t\t{\r\n\t\t\t\t\t\"uniuqe_identifier\": \"New Location - Testing\",\r\n\t\t\t\t\t\"quantity\": \"10\",\r\n\t\t\t\t\t\"price\": \"2\"\r\n\t\t\t\t},\r\n\t\t\t\t{\r\n\t\t\t\t\t\"uniuqe_identifier\": \"Test Location 11\",\r\n\t\t\t\t\t\"quantity\": \"15\",\r\n\t\t\t\t\t\"price\": \"3\"\r\n\t\t\t\t}\r\n\t\t\t]\r\n\t\t},\r\n\t\t\"product_images\": {\r\n\t\t\t\"image_1\": \"https://example.com/image1.jpg\",\r\n\t\t\t\"image_2\": \"https://example.com/image2.jpeg\",\r\n\t\t\t\"image_3\": \"https://example.com/image3.png\",\r\n\t\t\t\"image_4\": \"https://example.com/image4.webp\",\r\n\t\t\t\"image_5\": \"https://example.com/image5.gif\",\r\n\t\t\t\"image_6\": \"https://example.com/image6.svg\",\r\n\t\t\t\"image_7\": \"https://example.com/image7.bmp\",\r\n\t\t\t\"image_8\": \"https://example.com/image8.jpg\",\r\n\t\t\t\"image_9\": \"https://example.com/image9.jpg\",\r\n\t\t\t\"image_10\": \"https://example.com/image10.jpg\"\r\n\t\t},\r\n\t\t\"item_specific\": {\r\n\t\t\t\"Attribute1\": \"Value 1\",\r\n \"Attribute2\": \"Value 2\"\r\n\t\t}\r\n\t}\r\n]","options":{"raw":{"language":"json"}}},"url":"/your-products/update","description":"This API request is mostly the same as the \"Update Products\" API for non-BOPIS sellers. You'll notice that the endpoint is actually the same. There is also the additional option locations that can be added, to specify your inventory at each location.
For each product updated using this request, you are still limited to a maximum of 30 products to be updated in a single request, and additionally, you are limited to a maximum of 30 locations in this request.
\nIf you have more than 30 locations that you need to update inventory for at once, there is also the \"Update Product In Locations\" API endpoint, which doesn't have a limit to the number of locations in a single request
\n","urlObject":{"path":["update"],"host":["/your-products"],"query":[],"variable":[]}},"response":[],"_postman_id":"cbc25362-e8a4-410e-aabc-119578c0ed10"},{"name":"Update Product In Locations","id":"2d3e557c-953c-495d-8b4d-48e925ae90ac","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"Accept","value":"application/json","type":"text"},{"warning":"This is a duplicate header and will be overridden by the Authorization header generated by Postman.","key":"Authorization","value":"Bearer {{bearer}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n\t\"vendor_sku\": \"SKU-1\",\r\n\t\"locations\": [\r\n\t\t{\r\n\t\t\t\"uniuqe_identifier\": \"Juneu-1\",\r\n\t\t\t\"quantity\": 16,\r\n\t\t\t\"price\": 100\r\n\t\t},\r\n\t\t{\r\n\t\t\t\"uniuqe_identifier\": \"Testing-7\",\r\n\t\t\t\"quantity\": 20,\r\n\t\t\t\"price\": 100\r\n\t\t},\r\n\t\t{\r\n\t\t\t\"uniuqe_identifier\": \"New Location-Testing\",\r\n\t\t\t\"quantity\": 30\r\n\t\t}\r\n\t]\r\n}","options":{"raw":{"language":"json"}}},"url":"/your-products/update-product-location","description":"This API allows you to update the Quantity and Price for a single product without any limit on the number of locations you are updating at once. You can only update a single product at once.
\n","urlObject":{"path":["update-product-location"],"host":["/your-products"],"query":[],"variable":[]}},"response":[],"_postman_id":"2d3e557c-953c-495d-8b4d-48e925ae90ac"},{"name":"Update Order Status","id":"343293d1-760e-4c40-b92b-e9a75aba2069","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Authorization","value":"Bearer {{bearer}}","type":"text"}],"body":{"mode":"raw","raw":"[\r\n\t{\r\n\t\t\"status\": \"canceled\",\r\n\t\t\"seller_order_id\": \"777777777777777777777-77777777\"\r\n\t},\r\n\t{\r\n\t\t\"status\": \"processed\",\r\n\t\t\"seller_order_id\": \"888888888888888888888-88888888\"\r\n\t},\r\n\t{\r\n\t\t\"status\": \"delivered\",\r\n\t\t\"seller_order_id\": \"999999999999999999999-99999999\"\r\n\t}\r\n]","options":{"raw":{"language":"json"}}},"url":"/orders/change-order-status","urlObject":{"path":["change-order-status"],"host":["/orders"],"query":[],"variable":[]}},"response":[],"_postman_id":"343293d1-760e-4c40-b92b-e9a75aba2069"}],"id":"6c5fffce-9aee-4009-af86-2225eb42c2fa","description":"With some minor modifications to the above main API requests, you can also offer your products for Will-Call where customers will Buy Online and Pickup In Store
\n","_postman_id":"6c5fffce-9aee-4009-af86-2225eb42c2fa"}],"variable":[{"id":"168cf914-3fad-4d8a-b03d-921f496ffb7d","key":"baseUrl","value":"/","type":"string"}]}