INQUIRE NOW
INQUIRE NOW
REST API · Structured JSON · Marks & Spencer fashion, home and beauty product data

Marks & Spencer Product Data API

Send a Marks & Spencer product URL or a search query to one REST endpoint and get structured JSON back — title, brand, price, sale price, sizes, colours, rating, availability and more. No proxies to rotate, no headless browsers to run and no HTML to parse. Use the data to feed pricing models, digital shelf dashboards, catalogue tools and UK retail market research.

  • Product, brand and category data
  • Price, was-price and sale fields (GBP)
  • Ratings and review counts
  • Size, colour and availability fields
  • Offer and delivery fields
  • Scheduled monitoring with webhooks
/v1/productIllustrative sample
# Request (replace the key and URL with your own)
POST https://api.webfusiondata.com/v1/product
Authorization: Bearer $WFD_API_KEY

{ "url": "https://www.marksandspencer.com/example-cotton-shirt/p/clp60123456",
  "country": "GB" }

# Response (sample data, not a live listing)
{
  "product_id": "123456",
  "marketplace": "GB",
  "title": "Example Cotton Shirt",
  "brand": "Example Brand",
  "price": { "amount": 35, "currency": "GBP" },
  "was_price": 45,
  "availability": "Available",
  "rating": 4.5,
  "product_url": "https://www.marksandspencer.com/"
}

Sample values for illustration only. Exact field names and nesting for your Marks & Spencer scope are confirmed in the API reference issued with your key.

How to read this page: Documented = described on our Ecommerce Scraping API page; Illustrative = sample data or example code, not live output; Confirm at onboarding = depends on your Marks & Spencer scope and is settled with our team before you build on it.

What Is the Marks & Spencer Product Data API?

A Marks & Spencer Product Data API lets your software request information about Marks & Spencer fashion, home and beauty listings and receive it as structured data instead of a web page. You send a product URL or a search query, and get JSON with named fields such as title, brand, price, sale price, sizes, colours, rating, review count and availability. Every response follows the same schema, so it can go straight into a database, dashboard or pricing model.

Behind that request sits a collection process: our infrastructure loads the listing, handles proxies and CAPTCHAs, renders JavaScript, extracts fields with site-specific parsers and validates them before anything is returned. Larger jobs run asynchronously, with results sent to a webhook or storage bucket. You work with the API; we operate the collection layer.

Retailers, brands and analysts use the data for pricing and discount analysis, competitor research, digital shelf tracking, catalogue management and market intelligence. Our price monitoring and price intelligence services build on this kind of data.

How the Marks & Spencer API Works

Six steps from choosing a marketplace to using the data in your own systems.

Your application WebFusion Data API Collection & parsing layer Validated JSON Database · dashboard · app
1

Select marketplace and data

Confirm the Marks & Spencer products you want to track and how you will look them up: a product page URL, a URL built from a product slug and code, or a keyword or category search.

List the fields you need now, so the scope can be confirmed against what the marketplace exposes.

2

Configure the request

Build a JSON body with url (or site and query) and an optional country.

Pick the endpoint: /v1/product for one listing, /v1/search for result lists, /v1/monitor for scheduled tracking, /v1/bulk for batches.

3

Authenticate

Pass your API key as a bearer token in the Authorization header.

Start in the sandbox, which returns sample responses, so you can test your integration before spending live request credits.

4

Process and retrieve

Our infrastructure fetches the listing, renders it, extracts the fields and validates them. Single lookups return synchronously.

Bulk jobs return a job ID you can check with /v1/status/:job_id or receive through a webhook.

5

Receive structured data

JSON is the default response format. Bulk export jobs can also be delivered as CSV or XLSX.

Each record carries a capture timestamp (crawled_at) so you always know how fresh the values are, which matters during sale events and flash discounts when prices change quickly.

6

Integrate into your systems

Write results to a database, load them into a BI dashboard, trigger alerts from webhooks or schedule recurring checks with monitors.

See Integration and Data Delivery for a worked example.

Key Marks & Spencer API Features

What the Marks & Spencer Product Data API does in practice, and how much of it is already documented versus settled per project.

PD

Product, brand and category data

Returns the core listing record: title, brand, category (clothing, home, beauty and more), images, colour, size range and fabric or composition where shown. Use it to build or audit a catalogue, group results by brand or department and map Marks & Spencer listings to your own taxonomy.

Documented
ID

Product URL and ID-based lookup

Marks & Spencer product URLs typically follow /product-name/p/PRODUCT-CODE, so a list of product slugs and codes can be turned into product URLs and submitted. The product identifier is returned in the response for matching.

URL-based: documentedDedicated product ID parameter: confirm
$

Price and sale monitoring

