Authentication

Get your API key from the Integrations page in the API Access section.

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

Download a JSON file of your resulting data

Cancels an ongoing scan by its id.

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

Convert Universal Product Codes (UPC) to find matching ASINs. Returns ASIN and other identifiers.

Note: Items without a matching ASIN will be omitted from the response.

Request Format

Request Example

{
  "marketplace": "US",
  "ids": [
    "0385086954",
    "0062316095"
  ]
}

Response Example (ASIN first, followed by other identifiers)

{
  "0385086954": [
    "B001GRWOZ0",
    "9780385086950"
  ],
  "0062316095": [
    "B00ABC1234",
    "9780062316098"
  ]
}

Convert European Article Numbers (EAN) to find matching ASINs. Returns ASIN and other identifiers.

Note: Items without a matching ASIN will be omitted from the response.

Request Format

Request Example

{
  "marketplace": "DE",
  "ids": [
    "9780385086950",
    "5901234123457"
  ]
}

Response Example (ASIN first, followed by other identifiers)

{
  "9780385086950": [
    "B001GRWOZ0",
    "0385086954"
  ],
  "5901234123457": [
    "B00XYZ789AB"
  ]
}

Convert International Standard Book Numbers (ISBN) to find matching ASINs. Returns ASIN and other identifiers.

Note: Items without a matching ASIN will be omitted from the response.

Request Format

Request Example

{
  "marketplace": "US",
  "ids": [
    "1501142976",
    "0062316095"
  ]
}

Response Example (ASIN first, followed by other identifiers)

{
  "1501142976": [
    "B00ISBN123",
    "9781501142970"
  ],
  "0062316095": [
    "B00ISBN456",
    "9780062316098"
  ]
}

Returns all the product identifiers (UPC, EAN, etc.) for the specified ASINss.

Request Format

{
  "marketplace": "US",
  "asins": [
    "B001GRWOZ0",
    "B001GRWOZ9"
  ]
}

Response Format

The response is a map where:

• Keys are the input ASINs
• Values are objects containing various identifier types (UPC, EAN, ISBN, etc.)
• ASINs without corresponding identifiers will not be included in the response

{
  "B001GRWOZ0": {
    "upc": ["0385086954"],
    "ean": ["9780385086950"],
    "isbn": ["1501142976"]
  },
  "B001GRWOZ9": {
    "upc": ["0385086954"],
    "ean": ["9780385086950"],
    "isbn": ["1501142976"]
  }
}