The first step towards using DataHawk is to add data Sources. Adding a data Source enables the automation of its data collection and unlocks access to a set of tools, metrics, and insights.

Types of Sources

Adding Sources

🚧

Note

After you add a source, it can take up to 24 hours for its data to sync and become available. Data will start being automatically collected and stored on a moving-forward basis, while historical data may be accessible depending on the data source.

Products

1. Go to the sources page
2. Click Add Source
3. Select the channel, Amazon or Walmart, then the Product source.
4. Select the method you would like to use.

If adding Source via ASIN or Walmart ID:

5. Select the marketplace you'd like to enter products from
6. Enter or paste the IDs of the products you want to monitor
7. Optionally toggle adding all the associated variations
8. Optionally add tags or labels to help you better segment and filter products later on
9. Finish by clicking "Add Products"

If adding Source via URL:

5. Select the marketplace you'd like to enter products from
6. Enter or paste the URLs of the products you want to monitor
7. Optionally toggle adding all the associated variations
8. Optionally add tags or labels to help you better segment and filter through products later on
9. Finish by clicking "Add Products"

If adding Source by importing a CSV file (recommended when adding more than 500 products):

5. Download the CSV template shown
6. Click "Add Products"
7. Fill the CSV template according to the template's structure and formatting
   7.1. Marketplace: Domain name representative of the Amazon or Walmart marketplace.
   7.2. ProductId: The product identifier of the product you want to add, which would be an ASIN for Amazon or a Product ID for Walmart.
   7.3. WithAllVariations: Enter False if you want to add only the specific product variation or True if you want to add all the variations associated with the child product you entered.
   7.4. Tags (optional): Tags you would like to associate the products to - either existing ones or new ones that will get created. Use semicolons ";" to separate tags. Entries are case-sensitive.
8. Save the file in the comma-separated values (CSV) format in UTF-8.
9. Upload the CSV
10. Review the submission and make any corrections based on the listed guidelines.
11. Finalize by clicking "Finish"

If adding Source via Brand selection method:

5. Contact our team to learn about the upcoming feature

Products you track will then appear on a products list in your sources. You can add products from there too.

Add Product Considerations

🚧

Note: Product Variations

When you add products, you begin tracking individual product pages which represent a single variation of any product. These pages also display product variations, all of which have their own product page. When you additionally opt to add variations while adding a product, we will automatically track the product page of each variation discovered.

📘

Tip

In addition to your own products, we recommend adding products from your top competitors. In case your product catalog is too large, prioritize monitoring your top-selling products first. Organize products into multiple separate categories, each focused on a specific use case, brand, or product category, and tag products for enhanced organization.

📘

Tip

The CSV method is a helpful way to configure a sizeable workspace when you need to add a large number of products and keywords. Start by attempting it on just a couple of items until you grasp how it works.

Keywords

1. Go to the sources page
2. Click Add Source
3. Select the channel, Amazon or Walmart, then the Keyword source.
4. Select the method you would like to use

If adding Source via Keywords:

5. Select the marketplace you'd like to enter products from
6. Enter or paste the keywords you want to monitor
7. Optionally add tags or labels to help you better segment and filter through keywords later on
8. Finish by clicking "Add Keywords"

If adding Source by importing CSV (recommended when adding more than 500 keywords):

5. Download the CSV template shown
6. Click "Add Keywords"
7. Fill the CSV template according to the template's structure and formatting
   7.1. Marketplace: domain name representative of the Amazon or Walmart marketplace
   7.2. Keyword: the keyword you want to add
   7.3. Tags (optional): Tags you would like to associate the keywords to - either existing ones or new ones that will get created. Use semicolons ";" to separate tags. Entries are case-sensitive.
8. Save the file in the comma-separated values (CSV) format in UTF-8.
9. Upload the CSV
10. Review the submission and make any corrections based on the listed guidelines
11. Finalize by clicking "Finish"

Keywords you track will then appear on a keywords list in your sources. You can add keywords from there too.

Categories

1. Go to the sources page
2. Click Add Source
3. Select the channel, Amazon or Walmart, then the Categories source.
4. Search a category that you would like to add. Since categories form a hierarchy, search the top category you would like to add from the branch first if you would like to select multiple related categories.

5. You will have the option to select a single category, or all levels of subcategories below the initial category selectors, or a set number of subcategory levels below.

6. If you have included subcategories, you can click the category you've added you remove specific categories if needed.

7. After making any necessary edits, click continue to confirm the selection and finish adding the categories.

Amazon Seller Central Accounts

You can connect as many Amazon Seller Central accounts as you want.

1. Go to the sources page
2. Click Add Sources
3. Select the Amazon Seller Central source
4. Select the region corresponding to the account you want to add
5. You will get redirected to the login page of your Amazon Seller Central account
6. Enter your Seller Central login credentials
7. Authorize integrating DataHawk into your Seller Central account

🚧

Note

Integrating an Amazon Seller Central account requires having the right user access. If you don't have it, you can always share the link to the Seller Central login page you got redirected to with the person in your team who has the appropriate access.

Amazon Vendor Central Accounts