Captures the current price, was price, sale percentage and currency (GBP), and can register a listing for scheduled checks with a webhook when a value changes. Useful for repricing inputs, MAP checks and sale-event tracking.

Documented
★

Ratings and review data

Returns the aggregate rating and review count for each listing, so you can compare quality signals across competing products and track movement over time.

Rating & count: documentedReview text: confirm
OF

Offers, delivery and Click & Collect data

Returns promotional offers, multibuy deals, delivery options and Click & Collect information displayed on the listing, where shown. Helps compare the true effective price of competing listings.

Where displayedPostcode-level delivery: confirm
AV

Listing availability data

Returns the displayed stock status for the product and each colour and size where exposed. Supports out-of-stock alerts and availability reporting.

Documented
MP

Marketplace-specific data access

A country parameter sets the market for the request. Marks & Spencer is a UK retailer, so prices are returned in GBP and availability reflects the UK site; other countries are confirmed at onboarding.

Country parameter: documentedMarketplace list: confirm
JS

Structured API responses

Fields are type-checked and normalised into a consistent schema, with automated checks that catch malformed responses before they reach you.

Documented
AU

Automated data delivery

Schedule recurring monitors, receive webhook callbacks, or request bulk exports to cloud storage, so data arrives without manual pulls.

Documented

Marks & Spencer Product Data Fields

The fields the Marks & Spencer product data extraction returns, what each one means and what teams do with it. Field availability follows what the listing displays on the selected marketplace.

Data FieldDescriptionBusiness ApplicationAvailability
product_idMarks & Spencer product code, taken from the product URL (the code after /p/)Product identification, de-duplicationCore
titleName of the listed productCatalogue managementCore
brand / categoryBrand (such as M&S Collection or Autograph) and department shown on the listingBrand analysis, category benchmarkingCore
price.amount / price.currencyDisplayed current price and its currency (GBP)Price comparison, repricing inputsCore
was_price / discountPrevious price and displayed sale percentagePromotion and markdown analysisWhere displayed
sizes / coloursSizes and colours offered, with stock status per option where exposedSize-level availability trackingWhere displayed
compositionFabric or material composition and care detailsContent benchmarkingWhere displayed
rating / review_countStar rating and number of ratings and reviewsProduct research, sentiment analysisWhere displayed
reviews (text)Individual review contentSentiment and NLP pipelinesConfirm at onboarding
offersPromotional offers and multibuy dealsPromotion trackingWhere displayed
availabilityDisplayed stock statusAvailability monitoringCore
deliveryDelivery options and Click & Collect availability for a postcodeServiceability checksConfirm at onboarding
product_url / marketplaceListing URL and the marketplace it came fromReference and validationCore
crawled_atTimestamp of data captureFreshness checks, time seriesCore

Core = part of the standard field set on our ecommerce API. Where displayed / available / exposed = returned when the listing on that marketplace shows it, so it can be empty for some listings. Confirm at onboarding = settled per project. Images and the product description are also returned. Field names are illustrative; your API reference is the source of truth.

Marks & Spencer API Endpoints and Request Parameters

The Marks & Spencer Product Data API uses the same versioned endpoints as the Ecommerce Scraping API. Marks & Spencer-specific parameter names that are not yet published are marked as illustrative.

EndpointPurposeParametersExpected response
POST /v1/product
Documented
Structured data for a single product URL: price, sale price, sizes, colours, rating, availability and the full attribute set. Required: url
Optional: country; a dedicated product_id field is a confirm
One JSON product record, returned synchronously.
POST /v1/search
Documented
Keyword or category search on a target site, returned as a structured result list. Required: site (e.g. "marksandspencer"), query
Optional: country
JSON with query, result_count and a results array.
POST /v1/monitor
Documented
Registers a listing for scheduled price and stock monitoring with webhook notifications. Required: url
Optional: webhook URL and check frequency names: confirm
A monitor ID you use to read tracked data later.
GET /v1/monitor/:id
Documented
Latest tracked data and change history for one monitored listing. Required: id (path) JSON with the current values and recorded changes.
POST /v1/bulk
Documented
Submits a batch of URLs for asynchronous processing; results go to storage or a webhook. Required: list of URLs
Optional: delivery destination and format (JSON, CSV or XLSX) names: confirm
A job ID, then results via webhook or storage export.
GET /v1/status/:job_id
Documented
Status and progress of an asynchronous crawl or bulk export. Required: job_id (path) JSON with job state and progress.

Common validation errors

