Other

FLO API scraper API

The FLO API returns product data from the Turkish footwear retailer FLO as clean JSON.

3 actionsLive JSON1,000 free creditsMCP-ready

🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.

The primary search endpoint returns products with id, title, brand, price, special price, original price and discount rate, and you can pull category/products and a product/detail. It is built for price intelligence, catalog enrichment and Turkish e-commerce analytics that need FLO data without a scraper. One ReefAPI key, one shared credit pool, the standard envelope.

Live example

Real request and response JSON

Captured from the indexed primary action, search, on Jul 18, 2026, 5:19 PM UTC.

Captured request

{
  "method": "POST",
  "url": "https://api.reefapi.com/flo/v1/search",
  "headers": {
    "x-api-key": "$REEF_KEY",
    "content-type": "application/json"
  },
  "body": {
    "query": "nike"
  }
}

Captured response

{
  "ok": true,
  "meta": {
    "api": "flo",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": 6226.1,
    "record_count": 24,
    "bytes": 2070619,
    "cache_hit": false,
    "method": "ssr_gtm_product_and_window_productdetail",
    "page": 1,
    "total": 692
  },
  "data": {
    "products": [
      {
        "product_id": "[redacted-phone]",
        "title": "Court Borough Low Recraft Beyaz Unisex Sneaker",
        "brand": "Nike",
        "url": "https://www.flo.com.tr/urun/nike-court-borough-low-recraft-beyaz-unisex-sneaker-[redacted-phone]",
        "price": 2999,
        "special_price": 2999,
        "original_price": 3499,
        "discount_rate": 14,
        "currency": "TRY",
        "in_stock": false,
        "image": "https://floimages.mncdn.com/media/catalog/product/26-07/13/[redacted-phone]_d1.jpg",
        "sizes": [
          {
            "size": "[trimmed-depth]",
            "dimension": "[trimmed-depth]",
            "in_stock": "[trimmed-depth]",
            "qty": "[trimmed-depth]",
            "sku": "[trimmed-depth]",
            "barcode": "[trimmed-depth]"
          },
          {
            "size": "[trimmed-depth]",
            "dimension": "[trimmed-depth]",
            "in_stock": "[trimmed-depth]",
            "qty": "[trimmed-depth]",
            "sku": "[trimmed-depth]",
            "barcode": "[trimmed-depth]"
          },
          {
            "size": "[trimmed-depth]",
            "dimension": "[trimmed-depth]",
            "in_stock": "[trimmed-depth]",
            "qty": "[trimmed-depth]",
            "sku": "[trimmed-depth]",
            "barcode": "[trimmed-depth]"
          }
        ],
        "colors": [
          {
            "name": "[trimmed-depth]",
            "sku": "[trimmed-depth]",
            "url": "[trimmed-depth]",
            "image": "[trimmed-depth]",
            "in_stock": "[trimmed-depth]",
            "qty": "[trimmed-depth]",
            "barcode": "[trimmed-depth]"
          },
          {
            "name": "[trimmed-depth]",
            "sku": "[trimmed-depth]",
            "url": "[trimmed-depth]",
            "image": "[trimmed-depth]",
            "in_stock": "[trimmed-depth]",
            "qty": "[trimmed-depth]",
            "barcode": "[trimmed-depth]"
          },
          {
            "name": "[trimmed-depth]",
            "sku": "[trimmed-depth]",
            "url": "[trimmed-depth]",
            "image": "[trimmed-depth]",
            "in_stock": "[trimmed-depth]",
            "qty": "[trimmed-depth]",
            "barcode": "[trimmed-depth]"
          }
        ],
        "seller_id": 10000,
        "seller_type": "flo",
        "category": [
          "Ayakkabı",
          "Sneaker",
          "Klasik Sneaker"
        ]
      },
      {
        "product_id": "[redacted-phone]",
        "title": "COURT BOROUGH LOW RECRAFT Beyaz Unisex Sneaker",
        "brand": "Nike",
        "url": "https://www.flo.com.tr/urun/nike-court-borough-low-recraft-beyaz-unisex-sneaker-[redacted-phone]",
        "price": 3499,
        "special_price": null,
        "original_price": null,
        "discount_rate": null,
        "currency": "TRY",
        "in_stock": false,
        "image": "https://floimages.mncdn.com/media/catalog/product/23-10/27/[redacted-phone]_d[redacted-phone].jpg",
        "sizes": [
          {
            "size": "[trimmed-depth]",
            "dimension": "[trimmed-depth]",
            "in_stock": "[trimmed-depth]",
            "qty": "[trimmed-depth]",
            "sku": "[trimmed-depth]",
            "barcode": "[trimmed-depth]"
          },
          {
            "size": "[trimmed-depth]",
            "dimension": "[trimmed-depth]",
            "in_stock": "[trimmed-depth]",
            "qty": "[trimmed-depth]",
            "sku": "[trimmed-depth]",
            "barcode": "[trimmed-depth]"
          },
          {
            "size": "[trimmed-depth]",
            "dimension": "[trimmed-depth]",
            "in_stock": "[trimmed-depth]",
            "qty": "[trimmed-depth]",
            "sku": "[trimmed-depth]",
            "barcode": "[trimmed-depth]"
          }
        ],
        "colors": [
          {
            "name": "[trimmed-depth]",
            "sku": "[trimmed-depth]",
            "url": "[trimmed-depth]",
            "image": "[trimmed-depth]",
            "in_stock": "[trimmed-depth]",
            "qty": "[trimmed-depth]",
            "barcode": "[trimmed-depth]"
          },
          {
            "name": "[trimmed-depth]",
            "sku": "[trimmed-depth]",
            "url": "[trimmed-depth]",
            "image": "[trimmed-depth]",
            "in_stock": "[trimmed-depth]",
            "qty": "[trimmed-depth]",
            "barcode": "[trimmed-depth]"
          },
          {
            "name": "[trimmed-depth]",
            "sku": "[trimmed-depth]",
            "url": "[trimmed-depth]",
            "image": "[trimmed-depth]",
            "in_stock": "[trimmed-depth]",
            "qty": "[trimmed-depth]",
            "barcode": "[trimmed-depth]"
          }
        ],
        "seller_id": 10000,
        "seller_type": "flo",
        "category": [
          "Ayakkabı",
          "Sneaker",
          "Klasik Sneaker"
        ]
      },
      {
        "product_id": "[redacted-phone]",
        "title": "COURT VISION LO NN Beyaz Erkek Sneaker",
        "brand": "Nike",
        "url": "https://www.flo.com.tr/urun/nike-nike-court-vision-lo-nn-beyaz-erkek-sneaker-[redacted-phone]",
        "price": 4399,
        "special_price": null,
        "original_price": null,
        "discount_rate": null,
        "currency": "TRY",
        "in_stock": false,
        "image": "https://floimages.mncdn.com/media/catalog/product/21-09/23/[redacted-phone]_[redacted-phone].JPG",
        "sizes": [
          {
            "size": "[trimmed-depth]",
            "dimension": "[trimmed-depth]",
            "in_stock": "[trimmed-depth]",
            "qty": "[trimmed-depth]",
            "sku": "[trimmed-depth]",
            "barcode": "[trimmed-depth]"
          },
          {
            "size": "[trimmed-depth]",
            "dimension": "[trimmed-depth]",
            "in_stock": "[trimmed-depth]",
            "qty": "[trimmed-depth]",
            "sku": "[trimmed-depth]",
            "barcode": "[trimmed-depth]"
          },
          {
            "size": "[trimmed-depth]",
            "dimension": "[trimmed-depth]",
            "in_stock": "[trimmed-depth]",
            "qty": "[trimmed-depth]",
            "sku": "[trimmed-depth]",
            "barcode": "[trimmed-depth]"
          }
        ],
        "colors": [
          {
            "name": "[trimmed-depth]",
            "sku": "[trimmed-depth]",
            "url": "[trimmed-depth]",
            "image": "[trimmed-depth]",
            "in_stock": "[trimmed-depth]",
            "qty": "[trimmed-depth]",
            "barcode": "[trimmed-depth]"
          },
          {
            "name": "[trimmed-depth]",
            "sku": "[trimmed-depth]",
            "url": "[trimmed-depth]",
            "image": "[trimmed-depth]",
            "in_stock": "[trimmed-depth]",
            "qty": "[trimmed-depth]",
            "barcode": "[trimmed-depth]"
          },
          {
            "name": "[trimmed-depth]",
            "sku": "[trimmed-depth]",
            "url": "[trimmed-depth]",
            "image": "[trimmed-depth]",
            "in_stock": "[trimmed-depth]",
            "qty": "[trimmed-depth]",
            "barcode": "[trimmed-depth]"
          }
        ],
        "seller_id": 10000,
        "seller_type": "flo",
        "category": [
          "Ayakkabı",
          "Sneaker",
          "Klasik Sneaker"
        ]
      }
    ],
    "count": 24,
    "total": 692,
    "page": 1
  }
}

