import store products

Bring an online shop’s products into the library from its URL: each product’s images, filed in folders by the store’s categories and described in the shop’s own words, so no enrichment is needed. Every file carries the Product and Product ID fields, so one product’s photos come back as one set from get_items. Reads Shopify, WooCommerce and any shop publishing product structured data. Run dry_run first: it returns the file count, estimated size and whether it fits the storage left. A real import is a job: check it with get_jobs, stop it with cancel_jobs. Importing the same shop again fetches only what is new. Free.

POST

/

tools

/

import_store_products

import store products

curl --request POST \
  --url https://eversince.ai/api/v1/tools/import_store_products \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "store_url": "<string>"
}
'

import requests

url = "https://eversince.ai/api/v1/tools/import_store_products"

payload = { "store_url": "<string>" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({store_url: '<string>'})
};

fetch('https://eversince.ai/api/v1/tools/import_store_products', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "ok": true,
  "data": {},
  "meta": {
    "request_id": "<string>",
    "cost": {},
    "cloud_processing": {
      "ran_on": "cloud",
      "minutes": 123,
      "queued_minutes": 123,
      "left_minutes": 123,
      "bought_minutes": 123,
      "note": "<string>"
    }
  },
  "media": [
    {}
  ]
}

{
  "ok": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "retryable": true,
    "suggested_action": "<string>",
    "cloud_processing": {
      "ran_on": "cloud",
      "minutes": 123,
      "queued_minutes": 123,
      "left_minutes": 123,
      "bought_minutes": 123,
      "note": "<string>"
    }
  }
}

Authorizations

Authorization

string

header

required

An API key (es_live_…) from Settings, under API keys, or an OAuth access token.

Headers

Idempotency-Key

string

Retry a paid dispatch safely: the same key returns the job already dispatched instead of charging again.

x-workspace-id

string

The workspace this one call acts in, when it is not the key's own.

Body

application/json

store_url

string

required

The shop: a domain or any page on it.

dry_run

boolean

Read and plan only. Returns the folders, file count and estimated size, and degraded when part of the shop would not answer.

images_per_product

integer

Default 3. A store gallery is mostly the same angle again.

Required range: 1 <= x <= 10

include_videos

boolean

Shopify stores only. Adds each product's videos, which are much larger than images.

max_products

integer

Required range: 1 <= x <= 1000

max_files

integer

Default 400, videos included.

Required range: 1 <= x <= 2000

root_folder

string

Where it lands. Defaults to the brand name.

context

string

Optional: one sentence shown to the user beside this action.

Maximum string length: 600

Response

Done, or a job started for work that runs longer (follow it with get_jobs).

ok

any

required

data

object

required

meta

object

required

Show child attributes

media

object[]

import store products

curl --request POST \
  --url https://eversince.ai/api/v1/tools/import_store_products \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "store_url": "<string>"
}
'

import requests

url = "https://eversince.ai/api/v1/tools/import_store_products"

payload = { "store_url": "<string>" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({store_url: '<string>'})
};

fetch('https://eversince.ai/api/v1/tools/import_store_products', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "ok": true,
  "data": {},
  "meta": {
    "request_id": "<string>",
    "cost": {},
    "cloud_processing": {
      "ran_on": "cloud",
      "minutes": 123,
      "queued_minutes": 123,
      "left_minutes": 123,
      "bought_minutes": 123,
      "note": "<string>"
    }
  },
  "media": [
    {}
  ]
}

{
  "ok": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "retryable": true,
    "suggested_action": "<string>",
    "cloud_processing": {
      "ran_on": "cloud",
      "minutes": 123,
      "queued_minutes": 123,
      "left_minutes": 123,
      "bought_minutes": 123,
      "note": "<string>"
    }
  }
}