Rocket Source API Docs

Authentication

Your API key should be passed through as a bearer token. So your Authorization header will contain a value of

Bearer: <YOUR TOKEN>

All requests should be made to

https://app.rocketsource.io

Example:

curl -H "Authorization: Bearer YOUR_TOKEN" "https://app.rocketsource.io/api/v3/scans"

Endpoints

Fetches all completed scans.

Params:

• pageoptional int - the page to load, default 1

Uploads a new scan. Accepts a multipart form upload with the following params:

• filerequired file. Either a csv or xlsx file
• attributesJSON object, required. See schema below

Attributes schema

interface UploadRequest {
  mapping: {
    // All values in the mapping object are column numbers, 0-indexed.
    id: number;,
    cost: number;,
    supplier_sku?: number,
    supplier_image?: number,
    supplier_pack_quantity?: number,
    map?: number,
    stock_quantity?: number,
    // an array of any custom columns you want to pass through
    custom_columns: number[], 
    discount_per_product?: number,
  };
  options: {
    // one of "US", "CA", "DE", etc. Requires that your seller account have access to the given marketplace
    marketplace_id: string; 
    // a name for your scan
    name: string; 
    discount_supplier?: number;
    custom_columns?: string[];
    header?: boolean;
    multipack_prep_cost?: {
      enabled: boolean;
      firstN: number;
      costForFirstN: number;
      costForRest: number;
    };
    prep_cost?: number;
    multipack_override?: boolean;
    multipack_override_quantity?: number;
    pull_historical_data?: boolean;
  };
}

The most simple upload payload would look like the below JSON. This assumes that your identifiers are in the first column and your costs are in the second.

{
    "mapping": {
        "id": 0,
        "cost": 1,
    },
    "options": {
        "marketplace_id": "US",
        "name": "My Scan"
    }
}

Returns the result data for a given scan id.

Accepts JSON requests with the following params:

• per_pageoptional int - the number of products per page, default 50, max 100
• pageoptional int - the page of results, used to paginate, default 0
• tableTypeoptional enum - either products or errors, default products
• sortoptional string - column to sort on, ie profit or -profit for descending order
• filteroptional array of Filter items

Filter items are JSON objects with the following structure:

{
    "name": "profit",
    "operator": ">",
    "value": 10
}

Deletes a scan by it's id.

Download a CSV file of your resulting data

Download a XLSX file of your resulting data

Exports your scan results to Google Sheets. Requires the Google Sheets integration to be set up.

Converts the given numeric identifiers (UPCs, EAN,s or ISBNs) to a list of ASINs.

Expects a JSON payload in the following format:

{
  "marketplace": "US",
  "ids": [
    "9781501142970",
    "9780385086950"
  ]
}

Where marketplace is the ISO-8601 country code and ids is an array of strings representing the product identifiers you wish to convert to ASINs.

Notes

• There is a maximum of 20 ids per API call
• You can only use marketplaces which you have linked your API keys for

Returns the following JSON object, keyed by your ids with each value being an array of ASINs that are tied to that id.

{
  "9780385086950": [
    "0385086954",
    "B001GRWOZ0"
  ],
  "9781501142970": [
    "1501142976"
  ]
}