Actions

What the FLO API scraper API does

Action	Description	Concrete use case	Key params
search	Search FLO by keyword (`query`), paginated. Every card carries product_id, title, brand, price, special_price (discount), sizes[] (with per-size stock), colors[], image, url, seller_type (flo\|marketplace).	Ops teams call search to search FLO by keyword (`query`), paginated.	query, page, sort, max_rotations
category/products	Browse a FLO category (`category` slug + optional `cinsiyet` gender), paginated — the deep shoe-enumeration workhorse. Same rich card shape as search (sizes, colors, discount, stock).	Developer tools call category/products to get browse a FLO category (`category` slug + optional `cinsiyet` gender), paginated.	category, cinsiyet, page, sort, max_rotations
product/detail	Full FLO product by `url` or `product_id`: title, brand, price, original_price, discount_percent, currency=TRY, images[] (full gallery), sizes[] (per-size stock), colors[], coupons[], badges (free-shipping/campaign), rating, seller, description, stock. Parsed from FLO's own window.productDetail JSON (durable) + fallback.	Validation workflows call product/detail to get full FLO product by `url` or `product_id`.	url, product_id, max_rotations

Code samples

Call search from your stack

curl -X POST https://api.reefapi.com/flo/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"nike"}'

import requests

r = requests.post(
    "https://api.reefapi.com/flo/v1/search",
    headers={"x-api-key": REEF_KEY},
    json={
  "query": "nike"
},
)
print(r.json()["data"])

