Docs menu
7NOW API endpoint
7NOW Popular Searches API
Returns the trending search terms 7NOW shows in its own search box. Two axes select the index and both matter. vertical picks the catalogue: `convenience` and `restaurant` return different terms for the same store, and `global` is the genuinely national cross-vertical list. store_id (from GET /7now/stores) then narrows to that store's region within the vertical -- a New York store returns index NY_NE, a Florida store SE, and omitting it returns the vertical-wide list. The restaurant vertical is the exception: it ignores store_id entirely, returning identical terms for every store. The response echoes back both the vertical and the regional index the terms came from.
GETapiKey1 credit/request7NOWsevennow.popularResponseDoc
7NOW/7now/popularEndpoint facts
- Method
- GET
- API path
- /7now/popular
- Auth
- apiKey
- Credits
- 1 credit/request
- Charged on
- Successful 2xx responses only
- Platform
- 7NOW
- Response schema
- #/definitions/sevennow.popularResponseDoc
How this endpoint behaves
verticalpicks the catalogue.convenienceandrestaurantreturn different terms for the same store;globalis the genuinely national cross-vertical list.store_idnarrows to that store's region within the vertical — a New York store returns indexNY_NE, a Florida storeSE, and omitting it returns the vertical-wide list. Therestaurantvertical is the exception: it ignoresstore_identirely, returning identical terms for every store.
Query parameters:
store_id(optional) — 7NOW store id, fromGET /7now/stores, e.g.39226. Selects that store's regional index within the chosen vertical; omit for the vertical-wide list. Ignored by therestaurantvertical.vertical(optional) — which trending index to read. One ofconvenience,restaurant,global. Defaults toconvenience. Any other value returns a typed invalid-param error.
Response includes store_id (echoed back when given), vertical (echoed back, one of convenience, restaurant, global), region (upstream's own name for the index the terms came from, e.g. NY_NE, W, SE, or the vertical's own name when no store narrowed it — the only signal upstream gives for which region a result set covers), suggestions[] (plain search-term strings), source_url, and fetched_at. A region with no terms returns a normal 200 with an empty suggestions array, not an error.
Sampled response
- Request, 14 Oct 2026
- GET /7now/popular?store_id=39226
- Fields returned with a value
- 4
| Field | In the sample | Value in the sample |
|---|---|---|
| store_id | Has a value | |
| vertical | Has a value | “convenience” |
| region | Has a value | “NY_NE” |
| suggestions | Has a value | 5 entries |
Request parameters
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| store_id | string | No | 7NOW store id, from GET /7now/stores. Selects that store's regional index within the chosen vertical; omit for the vertical-wide list. Ignored by the restaurant vertical. | 39226 | |
| vertical | string | No | convenience | Which trending index to read. One of: convenience, restaurant, global. Defaults to convenience. Allowed values: convenience, restaurant, global. | convenience |
| x-api-key (header) | string | Yes | API key required |
cURL example
curl -X GET "https://api.crawlora.net/api/v1/7now/popular?vertical=convenience" \ -H "x-api-key: $CRAWLORA_API_KEY"
Example JSON response
{
"code": 200,
"msg": "OK",
"data": {
"store_id": "39226",
"vertical": "convenience",
"region": "NY_NE",
"suggestions": [
"ice cream",
"coffee",
"pizza",
"chips",
"water"
],
"source_url": "https://www.7now.com/api/bff/search-services/popular?v=1&storeId=39226",
"fetched_at": "2026-09-05T21:10:00Z"
}
}Request schema
No body schema
Response schema
#/definitions/sevennow.popularResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | Code is the HTTP status code or a custom code used to indicate the result of the request @example 200 | |||
| data | sevennow.PopularResponse | No | ||||
| data.fetched_at | string | No | ||||
| data.region | string | No | NY_NE | Region is upstream's own name for the index the terms came from, e.g. `NY_NE`, `W`, `SE`, or the vertical's own name when no store narrowed it. It is the only signal upstream gives for which region a result set covers. | ||
| data.source_url | string | No | ||||
| data.store_id | string | No | 39226 | |||
| data.suggestions | array | No | ice cream,coffee,pizza | |||
| data.vertical | string | No | convenience | Vertical echoes back which index was read. | ||
| msg | unknown | No | Msg is the message that describes the result of the request @example "Request successful" |
Failure responses
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Code examples
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/7now/popular?vertical=convenience" \
-H "x-api-key: $CRAWLORA_API_KEY"