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
}