100 free credits. No credit card required.Start building
Logo
Kroger logoKroger API

Get Kroger grocery prices and stock with one API

Search Kroger and get every grocery product with its UPC, price, sale price, stock and pack size, for one store when you name it, as structured JSON with one SocialCrawl API key. Reads are priced in credits.

Kroger logo
/v1/kroger

1 active endpoint. Product search.

  • GET /v1/kroger/search

What Kroger endpoints does SocialCrawl ship?

One read endpoint for Kroger groceries. Search by keyword, for one store when you pass its id.

/v1/kroger/search

The first 24 Kroger products for a keyword search, in Kroger's order. Each has its UPC, name, brand, description, link, images, price in US dollars with the regular price when on sale, stock and pack size. store_id picks one store's prices and stock. Standard tier (1 credit).

query, store_id

Kroger API1 endpoint supported
View docs
Products

Returns the first 24 Kroger products for a keyword search with UPC, price, sale price, stock and pack size.

Use it to check grocery prices and stock, for one store when you pass its store id.

1 credit

GET/v1/kroger/search?query=milk

query · Product keywords, 1 to 200 characters, for example milk.

$ curl https://www.socialcrawl.dev/v1/kroger/search?query=milk \
    -H "x-api-key: sc_YOUR_API_KEY"
idle
// Running this live needs your own API key. Hit "Try it" to see an example response

How the Kroger API works

Kroger is a normal SocialCrawl data surface. You call GET /v1/kroger/… with an API key, spend credits on live misses, and get a single JSON envelope back.

Authenticate every call

Send your key in the x-api-key header. No Kroger account is needed for public reads. The same key works across SocialCrawl platforms.

GET with query params

Search takes query, and store_id for one store. Formats are validated before any charge.

Pay in credits, not seats

Every Kroger route costs 1 credit. Cache hits cost 0.

Read one JSON envelope

Every response is the same shape: success, data, credits_used, credits_remaining, request_id, cached. Lists also carry pagination when the route pages.

The usual integration chain

Most products search for the items they follow, then repeat the search in each store they track.

01Search products
GET /v1/kroger/search?query=…

ProductList of matches with id, link and price

Every row carries the product link and the UPC.

02Search one store
GET /v1/kroger/search?query=…&store_id=…

The same search priced and stocked for one store

Pass store_id for each store you track; product.ext.kroger.store_id names it on every row.

request
GET /v1/kroger/search?query=milk
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here
response envelope
{
  "success": true,
  "data": {
    "items": [
      {
        "product": {
          "id": "0001111042850",
          "title": "Simple Truth Organic® Vitamin D Whole Milk Half Gallon",
          "price": {
            "current": 3.99,
            "original": 4.29,
            "currency": "USD"
          },
          "availability": "In stock",
          "ext": {
            "kroger": {
              "size": "1/2 gal",
              "store_id": null
            }
          }
        }
      }
    ]
  },
  "credits_used": 1,
  "credits_remaining": 9999,
  "request_id": "req_…",
  "cached": false
}

What lands in data

Field names match the rest of SocialCrawl where archetypes align. Parse once, reuse across platforms.

ProductListsearch

items[] with id (UPC), title, brand, url, image_urls, price with original, availability, ext.kroger with size, store_id

ext.krogersearch

size, and store_id: the store the price and stock came from

Inside the gateway

Same request lifecycle as every other /v1 platform endpoint. Kroger is not a sidecar.

  1. 01

    Edge receives the call

    Next.js catch-all routes into the Hono social API. We mint a request_id, authenticate the key, then enforce rate limit (600/min) and concurrency (50 in flight per key).

  2. 02

    Validate, then debit

    Registry lookup finds the kroger route. Required params and format checks run first. Invalid input returns 400 with no charge. Valid calls debit the tier cost atomically before the read starts.

  3. 03

    Cache or fetch

    A deterministic cache key is built from platform + resource + params. Hit: return immediately, credits_used = 0. Miss: the public data is read live, with retries on 5xx or network errors and a circuit breaker if the source is unhealthy.

  4. 04

    Normalize and return

    Kroger data is mapped to the ProductList archetype with the Kroger-only facts in product.ext.kroger, validated, then wrapped in the success envelope and logged for billing audit.