const res = await fetch("https://api.reefapi.com/flo/v1/search", {
  method: "POST",
  headers: {
    "x-api-key": process.env.REEF_KEY,
    "content-type": "application/json",
  },
  body: JSON.stringify({
  "query": "nike"
}),
});
const { ok, data, meta, error } = await res.json();

MCP one-liner

Ask your MCP-connected assistant: call reefapi.flo.search with {"query":"nike"}.

Use cases

Who uses this API and why

Pricing teams call search to track FLO shoe prices and campaigns.
Catalog-enrichment tools use product/detail to fill listings with images and options.
Market analysts use category/products to monitor a footwear segment.

FAQ

Questions developers ask before integrating

What is the FLO API scraper API?

FLO API scraper API is a ReefAPI endpoint group for flo api scraper It returns live JSON through POST requests under /flo/v1.

Is the FLO API scraper API free to try?

Yes. ReefAPI starts with 1,000 free credits, no card required. FLO API scraper calls use the same shared credit balance as every other ReefAPI engine.

Do I need a FLO API scraper login or account?

No login to FLO API scraper is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.

How fresh is the FLO API scraper data?

The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.

How many credits does the FLO API scraper API use?

FLO API scraper actions currently cost 1 credit per successful call. Failed or blocked calls are free, and all APIs draw from one credit pool.

Can I call FLO API scraper from an AI assistant or MCP client?

Yes. Connect ReefAPI once through MCP and your assistant can call flo actions with the same key, credit pool and JSON envelope used by normal REST requests.

Is the FLO API scraper API a FLO API scraper scraper?

It is the managed alternative to a DIY FLO API scraper scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same flo api scraper back as clean JSON.

Why does my FLO API scraper scraper keep getting blocked?

Most FLO API scraper scrapers break on anti-bot defenses, rate limits and IP bans that need rotating residential proxies and browser fingerprinting to clear. ReefAPI handles all of that for you — no proxies, no captchas, no maintenance — and returns live JSON. Blocked or failed calls are free.

docs / flo

FLO API scraper

base /flo/v13 endpoints

post/flo/v1/search1 credit

Search FLO by keyword (`query`), paginated. Every card carries product_id, title, brand, price, special_price (discount), sizes[] (with per-size stock), colors[], image, url, seller_type (flo|marketplace).

Parameter		Allowed / range	Description
query	required	—	Search keyword (Turkish or brand name).
page = 1	optional	1–	Result page — 1-based, 24 products/page.
sort	optional	price_asc · price_desc · newest	Sort order: price_asc (cheapest first) · price_desc · newest. Also accepts a raw FLO sort token (e.g. 'filter_price:asc').
max_rotations = 8	optional	1–16	Advanced: proxy-exit rotation attempts (1-16, default 8).

Try in playground →

post/flo/v1/category/products1 credit

Browse a FLO category (`category` slug + optional `cinsiyet` gender), paginated — the deep shoe-enumeration workhorse. Same rich card shape as search (sizes, colors, discount, stock).

Parameter		Allowed / range	Description
category	required	—	FLO category slug, e.g. spor-ayakkabi · kosu-ayakkabisi · yuruyus-ayakkabisi · gunluk-ayakkabi · bot · sandalet · terlik · sneaker · hali-saha-ayakkabisi. May also be a full category URL.
cinsiyet	optional	erkek · kadin · unisex · erkek-cocuk · kiz-cocuk	Gender filter for category browse: erkek · kadin · unisex · erkek-cocuk · kiz-cocuk.
page = 1	optional	1–	Result page — 1-based, 24 products/page.
sort	optional	price_asc · price_desc · newest	Sort order: price_asc (cheapest first) · price_desc · newest. Also accepts a raw FLO sort token (e.g. 'filter_price:asc').
max_rotations = 8	optional	1–16	Advanced: proxy-exit rotation attempts (1-16, default 8).

Try in playground →

post/flo/v1/product/detail1 credit

Full FLO product by `url` or `product_id`: title, brand, price, original_price, discount_percent, currency=TRY, images[] (full gallery), sizes[] (per-size stock), colors[], coupons[], badges (free-shipping/campaign), rating, seller, description, stock. Parsed from FLO's own window.productDetail JSON (durable) + fallback.

Parameter		Allowed / range	Description
url	optional	—	Full FLO product URL (…/urun/<slug>-<sku>). Provide url OR product_id.
product_id	optional	—	FLO product SKU — the digits at the end of /urun/<slug>-<sku>. Provide product_id OR url (url is most reliable).
max_rotations = 8	optional	1–16	Advanced: proxy-exit rotation attempts (1-16, default 8).

Try in playground →

Example request · search

curl -X POST https://api.reefapi.com/flo/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"nike"}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}