ToYou scraper API

Scraper for ToYou grocery delivery platform in Saudi Arabia

Commerce & delivery 4 capabilities stable 88.5% success rate

Capabilities

Every capability is one POST /execute call that returns structured JSON.

Categories List


            toyou.categories.list

List ToYou categories for a merchant.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"lat":24.713,"lng":46.675,"merchant_id":"96e2e119-90a6-412a-a506-0c31d733d893","operation_area":"SA_Riyadh"},"capability":"toyou.categories.list"}'

Input

Field	Type	Required	Description
`lat`	number	required	Latitude coordinate
`lng`	number	required	Longitude coordinate
`merchant_id`	string	required	Merchant identifier
`operation_area`	string	required	Operation area identifier (e.g., SA_Riyadh)

Output

Field	Type	Required	Description
`categories`	—	optional

Merchant Get


            toyou.merchant.get

Resolve the ToYou merchant identifier for a location and operation area.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"lat":24.713,"lng":46.675,"operation_area":"SA_Riyadh"},"capability":"toyou.merchant.get"}'

Input

Field	Type	Required	Description
`lat`	number	required	Latitude coordinate
`lng`	number	required	Longitude coordinate
`operation_area`	string	required	Operation area identifier (e.g., SA_Riyadh)

Output

Field	Type	Required	Description
`merchant_id`	—	optional

Operation Areas List


            toyou.operation_areas.list

List the supported ToYou operation areas.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{},"capability":"toyou.operation_areas.list"}'

Output

Field	Type	Required	Description
`areas`	—	optional

Products List


            toyou.products.list

List ToYou products for a merchant category.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"category_id":"eea49430-9492-4294-bd85-ed353e456067","lat":24.713,"lng":46.675,"merchant_id":"96e2e119-90a6-412a-a506-0c31d733d893","operation_area":"SA_Riyadh"},"capability":"toyou.products.list"}'

Input

Field	Type	Required	Description
`category_id`	string	required	Category identifier
`category_name`	string	optional	Optional category display name from toyou.categories.list, preserved in normalized output.
`lat`	number	required	Latitude coordinate
`lng`	number	required	Longitude coordinate
`merchant_id`	string	required	Merchant identifier
`operation_area`	string	required	Operation area identifier (e.g., SA_Riyadh)

Output

Field	Type	Required
`products`	array<object>	required
`products[].currency`	string	optional
`products[].description`	string	optional
`products[].id`	string	optional
`products[].image_url`	string	optional
`products[].in_stock`	boolean	optional
`products[].name`	string	optional
`products[].price`	number	optional
`products[].raw`	object	optional

Related scrapers

HungerStation Market Keeta Keemart Nana Express Panda Saudi Arabia

Run ToYou in under a minute

Get an API key