Feed — API Docs | Simple Product Feeds

Get feed summary

GET /v1/feed

Returns your feed’s current status, product count, public feed URL, and last generation details.

Required scope: read_feeds

Request

curl https://app.simpleproductfeeds.com/v1/feed \
  -H "Authorization: Bearer spf_live_sk_your_key_here"

Response

{
  "data": {
    "object": "feed",
    "status": "fresh",
    "product_count": 1482,
    "feed_url": "https://feeds.simpleproductfeeds.com/abc123/gmcfeed.txt",
    "last_generated_at": "2026-03-09T14:30:00Z",
    "last_export_id": "exp_567"
  }
}

Response fields

Field	Type	Description
`object`	string	Always "feed".
`status`	string	Feed status: "fresh" (up to date), "generating" (export in progress), or "never_generated" (no exports yet).
`product_count`	integer	Number of products in the active feed. 0 if no feed is configured.
`feed_url`	string \| null	Public URL of your primary product feed. Null if never generated.
`last_generated_at`	string \| null	ISO 8601 timestamp of the last successful feed generation.
`last_export_id`	string \| null	ID of the last export (with exp_ prefix). Null if never exported.

Feed status values

Status	Description
`fresh`	The feed is up to date. No export is running.
`generating`	An export is currently in progress (scheduled or running).
`never_generated`	No exports have been created yet.

List feed products

GET /v1/feed/products

Returns transformed feed products with all rules, mappings, and transformations applied. This shows exactly what appears in your published feed, including excluded products and exclusion reasons.

Required scope: read_products

Parameters

Parameter	Type	Default	Description
`page`	integer	`1`	Page number (minimum 1).
`per_page`	integer	`25`	Results per page (maximum 100).
`search`	string	—	Search transformed product data.
`sort`	string	—	Column name to sort by.
`order`	string	`asc`	Sort direction: `asc` or `desc`.

Request

curl "https://app.simpleproductfeeds.com/v1/feed/products?page=1&per_page=5" \
  -H "Authorization: Bearer spf_live_sk_your_key_here"

Response

{
  "data": [
    {
      "object": "feed_product",
      "excluded": false,
      "excluded_reason": null,
      "fields": {
        "id": "shopify_US_8012345678901_44012345678901",
        "title": "Blue T-Shirt - Medium",
        "description": "A comfortable blue cotton t-shirt.",
        "link": "https://my-store.myshopify.com/products/blue-t-shirt?variant=44012345678901",
        "image_link": "https://cdn.shopify.com/s/files/1/example/shirt-blue.jpg",
        "price": "29.99 USD",
        "sale_price": "29.99 USD",
        "availability": "in_stock",
        "brand": "My Brand",
        "google_product_category": "Apparel & Accessories > Clothing > Shirts & Tops"
      }
    },
    {
      "object": "feed_product",
      "excluded": true,
      "excluded_reason": "Out of stock",
      "fields": {
        "id": "shopify_US_8012345678902_44012345678902",
        "title": "Red T-Shirt - Large",
        "availability": "out_of_stock"
      }
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 5,
    "total": 1482,
    "total_pages": 297,
    "has_more": true
  }
}

Response fields

Field	Type	Description
`object`	string	Always "feed_product".
`excluded`	boolean	Whether this product is excluded from the feed by a rule.
`excluded_reason`	string \| null	Reason for exclusion, if excluded.
`fields`	object	All feed column values for this product after transformations are applied.

Errors

Status	Code	Description
422	`no_feed`	No feed has been configured for this shop.