SituationTypical HTTP statusHow to fix it
Missing or malformed url400Send a full Marks & Spencer product URL, including the https:// prefix.
Unsupported site or country value400 / 422Check site and country against the marketplaces confirmed for your account.
Missing or invalid API key401Send Authorization: Bearer <key> and check the key belongs to the right environment (sandbox or live).
Listing not found or discontinued404 or an empty recordVerify the product URL or slug; products can be discontinued, delisted or temporarily unavailable.
Request limit exceeded429Wait, then retry with backoff. Response headers show your remaining quota for the window.
Temporary processing failure5xxRetry with exponential backoff; for large volumes use /v1/bulk instead of many synchronous calls.

Status codes follow common REST conventions (429 is the one shown in our published dashboard example). The exact codes and error bodies are listed in the API reference supplied with your key.

Sample API Request and JSON Response

Two common calls and what comes back. Illustrative sample data — not live listing information.

1 · Look up one product
curl -X POST https://api.webfusiondata.com/v1/product \
  -H "Authorization: Bearer $WFD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.marksandspencer.com/example-cotton-shirt/p/clp60123456",
    "country": "GB"
  }'
2 · Search Marks & Spencer by keyword
curl -X POST https://api.webfusiondata.com/v1/search \
  -H "Authorization: Bearer $WFD_API_KEY" \
  -d '{"site": "marksandspencer", "query": "cotton shirt", "country": "GB"}'
Parameters used: url or site + query select what to fetch; country selects the marketplace. The key stays in an environment variable — never hard-code it or ship it in client-side code.
Response to request 1Illustrative
{
  "product_id": "123456",
  "marketplace": "GB",
  "title": "Example Cotton Shirt",
  "brand": "Example Brand",
  "price": { "amount": 35, "currency": "GBP" },
  "was_price": 45,
  "discount": { "percent": 22 },
  "availability": "Available",
  "rating": 4.5,
  "review_count": 1280,
  "variant": "White, Size M",
  "product_url": "https://www.marksandspencer.com/",
  "crawled_at": "2026-01-15T09:30:00Z"
}
Response to request 2Illustrative
{
  "query": "cotton shirt",
  "result_count": 48,
  "results": [
    { "title": "Example Cotton Shirt", "price": 29,
      "rating": 4.4, "in_stock": true }
  ]
}

The generic search sample on our Ecommerce Scraping API page uses a flat price number and an in_stock flag, while the product example above nests price under an object. The final Marks & Spencer schema is confirmed in your API reference.

Supported Marks & Spencer Marketplace

Marks & Spencer is a UK-focused retailer, so the country parameter is set to GB by default. We do not claim coverage beyond what is confirmed during onboarding, and requests outside that scope are rejected rather than guessed.

MarketplaceMarks & Spencer domainLocal currencyStatus for the API
United Kingdommarksandspencer.comGBPConfirm at onboarding

This is a reference entry for the Marks & Spencer UK storefront, not a coverage guarantee. Need another Marks & Spencer country site or app? Tell us and we will confirm feasibility.

Why it matters: Marks & Spencer prices are in GBP, and the price and sale percentage shown can change during sale events and promotions. Delivery options, Click & Collect and availability can also vary by postcode, so tell us if you need data for specific postcodes or stores. Read each response against its crawled_at timestamp.

Authentication, Rate Limits and Error Handling

What is published today, and what we give you in writing before you go live. We do not publish numeric limits, latency or uptime figures on this page.

TopicHow it worksStatus
AuthenticationYour API key is sent as a bearer token in the Authorization header. Use the sandbox key while testing.Documented
Limits and concurrencyPer-minute limits and concurrent-request allowances scale with your plan; response headers show your remaining quota. Use /v1/bulk for very large volumes.DocumentedNumbers: your plan
Validation and errorsMalformed or missing parameters are rejected with a standard HTTP error (see Endpoints), and responses are schema-checked before delivery.Exact codes: API reference
Timeouts and retriesSet a client timeout and retry reads on 429 and 5xx with exponential backoff. Move long work to /v1/bulk and /v1/status/:job_id, and avoid blind retries of POST /v1/monitor or /v1/bulk.Recommended practice
PaginationSearch returns a result_count and result list. Pagination for deeper results is scoped per project.Confirm at onboarding
Usage monitoringAn account dashboard shows request volume, latency, success rate and job status.Documented

Integration and Data Delivery

Connect the API to ecommerce applications, internal databases, BI dashboards, reporting systems and analytics pipelines. The pattern is the same each time: a request layer, a place to store results and a schedule.

Integration workflow

1

Scope and test

Agree marketplaces, fields and refresh frequency, then call the sandbox with a few sample listings.

2

Build the request layer

Put authentication, timeouts and retry backoff in one small client module your whole team reuses.

3

Store the results

Upsert records by product ID, and keep every crawled_at timestamp to build a time series.

4

Schedule and alert

Use monitors and bulk jobs, act on webhooks, and connect the table to your dashboards and reports.

Example: fetch a listing and store its price Illustrative

Python · requests + sqlite3
import os, sqlite3, requests

