Search
The target_search
source is designed to retrieve Target search result pages. We can return the HTML for any Target page you like. Additionally, we can deliver structured (parsed) output for Target search pages.
Request samples
The example below illustrates how you can get a parsed Target search page result.
curl 'https://realtime.oxylabs.io/v1/queries' \
--user 'USERNAME:PASSWORD' \
-H 'Content-Type: application/json' \
-d '{
"source": "target_search",
"query": "iphone",
"render": "html",
"parse": true
}'
We use synchronous Realtime integration method in our examples. If you would like to use Proxy Endpoint or asynchronous Push-Pull integration, refer to the integration methods section.
Request parameter values
Generic
source
Sets the scraper.
target_search
query
The keyword or phrase to search for products.
-
render
-
parse
Returns parsed data when set to true
.
false
callback_url
-
user_agent_type
desktop
- mandatory parameter
Localization
Adapt results to specific stores, fulfillment type, delivery locations.
fulfillment_type
Set the fulfillment type. Available values are: pickup
, shipping
, shop_in_store
, same_day_delivery
.
String
store_id
Set the store location.
Integer
delivery_zip
Set the shipping to location.
String
Output data dictionary
HTML example
"content": {
"url": "https://www.target.com/s?searchTerm=iphone&tref=typeahead%7Cterm%7Ciphone%7C%7C%7Chistory",
"results": {
"organic": [
{
"url": "https://www.target.com/p/refurbished-at-38-t-apple-iphone-12-128gb-black-target-certified-refurbished/-/A-90500508#lnk=sametab",
"title": "Refurbished AT&T Apple iPhone 12 (128GB) - Black - Target Certified Refurbished",
"brand_link": "https://www.target.com/b/apple/-/N-5y3ej",
"brand_name": "Apple",
"price_data": {
"price": 380.79,
"currency": "USD",
"comparison_price": 475.99
},
"product_id": "90500508",
"rating_data": {
"count": 0,
"score": 0
},
"shipping_message": "Ships freeExclusions applyGet it by Tue, Jul 9"
},
...
]
},
"parse_status_code": 12000
},
"created_at": "2024-07-03 10:48:01",
"updated_at": "2024-07-03 10:48:32",
"page": 1,
"url": "https://www.target.com/s?searchTerm=iphone&tref=typeahead%7Cterm%7Ciphone%7C%7C%7Chistory",
"job_id": "7214218323129556993",
"status_code": 200,
"parser_type": "target_search",
...
}
JSON structure
The table below presents a detailed list of search results page element we parse, along with its description and data type. The table also includes some metadata.
url
The URL of the search results page.
String
results
Container for the search results.
Dictionary
organic
List of organic (non-paid) search results.
List
organic.url
The URL of the individual product page.
String
organic.title
The title of the product.
String
organic.brand_link
The URL to the brand page.
String
organic.brand_name
The name of the brand.
String
organic.price_data
Container for the product price data.
Dictionary
organic.price_data.price
The price of the product.
Float
organic.price_data.currency
The currency of the price.
String
organic.price_data.upper_price
The upper price if there is a price range.
Float
organic.product_id
The unique product ID.
String
organic.rating_data
Container for the product rating data.
Dictionary
organic.rating_data.count
The number of ratings.
Integer
organic.rating_data.score
The average rating score.
Float
organic.rating_data.reviews_url
The URL to the reviews page.
String
organic.shipping_message
The shipping information for the product.
String
created_at
The timestamp when the scraping job was created.
String
updated_at
The timestamp when the scraping job was finished.
String
parse_status_code
Integer
page
The page number of the search results
Integer
status_code
Integer
parser_type
The type of parser used to extract the data.
String
job_id
The ID of the job associated with the scraping job.
String
Last updated
Was this helpful?