Target APItarget.com ↗
Search Target's product catalog, check real-time in-store availability by ZIP code, retrieve product details, restock dates, and gift registries via 7 endpoints.
What is the Target API?
The Target.com API exposes 7 endpoints covering product search, full product detail pages, in-store availability by ZIP code, restock scheduling, and gift registry lookup. The search_products endpoint returns paginated results with pricing, brand, ratings, sale percentage, and TCIN identifiers across Target's full catalog. TCINs flow into downstream endpoints like get_product, check_store_availability, and get_restock_info to retrieve per-item depth.
curl -X GET 'https://api.parse.bot/scraper/9935e57e-18c2-4c7c-aebe-bc311e983dc8/search_products?zip=10001&count=5&title=Max&offset=0&keyword=airpods&sort_by=relevance' \ -H 'X-API-Key: $PARSE_API_KEY'
Full-text search over Target.com product catalog by keyword. Returns paginated product listings with pricing, ratings, brand, and availability metadata. Server-side sort controls result ordering. Pagination uses offset-based addressing where each page holds up to `count` items. An optional client-side title filter narrows results to products whose title contains the given substring (case-insensitive).
| Param | Type | Description |
|---|---|---|
| zip | string | 5-digit US ZIP code for local pricing and store availability |
| count | integer | Number of results per page (max 24) |
| title | string | Optional substring filter on product titles (case-insensitive). When provided, only products whose title contains this string are returned. |
| offset | integer | Offset for pagination (0-based) |
| keywordrequired | string | Search keyword (e.g. 'airpods', 'nintendo switch') |
| sort_by | string | Sort order for results |
{
"type": "object",
"fields": {
"count": "integer - number of results returned",
"offset": "integer - current offset",
"keyword": "string - the search keyword used",
"products": "array of product objects with tcin, title, url, image_url, brand, price, regular_price, price_type, current_retail, save_percent, rating, rating_count, item_type",
"total_pages": "integer - total pages available",
"current_page": "integer - current page number",
"total_results": "integer - total number of matching products"
},
"sample": {
"data": {
"count": 24,
"offset": 0,
"keyword": "airpods",
"products": [
{
"url": "https://www.target.com/p/apple-airpods-max-160-2-160-midnight/-/A-80585769",
"tcin": "80585769",
"brand": "Apple",
"price": "$499.99",
"title": "Apple AirPods Max 2 - Midnight",
"rating": null,
"image_url": "",
"item_type": "Headphones",
"price_type": "sale",
"parent_tcin": "1010453160",
"parent_title": "Apple AirPods Max 2",
"rating_count": null,
"save_percent": 9,
"regular_price": "$549.99",
"current_retail": 499.99
}
],
"total_pages": 21,
"current_page": 1,
"total_results": 491
},
"status": "success"
}
}About the Target API
Product Search and Catalog Browsing
The search_products endpoint accepts a required keyword plus optional parameters including zip, sort_by, offset, and count (up to 24 per page). Results are paginated via offset and total_pages, and each product object carries tcin, title, brand, url, image_url, price, regular_price, price_type, current_retail, and save_percent. The optional title parameter applies a case-insensitive substring filter on top of keyword results. For broad catalog sampling without a search term, get_popular_skus returns bestseller-ranked products and get_random_skus draws from categories like Electronics, Home, Baby, Grocery, and Furniture with randomized offsets — useful for building product datasets.
Product Detail and Restock Scheduling
get_product takes a tcin and returns the full product page data: title, brand, description, features array, images array (primary first, then alternate views), item_type, rating, and formatted price. get_restock_info targets the same TCIN and surfaces scheduling fields: street_date (ISO YYYY-MM-DD), restock_date (set when street_date is in the future), is_preorder, is_upcoming, sold_out, availability_status (observed values: IN_STOCK, OUT_OF_STOCK, PRE_ORDER_SELLABLE), and purchase_limit for limited-quantity items.
In-Store Availability
check_store_availability resolves a TCIN against a 5-digit zip and returns up to 5 nearby Target stores, each with store_id, stock quantities, estimated pickup dates, in-store pricing, and geographic coordinates. The top-level product object also carries sold_out and shipping status. This is the right endpoint for "find it near me" flows where online availability alone is not sufficient.
Gift Registries
get_registries searches Target gift registries by first_name, last_name, and registry_type (BABY, WEDDING, or WISHLIST). It filters results to only return registries with at least 3 in-stock, buyable items. Each registry object includes registry_id, registry_title, registry_link, registrant names, event details, and full item data (price, availability, ratings) for the qualifying items. The count parameter caps results at up to 50 registries.
The Target API is a managed, monitored endpoint for target.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when target.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official target.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Track price drops on specific products by polling
search_productsand comparingcurrent_retailagainstregular_price - Build a store-locator feature using
check_store_availabilityto show which nearby Target stores have a product in stock with pickup dates - Monitor pre-order and restock launch dates for high-demand items using
get_restock_infofields likestreet_dateandrestock_date - Seed a product database with TCINs and metadata by paginating through
get_popular_skusorget_random_skusacross categories - Power a gift registry search tool using
get_registriesfiltered by registrant name and registry type (BABY, WEDDING, WISHLIST) - Enrich product listings with full descriptions, feature bullet points, and alternate image URLs from
get_product - Detect purchase limits on limited-release items using the
purchase_limitfield returned byget_restock_info
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Target have an official public developer API?+
What does `check_store_availability` return beyond simple in-stock or out-of-stock status?+
sold_out status and shipping availability.Does `get_restock_info` always return a `restock_date`?+
restock_date is only populated when street_date is set to a future date — meaning Target has a scheduled launch or restock loaded for the item. For items that are simply out of stock with no scheduled date, restock_date and street_date will both be null.Does the API cover customer reviews or Q&A content for products?+
get_product includes rating (average score) and basic metadata, but individual review text, review counts broken down by star rating, and Q&A threads are not returned. You can fork this API on Parse and revise it to add an endpoint targeting review data by TCIN.Is `search_products` limited to 24 results per page?+
count parameter accepts a maximum of 24 items per request. To retrieve more results, increment the offset parameter and paginate through total_pages. The total_results field tells you how many matching products exist for the keyword.