API = "https://api.webfusiondata.com/v1/product"
HEADERS = {"Authorization": f"Bearer {os.environ['WFD_API_KEY']}"}

def fetch(slug):
    body = {
        "url": f"https://www.marksandspencer.com/{slug}",
        "country": "GB",
    }
    r = requests.post(API, json=body, headers=HEADERS, timeout=60)
    r.raise_for_status()
    return r.json()

db = sqlite3.connect("marksandspencer_prices.db")
db.execute("CREATE TABLE IF NOT EXISTS prices "
           "(product_id TEXT, amount REAL, currency TEXT, at TEXT)")

for slug in ["example-cotton-shirt/p/clp60123456"]:
    item = fetch(slug)
    db.execute("INSERT INTO prices VALUES (?, ?, ?, ?)", (
        item["product_id"],
        item["price"]["amount"],
        item["price"]["currency"],
        item.get("crawled_at"),
    ))
db.commit()

Delivery options

JSON

Default response format for every endpoint.

Documented

CSV, Excel and cloud storage

Bulk export jobs delivered as CSV or XLSX to S3, GCS or your own bucket.

Documented

Webhooks and scheduled monitors

Callbacks when a job completes or a tracked value changes, plus recurring checks through /v1/monitor.

Documented

Database push, SDKs and no-code

Managed warehouse connectors, client libraries and no-code paths.

Languages: confirm

Listed on the Ecommerce Scraping API page; availability for your Marks & Spencer scope is confirmed during onboarding. See also the AI Parser and ecommerce datasets. Related: product availability and MAP monitoring.

FAQs

Marks & Spencer Product Data API Frequently Asked Questions

What is the Marks & Spencer Product Data API?

It is a REST API from WebFusion Data that returns structured JSON for Marks & Spencer listings. You send a product URL, or a search query, and receive fields such as title, brand, price, sale price, sizes, colours, rating and availability. It runs on the same endpoints and infrastructure as our Ecommerce Scraping API, so you do not run proxies, browsers or parsers yourself.

What product information can it provide?

Core fields include product ID, title, brand, category, price and currency, availability, images, product URL, marketplace and a capture timestamp. Was price, sale percentage, rating, review count, sizes, colours, composition and offers are returned where the listing displays them. Review text and postcode-level delivery or Click & Collect availability are confirmed per project. The data fields table shows each one.

Can I retrieve data from a Marks & Spencer product URL or ID?

Yes, through the product URL. Marks & Spencer product URLs follow the pattern /product-name/p/PRODUCT-CODE, so you build the URL from your slug and code and submit it to /v1/product with country set to GB. The product identifier is returned in the response so you can match records. Whether a dedicated product-ID-only parameter, or lookup by SKU or EAN, is available is confirmed at onboarding.

Does it support price monitoring and historical prices?

Yes. POST /v1/monitor registers a listing for scheduled price and stock monitoring with webhook notifications, and GET /v1/monitor/:id returns the latest tracked data and change history. Frequency and volume are scoped to your project. Change history is recorded from the time you register a listing; earlier history is not assumed, so ask if you need a backfill, or store each response with its crawled_at timestamp to build your own series.

Does it provide sale price and offer data?

Current price, was price and sale percentage are returned where the listing displays them, along with offer and multibuy messages. Because prices and offers can change quickly during sale events, we confirm availability and the right monitoring frequency with you before you build on it. Postcode-level delivery and Click & Collect depend on your scope.

Which Marks & Spencer markets are supported?

Marks & Spencer is a UK-focused retailer, so requests use country set to GB and prices are returned in GBP. Marks & Spencer also serves some international customers; we do not claim coverage beyond what is confirmed, and availability for your account is confirmed during onboarding. See supported marketplaces.

How does API authentication work?

Each request carries your API key as a bearer token in the Authorization header. Every account includes a sandbox for testing with sample responses. Keep the key on your server, in an environment variable or secrets manager, and never in client-side code.

Which response formats are available?

JSON is the default for all endpoints. Bulk export jobs can also be delivered as CSV or XLSX, to S3, GCS or your own bucket. Webhooks, SDKs and database push options are described in Integration and Data Delivery.

How can I request API access?

Use the Request API Demo button or the form below and tell us the marketplaces, listing volume, fields, refresh frequency and delivery format you need. We confirm the scope and set up access, including the sandbox. You can also email sales@webfusiondata.com or book a consultation.

Question mark illustration

Contact Us Now!

At WebFusionData, we specialize in cutting-edge web scraping solutions to help you unlock valuable insights and drive business growth. Whether you need custom data extraction, real-time monitoring, or large-scale web scraping, our team is here to assist you.

FAQ Illustration

Get In Touch

Ready to get started? Contact us for a personalized quote.