# Gifi Scraper - French Discount Retail Prices and Stock (`studio-amba/gifi-scraper`) Actor

Scrape product data from gifi.fr, the French discount home, decoration and leisure retailer. Get prices, list prices, price per unit, stock, ratings, review counts and category paths for every product.

- **URL**: https://apify.com/studio-amba/gifi-scraper.md
- **Developed by:** [Studio Amba](https://apify.com/studio-amba) (community)
- **Categories:** E-commerce
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.20 / 1,000 result scrapeds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Gifi Scraper

Pull product data from gifi.fr, the French discount retailer for home, decoration, kitchen, garden, pets, party and leisure. The actor returns one row per product with the current price, list price, discount, price per unit, stock status, rating, review count and category path.

Gifi sells thousands of low-priced products in France. Prices change often and promotions are frequent, so the data suits price monitoring, assortment comparison against other discount chains, and category research.

### How to scrape Gifi data

There are two ways to tell the actor which products to read.

1. Paste product pages into `productUrls`, for example `https://www.gifi.fr/maison/table-et-cuisine/vaisselle-et-accessoires-de-table/couverts/lot-de-6-cuilleres-a-cafe-en-inox/000000000000441051.html`.
2. Leave `productUrls` empty and fill `urlKeywords`. The actor reads the shop's public product list (the sitemap) and keeps products whose address contains one of your words, for example `vaisselle`, `jouet` or `jardin`. Words are lowercase without accents, as they appear in the product addresses.

The actor stops at `maxResults`. If you leave everything empty, it reads the first 50 products in the product list.

Search result pages, filter addresses and paged category lists are not read. The site's robots.txt does not allow them, so the actor does not request them.

### Input

| Field | Type | Description |
|---|---|---|
| `productUrls` | list of URLs | Gifi product pages ending in a long number and `.html` |
| `urlKeywords` | list of words | Used when no URLs are given. Keeps products whose address contains one of the words |
| `maxResults` | number | Maximum number of products to return. Default 50 |
| `proxyConfiguration` | proxy | Apify Proxy settings. Default is Apify Proxy |

### What you get back

Each row is one product.

| Field | Description |
|---|---|
| `sku` | Gifi article number, the number in the product address |
| `name` | Product name |
| `description` | Short product description |
| `brand` | Brand, when the page shows one. Most Gifi products are own brand and have none |
| `category` | Category path, top level first |
| `price` | Current price in euros |
| `originalPrice` | List price before the promotion. Empty when the product is not discounted |
| `discountPercent` | Discount against the list price |
| `currency` | EUR |
| `pricePerUnit` | Price per litre, kilo or piece, when the page shows one |
| `inStock` | Whether the product is available online |
| `availability` | Availability value from the page, for example InStock |
| `rating` | Average customer rating out of 5. Empty when the product has no reviews |
| `reviewCount` | Number of customer reviews |
| `imageUrl` | Main product image |
| `url` | Product page |
| `scrapedAt` | Time of the request |
| `country` | fr |
| `language` | fr |

The product pages on gifi.fr do not publish EAN barcodes, so the actor does not return them.

### Example output

```json
{
  "sku": "000000000000560371",
  "name": "Horloge ronde design rayon effet bois blanc naturel Ø30 cm",
  "description": "Ø30 x Ép. 3,6 cm, mdf (particules de bois), blanc et...",
  "brand": null,
  "category": "Meuble et déco > Décoration > Décoration murale > Horloge",
  "price": 3.67,
  "originalPrice": 11.99,
  "discountPercent": 69,
  "currency": "EUR",
  "pricePerUnit": null,
  "inStock": true,
  "availability": "InStock",
  "rating": 3.88,
  "reviewCount": 104,
  "imageUrl": "https://www.gifi.fr/dw/image/v2/BJSK_PRD/on/demandware.static/-/Sites-master_GIFI/default/dw6d538db0/5/6/560371_F.jpg",
  "url": "https://www.gifi.fr/meuble-et-deco/decoration/decoration-murale/horloge/horloge-ronde-design-rayon-effet-bois-blanc-naturel-o30-cm/000000000000560371.html",
  "scrapedAt": "2026-11-14T10:03:29.977Z",
  "country": "fr",
  "language": "fr"
}
```

### Use cases

- Price monitoring: run the actor on a schedule with the same product addresses and compare price and discount over time.
- Assortment comparison: match Gifi categories and price points against Action, Pepco, La Foir'Fouille and other discount chains.
- Promotion tracking: filter rows where `originalPrice` is filled to see which products are discounted and by how much.
- Category research: export a keyword such as `jardin` and look at the price spread and ratings.
- Stock checks: track `inStock` for products you resell or compare against.

### Cost and speed

The actor reads one page per product over plain HTTP and needs no browser. Reading the product list takes a few seconds. About 40 products take under a minute. Around 30 percent of the addresses in the product list lead to discontinued products. The actor skips those and does not charge for them. Pricing is per result, see the pricing box on this page. The usage cost of a run only settles after the run reports SUCCEEDED, so a cost checked during the run is too low.

### Notes and limits

- The data covers gifi.fr, the French shop. Prices are in euros including VAT.
- Stock is the online availability shown on the page. Stock per store is not part of the output.
- When you use `urlKeywords`, the actor reads at most three times `maxResults` addresses and returns the products that still exist.
- Ratings come from the reviews shown on the product page.

### Frequently asked questions

#### Does it return EAN barcodes?

No. The product pages on gifi.fr do not show them. The `sku` is the Gifi article number.

#### Can I search by keyword?

Yes, with `urlKeywords`. The actor matches the words against the product addresses, which contain the product name and its category. The shop's own search page is not used because robots.txt does not allow it.

#### Why do I get fewer rows than maxResults?

Some products in the product list have been discontinued and redirect to a category page. The actor skips them. Use a broader keyword or raise `maxResults`.

#### Can I scrape a whole category?

Use a category word as keyword, for example `decoration-murale` or `jouet-pour-chien`. Each category name is part of the product addresses in that category.

#### How often can I run it?

As often as you like. For price monitoring, a daily run on the same list of product addresses works well.

### Related scrapers

- Action Scraper: discount retail products and prices across European Action shops.
- Screwfix Scraper: trade supplies and tools in the UK.

# Actor input Schema

## `productUrls` (type: `array`):

Product pages from gifi.fr, e.g. https://www.gifi.fr/maison/table-et-cuisine/vaisselle-et-accessoires-de-table/couverts/lot-de-6-cuilleres-a-cafe-en-inox/000000000000441051.html. Leave empty to read the shop's product list.

## `urlKeywords` (type: `array`):

Used when no product URLs are given. The actor reads the shop's product list and keeps products whose URL contains one of these words, e.g. vaisselle or jouet. Words are lowercase without accents, as in the product URLs. Leave empty to read the first products in the list.

## `maxResults` (type: `integer`):

Maximum number of products to return.

## `proxyConfiguration` (type: `object`):

Proxy used for the requests. Default is Apify Proxy.

## Actor input object example

```json
{
  "urlKeywords": [
    "vaisselle"
  ],
  "maxResults": 20,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "urlKeywords": [
        "vaisselle"
    ],
    "maxResults": 20,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("studio-amba/gifi-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "urlKeywords": ["vaisselle"],
    "maxResults": 20,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("studio-amba/gifi-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "urlKeywords": [
    "vaisselle"
  ],
  "maxResults": 20,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call studio-amba/gifi-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,studio-amba/gifi-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/u6sjg3aBIOX6Vl7BJ/builds/rwVV2cbQrmVN7Qwll/openapi.json
