--- title: "Target API: JSON data, 4 endpoints, 1 credit per call" description: "Target API for product search, product details, store availability, reviews and store lookup by ZIP code as JSON, from 1 credit per call." url: https://perceptlayer.com/apis/target --- [APIs](https://perceptlayer.com/apis) / [Marketplaces](https://perceptlayer.com/verticals/marketplaces) / Target 1 credit per call 4 endpoints 13 datapoints # Target API Target API for product search, product details, store availability, reviews and store lookup by ZIP code as JSON, from 1 credit per call. [Get a free API key](https://perceptlayer.com/signup) Run it below Target GET /v1/target/search?query=coffee+maker ``` { "success": true, "data": { "query": "coffee maker", "results": [ { "tcin": "91863920", "title": "Mr. Coffee 12-Cup Programmable Coffee Maker Black", "brand": "Mr. Coffee", "url": "https://www.target.com/p/mr-coffee-12c-programmable-drip-coffee-maker-stainless-steel-finish/-/A-91863920", "dpci": "072-08-0313", "department_id": 72, "class_id": 8, "item_type": "Coffee Makers", "images": { "primary": "https://target.scene7.com/is/image/Target/GUEST_fd026130-c56b-41d3-9e88-992fcf06debf", "alternates": [ "https://target.scene7.com/is/image/Target/GUEST_22aead54-0df3-4d28-9158-7de16148d656", "https://target.scene7.com/is/image/Target/GUEST_c4da4ed8-1abb-40b5-b060-e40be685b2ea", "https://target.scene7.com/is/image/Target/GUEST_b589d0f6-282f-4a35-be74-f8b2fbfd46a6" ] }, "price": { "current": 19.99, "regular": 34.99, "formatted_current": "$19.99", "formatted_regular": "$34.99", "comparison_type": "reg", "save_amount": 15, "save_percent": 43, "is_on_sale": true }, "rating": { "average": 4.27, "count": 1037 }, "bullets": [ { "label": "Dimensions (Overall)", "value": "13.6 Inches (H) x 10.75 Inches (W) x 11.5 Inches (D)" }, { "label": "Weight", "value": "5.71 Pounds" }, { "label": "Capacity (Volume)", "value": "60 fl oz (US)" } ], "badges": [ "Bestseller" ] }, { "tcin": "91863923", "title": "Mr. Coffee 12-Cup Switch Coffee Maker Black: Electric Drip Coffee Machine, 60 oz Capacity, Dishwasher-Safe Parts", "brand": "Mr. Coffee", "url": "https://www.target.com/p/mr-coffee-12c-drip-coffee-maker-black/-/A-91863923", "dpci": "072-08-0315", "department_id": 72, "class_id": 8, "item_type": "Coffee Makers", "images": { "primary": "https://target.scene7.com/is/image/Target/GUEST_7b42039c-223f-420b-97a8-d99a339a6295", "alternates": [ "https://target.scene7.com/is/image/Target/GUEST_de1060bf-8bcc-4059-8616-43b4d4ea11b6", "https://target.scene7.com/is/image/Target/GUEST_c4e4c1de-2168-4ce6-965a-a2f124861021", "https://target.scene7.com/is/image/Target/GUEST_bbd90a00-379e-4f7a-9a34-d8604f53af40" ] }, "price": { "current": 26.99, "regular": 26.99, "formatted_current": "$26.99", "is_on_sale": false }, "rating": { "average": 4.41, "count": 1309 }, "bullets": [ { "label": "Dimensions (Overall)", "value": "13.5 Inches (H) x 8.7 Meter (W) x 13 Inches (D)" }, { "label": "Weight", "value": "5.14 Pounds" }, { "label": "Capacity (Volume)", "value": "60 fl oz (US)" } ], "badges": [ "Bestseller" ] }, { "tcin": "94482782", "title": "bella 12 Cup Programmable Coffee Maker Oatmilk", "brand": "bella", "url": "https://www.target.com/p/bella-12-cup-programmable-coffee-maker-oatmilk/-/A-94482782", "dpci": "072-08-6593", "department_id": 72, "class_id": 8, "item_type": "Coffee Makers", "images": { "primary": "https://target.scene7.com/is/image/Target/GUEST_d6618107-b274-47f6-a0ff-ddbab4ae46fa", "alternates": [ "https://target.scene7.com/is/image/Target/GUEST_52ead7e7-d92d-4f02-82af-cf443d0af417", "https://target.scene7.com/is/image/Target/GUEST_e2d812f8-dd34-4495-86ea-3fb8205c5b49", "https://target.scene7.com/is/image/Target/GUEST_337aab34-a88f-4d62-94b4-48f1a4cba9a8" ] }, "videos": [ { "url": "https://target.scene7.com/is/content/Target/GUEST_9407b802-8f2f-46f4-8cc6-d6596e1b0c3f" } ], "price": { "current": 29.99, "regular": 39.99, "formatted_current": "$29.99", "formatted_regular": "$39.99", "comparison_type": "reg", "save_amount": 10, "save_percent": 25, "is_on_sale": true }, "rating": {}, "parent_tcin": "94482826", "bullets": [ { "label": "Dimensions (Overall)", "value": "12.24 Inches (H) x 10.35 Inches (W) x 6.65 Inches (D)" }, { "label": "Weight", "value": "2.68 Pounds" }, { "label": "Features", "value": "Automatic Shut-Off" } ], "badges": [ "4k+ bought in last month" ] } ], "pagination": { "current_page": 1, "total_pages": 13, "total_results": 293, "per_page": 24, "has_next_page": true }, "sort_by": "relevance", "sort_options": [ "relevance", "featured", "price_low" ], "store_id": "3991", "facets": [ { "id": "d_deals", "name": "Deals", "type": "checkbox", "options": [ { "name": "All Deals", "value": "all deals" }, { "name": "Sale", "value": "sale" }, { "name": "Weekly Ad", "value": "weekly ad" } ] }, { "id": "d_channel", "name": "Shipping & Pickup", "type": "checkbox", "options": [ { "name": "buy online & pick up", "value": "buy online & pick up" }, { "name": "get it today", "value": "get it today" }, { "name": "in stores", "value": "in stores" } ] }, { "id": "d_item_type_all", "name": "Type", "type": "checkbox", "options": [ { "name": "Automatic Espresso Makers", "value": "automatic espresso makers" }, { "name": "Coffee Maker Parts and Accessories", "value": "coffee maker parts and accessories" }, { "name": "Coffee Percolators", "value": "coffee percolators" } ] } ] }, "meta": { "endpoint_family": "search", "duration_ms": 904, "request_id": "req_da296619b75b4499bb0170c2c6f6bc72", "credits_charged": 1, "credits_remaining": 1945 } } ``` 200 OK JSON X-Credits-Used: 1 Recorded from our API and shortened. Sample data ## What one call returns A recorded run of `search`: the fields and shapes you will get, shortened to 3 items. | # | tcin string | title string | brand string | url url | dpci string | department\_id integer | class\_id integer | item\_type string | images object | price object | rating object | bullets object\[\] | badges string\[\] | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | 91863920 | Mr. Coffee 12-Cup Programmable Coffee Maker Black | Mr. Coffee | https://www.target.com/p/mr-coffee-12c-programmable-drip-coffee-maker-stainless-steel-finish/-/A-91863920 | 072-08-0313 | 72 | 8 | Coffee Makers | {2 fields} | {8 fields} | {2 fields} | \[3 items\] | \[1 item\] | | 2 | 91863923 | Mr. Coffee 12-Cup Switch Coffee Maker Black: Electric Drip Coffee Machine, 60 oz Capacity, Dishwasher-Safe Parts | Mr. Coffee | https://www.target.com/p/mr-coffee-12c-drip-coffee-maker-black/-/A-91863923 | 072-08-0315 | 72 | 8 | Coffee Makers | {2 fields} | {4 fields} | {2 fields} | \[3 items\] | \[1 item\] | | 3 | 94482782 | bella 12 Cup Programmable Coffee Maker Oatmilk | bella | https://www.target.com/p/bella-12-cup-programmable-coffee-maker-oatmilk/-/A-94482782 | 072-08-6593 | 72 | 8 | Coffee Makers | {2 fields} | {8 fields} | {0 fields} | \[3 items\] | \[1 item\] | Recorded from our API · 3 items shown · 13 datapoints per item GET /v1/target/search?query=coffee+maker 13 datapoints ### Identity - title string - brand string - department\_id integer - class\_id integer - item\_type string ### Contact - url url ### Reputation - images object - rating object - badges string\[\] ### Price - price object ### Other - tcin string - dpci string - bullets object\[\] Playground ## Run this API cURL shell ``` curl "https://api.perceptlayer.com/v1/target/search?query=coffee+maker" \ -H "X-API-Key: $API_KEY" ``` Target · 4 endpoints ## Endpoints Every endpoint takes the same key. Open one for its parameters and an example request. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/target/product`](https://perceptlayer.com/apis/target/product) | `tcin` +4 optional | 1–2 credits | | [GET `/v1/target/reviews`](https://perceptlayer.com/apis/target/reviews) | `tcin` +5 optional | 1 credit | | [GET `/v1/target/search`](https://perceptlayer.com/apis/target/search) | `query` +8 optional | 1 credit | | [GET `/v1/target/stores`](https://perceptlayer.com/apis/target/stores) | `zip` | 1 credit | Overview ## About the Target API ## What you can get The Target API returns Target product and store data as JSON through 4 endpoints. - **Search:** `search` takes a `query`, with `page`, `sort` (relevance, featured, price\_low, price\_high, rating\_high, bestselling or newest), `min_price`, `max_price`, `category`, `store_id`, `zip` and `include_fulfillment`. - **Products:** `product` takes a `tcin`, with `url`, `store_id`, `zip` and `include_fulfillment`. - **Reviews:** `reviews` takes a `tcin`, with `page`, `size`, `verified_only`, `photos_only` and `sort` (most\_recent, highest\_rating, lowest\_rating or helpfulness\_desc). - **Stores:** `stores` takes a `zip`. The recorded search for "coffee maker" returns `results`, each with `tcin`, `title`, `brand`, `url`, `dpci`, `item_type`, `images`, `price` ( `current`, `regular`, `save_amount`, `save_percent` and `is_on_sale`), `rating` ( `average` and `count`), `bullets` and `badges`. It also returns `pagination` with `total_results` (293 in that recording), `total_pages` and `has_next_page`, plus the `store_id` it used, `sort_options` and `facets`. ## How a call works Search, then look up: `GET /v1/target/search?query=coffee+maker` with your key in the `X-API-Key` header returns each product's `tcin`; `product` and `reviews` take a `tcin`. For a local store, find one with `GET /v1/target/stores?zip=55401` and pass its id as `store_id`. Every successful call costs 1 credit, except `product` with `include_fulfillment`, which costs 2 when store availability loads; failed calls cost nothing. Marketplaces JSON REST MCP ### More marketplaces APIs [About You](https://perceptlayer.com/apis/about-you) [adidas](https://perceptlayer.com/apis/adidas) [AliExpress](https://perceptlayer.com/apis/aliexpress) [Allegro](https://perceptlayer.com/apis/allegro) [Amazon](https://perceptlayer.com/apis/amazon) [ASOS](https://perceptlayer.com/apis/asos) [Billiger.de](https://perceptlayer.com/apis/billiger) [bol.com](https://perceptlayer.com/apis/bol) [Chrono24](https://perceptlayer.com/apis/chrono24) [Costco](https://perceptlayer.com/apis/costco) [Craigslist](https://perceptlayer.com/apis/craigslist) [DBA](https://perceptlayer.com/apis/dba) Use cases ### Track Target prices and sale prices for a product list `Use the Target API to track Target prices and sale prices for a product list` ### Check a product's availability at a nearby store `Use the Target API to check a product's availability at a nearby store` ### Watch bestselling and newest products for a query `Use the Target API to watch bestselling and newest products for a query` ### Analyse verified or photo reviews by rating `Use the Target API to analyse verified or photo reviews by rating` FAQ ## Questions **How much does the Target API cost?** Each successful call costs one credit. A \`product\` call with \`include\_fulfillment\` costs one more when store availability loads, so two in all. New accounts get free credits to start, and credit packs bring the price down as you scale. **Can I check stock at a specific store?** Yes. Pass a \`store\_id\` or \`zip\` to \`product\` with \`include\_fulfillment\`. \`stores\` finds stores by \`zip\`. **Do I need a Target account?** No. You call this Target API with your Perceptlayer key in the \`X-API-Key\` header, with no Target login. **What format are responses in?** Every endpoint returns JSON, with no HTML parsing on your side. **Should I build a Target scraper instead?** You can, but a Target scraper is code you maintain: page changes break it, requests get blocked, and Target's terms govern how you collect data. The Target API gives you 4 endpoints of named JSON fields for 1 credit per successful call, and failed calls cost nothing. A scraper makes sense only for data these endpoints don't return, so check the response in the playground on this page first. ## Try the Target API with 100 free credits No credit card. Failed calls are never billed. [Get a free API key](https://perceptlayer.com/signup) [Read the docs](https://docs.perceptlayer.com)