{
"openapi": "3.0.1",
"info": {
"title": "7-Eleven Store & Delivery Scraper🇺🇸",
"description": "Scrape 7-Eleven USA stores, locations, products, prices, delivery data, reviews, and ratings. Get structured data on every 7-Eleven (Seven Eleven) location for market research, price monitoring, lead generation, and location intelligence.",
"version": "1.0",
"x-build-id": "fGqUUtim9CKGRb8QS"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/mrdoe~seven-eleven-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-mrdoe-seven-eleven-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
},
"/acts/mrdoe~seven-eleven-scraper/runs": {
"post": {
"operationId": "runs-sync-mrdoe-seven-eleven-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor and returns information about the initiated run in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/runsResponseSchema"
}
}
}
}
}
}
},
"/acts/mrdoe~seven-eleven-scraper/run-sync": {
"post": {
"operationId": "run-sync-mrdoe-seven-eleven-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
}
},
"components": {
"schemas": {
"inputSchema": {
"type": "object",
"properties": {
"storeUrls": {
"title": "Store URLs",
"type": "array",
"description": "Specific 7-Eleven store page URLs to scrape, e.g. https://www.7-eleven.com/locations/az/casa-grande/1592-n-casa-grande-ave-17312. Copy these straight from the site's store locator. Leave empty to discover stores automatically instead (see Location filter below).",
"default": [],
"items": {
"type": "string"
}
},
"locationQuery": {
"title": "Location filter",
"type": "string",
"description": "Only used when Store URLs is empty. Filters 7-Eleven's full US store list (pulled from their sitemap) by state code, city, or street text, e.g. Dallas, TX or just AZ. Leave empty to pull from all states nationwide (capped by Max stores).",
"default": ""
},
"maxStores": {
"title": "Max stores",
"minimum": 1,
"type": "integer",
"description": "Maximum number of stores to scrape in this run. There are roughly 3,500 US stores in total, so keep this modest for testing.",
"default": 20
},
"includeDeliveryCatalog": {
"title": "Include 7NOW delivery catalog",
"type": "boolean",
"description": "For each scraped store, also fetch its live 7NOW delivery product catalog (name, price, size, stock status). On by default. This is much slower and more expensive than store data alone - it requires a full browser session with Residential proxy per store, regardless of the Proxy configuration set below. Turn it off to scrape store location data only.",
"default": true
},
"deliveryCategoryFilter": {
"title": "Delivery categories to include",
"type": "array",
"description": "Only used when Include 7NOW delivery catalog is on. Category names to crawl (matched case-insensitively against the category names 7NOW shows for that store, e.g. Snacks, Drinks, Candy). Leave empty to crawl every category 7NOW shows for that store.",
"default": [],
"items": {
"type": "string"
}
},
"maxProductsPerStore": {
"title": "Max products per store",
"minimum": 0,
"type": "integer",
"description": "Only used when Include 7NOW delivery catalog is on. Caps how many delivery products are saved per store. Default is 0 (unlimited - every product in every category the store offers).",
"default": 0
},
"proxyConfiguration": {
"title": "Proxy configuration (store pages)",
"type": "object",
"description": "Proxy used for scraping store location pages. Residential is recommended: store pages depend on Google Maps' JS widget to render their content, and that widget is unreliable (slow or silently stuck) over Apify's datacenter IPs - verified live. The separate 7NOW delivery catalog stage always uses Residential proxy internally, regardless of this setting.",
"default": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
}
}
},
"runsResponseSchema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"userId": {
"type": "string"
},
"startedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"finishedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"status": {
"type": "string",
"example": "READY"
},
"meta": {
"type": "object",
"properties": {
"origin": {
"type": "string",
"example": "API"
},
"userAgent": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"properties": {
"inputBodyLen": {
"type": "integer",
"example": 2000
},
"rebootCount": {
"type": "integer",
"example": 0
},
"restartCount": {
"type": "integer",
"example": 0
},
"resurrectCount": {
"type": "integer",
"example": 0
},
"computeUnits": {
"type": "integer",
"example": 0
}
}
},
"options": {
"type": "object",
"properties": {
"build": {
"type": "string",
"example": "latest"
},
"timeoutSecs": {
"type": "integer",
"example": 300
},
"memoryMbytes": {
"type": "integer",
"example": 1024
},
"diskMbytes": {
"type": "integer",
"example": 2048
}
}
},
"buildId": {
"type": "string"
},
"defaultKeyValueStoreId": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
},
"defaultRequestQueueId": {
"type": "string"
},
"buildNumber": {
"type": "string",
"example": "1.0.0"
},
"containerUrl": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "integer",
"example": 1
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
},
"usageTotalUsd": {
"type": "number",
"example": 0.00005
},
"usageUsd": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "number",
"example": 0.00005
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}