You can connect as many Amazon Vendor Central accounts as you want.

1. Go to the sources page
2. Click Add Sources
3. Select the Amazon Vendor Central source
4. Select the region corresponding to the account you want to add
5. You will get redirected to the login page of your Amazon Vendor Central account
6. Enter your Vendor Central login credentials
7. Authorize integrating DataHawk into your Vendor Central account

🚧

Note

Integrating an Amazon Vendor Central account requires having the right user access. If you don't have it, you can always share the link to the Vendor Central login page you got redirected to with the person in your team who has the appropriate access.

Amazon Advertising Accounts

You can connect as many Amazon Advertising accounts as you want, whether you are a Seller or a Vendor (1P).

1. Go to the sources page
2. Click Add Sources
3. Select the Amazon Ads source
4. Select the region corresponding to the account you want to add
5. You will get redirected to the login page of your Amazon Advertising account
6. Enter your login credentials
7. Authorize integrating DataHawk into your Amazon Advertising account

🚧

Note

Integrating an Amazon Advertising account requires having the right user access. If you don't have it, you can always share the link to the Amazon Ads login page you got redirected to with the person in your team who has the appropriate access.

Product Expenses

You can upload per product expenses to enrich your profit and loss analyses.

1. Go to the sources page
2. Click Add Sources
3. Select the Amazon Expenses source
4. Download the CSV template shown
5. Click "Add Expenses"
6. Select the date format and decimal separator you used in the CSV.
7. Fill the CSV template according to the template's structure and formatting
   7.1. AccountID: Seller Central Account ID
   7.2. Marketplace: domain name representative of the Amazon or Walmart marketplace
   7.3. ASIN: the identifier of the product you want to attribute expenses to
   7.4. Start Date: the start date of the period during which the cost is applied
   7.5. End Date: the end date of the period during which the cost is applied
   7.6. Product Cost: the per-unit Costs of Goods Sold of the product
   7.7. Currency: the currency in which the cost applies
8. Save the file in the comma-separated values (CSV) format in UTF-8.
9. Upload the CSV.
10. Review the submission and make any corrections based on the listed guidelines
11. Finalize by clicking "Finish"

It can take up to 24 hours for the changes to be visible in your database.

API

You can also use our API to create or delete tags, and to add or archive products and keywords. You can read more about the API in the Developers section.

Search and Filtering

When navigating products, and keywords, you have the ability to enter text in the search box to find what you're looking for in a quicker way. You can also use the Filters functionality to show only the items corresponding to your filters.

Furthermore, you can search through your entire workspace to find products, keywords, reports, or even specific features and tools by using the workspace-wide search functionality. To access it, click on the magnifier icon you'll usually find on the upper-left or upper-right side of the screen.

📘

Tip

Use CTRL+P or CMD+P to access the workspace-wide search functionality, then look for any product, keyword,report, or even specific features and tools.

Archiving/removing Keywords or Products

To "Remove" a Product or Keyword and stop tracking it in your Products or Keywords list,

1. Click on the three vertical dots on the far-right side of the product/keyword you want to archive.
2. Then click "Archive in workspace" and it will remove the product/keyword from your account.

Restoring archived/removed Keywords or Products

To access the list of the items you archived,

1. Go to the products or keywords section (depending on the item you want to unarchive) within Sources.
2. You will find the "Archived Products" button on the top right side of the page. Clicking on it will reveal the list of Archived products along with the marketplace it belongs to.
3. Clicking on the three vertical dots next to the product or keyword will equip you with the option to unarchive the keyword or product.

CSV Upload Format

When adding products, keywords, or product expenses via an uploaded CSV file, we suggest that you encode your CSVs in UTF-8 to make sure that any commonly used special characters like "ñ" and 'âccénts' are not misread.

Here are some guides for how to encoded CSVs in UTF-8 when saving them from popular programs:

Saving CSV in UTF-8 for Notepad

• Open your CSV file in Notepad.
• Click on "File" in the menu.
• Select "Save As."
• Choose a location and enter a file name with a ".csv" extension.
• In the "Save as type" dropdown menu, select "All Files (.)."
• In the "Encoding" dropdown menu, choose "UTF-8."
• Click "Save."

Saving CSV in UTF-8 for Microsoft Excel

• Open your spreadsheet file in Excel.
• Click on "File" in the menu.
• Select "Save As."
• Choose a location and enter a file name.
• Click on the drop-down menu next to File format.
• Select CSV UTF-8 (Comma delimited) (.csv).
• Click "Save."

Saving CSV in UTF-8 for Apple Numbers

• Open your spreadsheet file in Numbers.
• Click on "File" in the menu.
• Select "Export To" and choose "CSV."
• In the export window, click on the dropdown next to "Advanced Options."
• Choose "Unicode (UTF-8)" under "Text Encoding."
• Click "Next" and then choose a location to save the file.

Saving CSV in UTF-8 for Google Sheets

• Open your spreadsheet file in Google Sheets.
• Click on "File" in the menu.
• Select "Download" and choose "Comma-separated values (.csv, current sheet)." Google Sheets uses UTF-8 by default.
• Choose a location and enter a file name.
• Click "Save."