Preview a feed
Reads the first rows of a feed without adding it: its format, its columns with what each likely is and sample values, and how many rows match a variant or product of the store by id. 422 `feed_unreadable` when the URL can’t be read as a feed.
POST
Reads the first rows of a feed without adding it: its format, its columns with what each likely is and sample values, and how many rows match a variant or product of the store by id. 422 feed_unreadable when the URL can’t be read as a feed.
apiKey writeheader
AuthorizationBearer <token>A workspace API key (pf_…), created under Developers → API keys.
Scope: write
idempotency-key?stringRun this write once: a retry with the same key gets the first answer (24 hours).
Length
1 <= length <= 255application/json- body
storeId*stringFormat
uuidurl*stringWhere the file is: a public http(s) URL
Format
uriLength
length <= 2000OK
application/json- response
format*stringValue in
"csv""tsv""xml""json"columns*array<>sampled*integermatches*integercurl -X POST 'https://api.postforge.dev/v1/feeds/preview' \ -H 'Content-Type: application/json' \ -d '{ "storeId": "b8adcdc8-9238-4168-90f8-77b2d14c211c", "url": "http://example.com"}'{ "format": "csv", "columns": [ { "name": "string", "suggested": "id", "samples": [ "string" ] } ], "sampled": 0, "matches": 0}