---
title: Diamond Search Import API
description: Introduction Importing diamonds using the Diamond Search API will add them to the diamond search and/or Engagement Ring Designer section of the website…
---

[Skip to content](https://help.punchmark.com/knowledgebase/wiki/spaces/punchmark/pages/2242674698#main-content)

English

Show submenu for translations

[![punchmark-logo-horizontal-white](https://help.punchmark.com/hs-fs/hubfs/Punchmark%20Branding/punchmark-logo-horizontal-white.png?width=225&height=38&name=punchmark-logo-horizontal-white.png)](https://academy.punchmark.com/knowledge?hsLang=en)

- [Website](https://www.punchmark.com/)
- [News](https://www.punchmark.com/news)
- [Support](https://www.punchmark.com/contact-support)
- [In the Loupe](https://www.punchmark.com/loupe)

Open main navigation

Close main navigation

- [Website](https://www.punchmark.com/)
- [News](https://www.punchmark.com/news)
- [Support](https://www.punchmark.com/contact-support)
- [In the Loupe](https://www.punchmark.com/loupe)
- English
  
  Show submenu for translations
- Go to punchmark.com

 Go to punchmark.com

 Hello. How can we help you?

- There are no suggestions because the search field is empty.

1. [Punchmark Knowledge Base](https://help.punchmark.com/knowledgebase?hsLang=en)
2. [Data & APIs](https://help.punchmark.com/knowledgebase/data-apis?hsLang=en)
3. [APIs](https://help.punchmark.com/knowledgebase/data-apis?hsLang=en#apis)

# Diamond Search Import API

## Introduction

Importing diamonds using the Diamond Search API will add them to the diamond search and/or Engagement Ring Designer section of the website.

## Post Variables

- **diamond\_data\_csv:** the CSV file being posted
- **ignore\_first\_row:** true if CSV contains a header row (recommended). False if data starts on the first line.

## Authentication

Calls to your API will require a query string parameter `authKey=`. Please contact us for an API key 

## End Points

The following endpoint URLs will require you to change the`{DOMAIN}`portion with your domain. Note that if your site isn't live and is on a staging URL `(*.shopfinejewelry.com)`, your domain will change once your site goes live. 

#### Import endpoint

`https://{DOMAIN}/api/async/sitemanager/diamonds/import_diamond_data?authKey={AUTHKEY}`

## CSV Format

A link to the valid CSV format can be found [on this page](https://help.punchmark.com/knowledge/wiki/spaces/punchmark/pages/253755431?hsLang=en). For more advanced options, contact us. 

## cURL Example

```
curl -F 'diamond_data_csv=@'$csvFile \
-F ignore_first_row='true' \
"https://$apiDomain/api/async/sitemanager/diamonds/import_diamond_data?authKey=$authKey"
```

- [Default HubSpot Blog](https://blog.punchmark.com/blog)

[![pm-symbol-blue](https://help.punchmark.com/hs-fs/hubfs/Punchmark%20Branding/pm-symbol-blue.png?width=40&height=45&name=pm-symbol-blue.png "pm-symbol-blue")](https://academy.punchmark.com/knowledge?hsLang=en)

Punchmark Resource Center

<https://www.facebook.com/punchmark> <https://www.instagram.com/punchmarkwebsites/> <https://open.spotify.com/show/1IBgfY1m1GIDkkF5N8Dn8F?go=1&sp_cid=0869f391274eb7a313244a8b2a29e059&utm_source=embed_player_p&utm_medium=desktop&nd=1&dlsi=44933130a20a4bcc>

Copyright © 2026, Punchmark