Stride
Login
View Categories

Create a feed and connect your product API

3 min read

Contents

Create the feed, then add a source: the product API the feed reads from, with its URL, parameters, headers, pagination and dependent calls.

Create a feed #

  1. Go to Functions and click Product Feeds.
  2. Enter a Name and, optionally, a Description. The name is also used as the saved task name.
  3. Click Create feed.
New feed form with Name, Description and Create feed
New feed form with Name, Description and Create feed

New feeds start with a suggested field model and CSV columns, including a locked entity.value column (the lowest available price by default). You can change all of it before you publish.

To edit a feed later, open it from Functions → Saved Tasks. Use Duplicate there to copy a feed.

Sources tab #

Sources are the product APIs the feed reads from. They are read in priority order: for each field, the first source with a value wins, unless the field’s merge rule says otherwise.

  • Primary sources create products.
  • Enrichment sources only add data to products that already exist, matched on the product key or a variant field.

To add a source:

  1. In the dropdown beside Add source, choose the starting shape that matches your API: Nested products → variants, Flat SKU list grouped by parent or Products only.
  2. Click Add source. The source drawer opens with four steps: 1. Request, 2. Structure, 3. Map fields and 4. Role & failure.

Edit sources as JSON opens the raw configuration of every source, if you prefer to paste or edit it directly.

1. Request #

Source drawer, step 1 Request: Method, URL with a page placeholder, Format, Query parameters with Secret ticks, Headers, Repeat for, Pagination, Dependent calls, Limits and Test request
Source drawer, step 1 Request: Method, URL with a page placeholder, Format, Query parameters with Secret ticks, Headers, Repeat for, Pagination, Dependent calls, Limits and Test request
  1. Choose the Method (GET or POST) and the Format (json or ndjson), and enter the URL.

Note

Source URLs must be public https:// addresses. Private, internal and local addresses are blocked, and so are credentials written into the URL.

The URL can contain placeholders: {{repeat}} (repeat values), {{page}}, {{offset}} and {{cursor}} (pagination), and {{each}} (values from another source).

  1. Add Query parameters in the table. The table and the URL stay in sync. Values are sent as typed; &, # and spaces are encoded for you.
  2. Add Headers, for example an API key.

Note

Tick Secret on any parameter or header that holds a key or token. Secrets are stored encrypted. After you save, Stride never shows them again in full; they appear as ********.

  1. Optionally, fill in Repeat for with one value per line, for example categories or locales. Stride sends one request per value, using {{repeat}} in the URL or query.
  2. Under Pagination, choose the Type: none, page, offset, cursor, next_url or link_header.
  3. Optionally, add Dependent calls: call this API once per value found in another source, for example one detail call per product ID.
  4. Check the Limits: Timeout (ms) (default 30,000), Max response size (bytes) (default 25 MB), Retries (default 2) and Retry backoff (ms) (default 1,000). The maximums are on Product Feeds limits.
  5. Click Test request. Stride fetches up to three documents from the API so you can check the response and get structure suggestions for the next step.

Then go to step 2, Structure.

What are your Feelings