Billing rules that matter in production

  • search: 1 credit
  • Cache hit: 0 credits
  • Empty / hard fail: auto-refund
  • Bad params: 400, never charged
  • No credits: 402, never charged
  • Search: the first page of 24 only
  • Prices in US dollars
  • No orders, carts or account data
  • landings.platformBrief.platforms.kroger.api.billingRules.8

How SocialCrawl gets Kroger data

Kroger store data is public. We normalize it into the SocialCrawl schema so your code does not learn a second vendor SDK.

What Kroger is for this API

Kroger's online grocery store: keyword search, with prices and stock per store.

How SocialCrawl reaches it

Public store data is read on request and normalized server-side. You never run a Kroger login or integration.

What leaves our edge

ProductList for a search, the shared commerce shape. The Kroger-only facts sit in product.ext.kroger.

What we do not ship live

No orders, carts, accounts, coupons or customer data.

field map sketch
Kroger product→ product.*UPC, name, brand, link, images
price and sale price→ product.priceprice, regular price on sale, stock
pack size, store→ product.ext.krogerpack size, store

What this API is used for

The jobs this API is most often used for.

1active Kroger endpoints in the registry
1credit per call on every Kroger route

Grocery price tracking, sale monitoring and store-level stock checks

Callers search the items they follow on a schedule, once for each store they care about. Kroger shelf prices, sale prices and stock per store from one key in the shared Product schema.

Live misses read the public store on request. Repeat calls hit cache and cost 0 credits.

Use case examples

Common ways teams put this data to work, and the stack each one tends to run.

Grocery price tracking

Python, scheduled jobs

search with store_id per store to record each store's price over time.

Sale monitoring

Node, webhooks

search for the items you follow and catch the regular price showing next to a sale price.

Stock checks

Python, scheduled jobs

search with store_id to see whether an item is in stock at a given store.

How to call the Kroger API

Every Kroger route is 1 credit. Cache hits are free.

curl "https://www.socialcrawl.dev/v1/kroger/search?query=milk" \
  -H "x-api-key: sc_your_api_key_here"
curl "https://www.socialcrawl.dev/v1/kroger/search?query=milk&store_id=01400943" \
  -H "x-api-key: sc_your_api_key_here"
Kroger logoKroger on SocialCrawl

Same key as the rest of the catalog

Endpoints

What data does the Kroger API return?

Every endpoint returns structured JSON in a unified envelope. Computed fields such as engagement rate and content category are included only where the endpoint supports them and the required source inputs are present.

FAQ

Have a question? We got answers

Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.

Contact us
What does the SocialCrawl Kroger API cover?
It covers 1 endpoint: Search. It searches Kroger groceries by keyword and returns each product with its UPC, price, sale price, stock and pack size, in the same unified JSON as the other 94 platforms.
Do I need a Kroger developer account?
No. You call SocialCrawl with one SocialCrawl API key, so there is no Kroger login or developer application to manage.
Can I get one store's prices?
Yes. Pass store_id, the Kroger store's number, for that store's prices and stock.
Does the Kroger API show sale prices?
Yes. On sale, product.price.original is the regular price and product.price.current the sale price.
How much does the Kroger API cost?
Each Kroger search costs 1 credit and cache hits are free. A new account gets 100 free credits with no card.
Is scraping Kroger data legal?
SocialCrawl returns publicly available Kroger data and does not access private or login-gated content. Whether scraping fits your project depends on your use case and jurisdiction. You are responsible for complying with Kroger's terms of service and applicable data-protection laws such as GDPR and CCPA. This is general information, not legal advice.
Kroger scraping API vs the official Kroger API: what's the difference?
With SocialCrawl there is no app review or approval queue. Sign up and call Kroger endpoints immediately with a single x-api-key. Responses share one unified schema with every other SocialCrawl platform, and credit-based pricing replaces per-platform quotas. Official APIs are still the right choice for posting and other write actions: SocialCrawl is read-only data.

Ask AI about SocialCrawl

Read the Kroger API reference in the docs

🤖 AI agent or LLM? Read this page as markdown