Shopify Product Search Scraper Actor Documentation ## Overview The Shopify Product Search Scraper enables users to search for products within Shopify stores by providing a search query. This actor retrieves targeted product data based on your input, including details such as product titles, descriptions, and metadata, making it a perfect tool for focused product research and analysis. --- ## Features - Search by Query: Easily filter products in a store using a specific keyword or phrase. - Limit Results: Specify the maximum number of products to retrieve. - Detailed Metadata: Fetch creation dates, vendor information, tags, and more. - Targeted Output: Get only the most relevant products matching your query. --- ## Use Cases - Targeted Research: Find products in a specific category or matching a keyword. - Content Aggregation: Build curated lists of products for reviews or blogs. - Price Tracking: Monitor the prices of specific items over time. - Market Analysis: Understand trends and customer preferences for specific product types. --- ## Input Parameters The actor accepts the following input parameters: | Parameter Name | Type | Description | |----------------|--------|-----------------------------------------------------------------------------| | url | String | The URL of the Shopify store to search. Example: https://www.tentree.com/. | | query | String | The search term to filter products by. Example: "hoodie". | | limit | Number | The maximum number of products to retrieve. Default is 10. | #### Example Input javascript const { url = 'https://www.tentree.com/', query = 'hoodie', limit = 150 } = input; --- ## Output The actor returns a JSON object containing an array of products matching the search query. ### Example Output json { "products": [ { "id": 7165565731002, "title": "Highline Drop Shoulder Sweater", "handle": "womens-highline-drop-shoulder-crew-urban-green", "url": "https://www.tentree.com/products/womens-highline-drop-shoulder-crew-urban-green", "body_html": "<p>The next most sustainable option after having your grandma knit you a sweater. This sustainably made crewneck is great for chilly spring walks or nights at the cabin.</p>", "published_at": "2024-11-18T09:35:24-08:00", "created_at": "2022-08-10T17:14:16-07:00", "updated_at": "2024-11-21T04:42:18-08:00", "vendor": "tentree", "product_type": "Womens", "tags": [/* Array of tags */], "variants": [/* Array of variants */], "images": [/* Array of image URLs */], "options": [/* Array of options */] }, { "id": 7133073178810, "title": "Destination Latitude Short Light", "handle": "mens-destination-latitude-shorts-light", "url": "https://www.tentree.com/products/mens-destination-latitude-shorts-light", "body_html": "<p>These lightweight, everyday shorts are made from recycled polyester for a light, comfortable, stretchy fit that’s kind to the planet.</p>", "published_at": "2024-10-23T09:40:42-07:00", "created_at": "2022-07-12T21:21:21-07:00", "updated_at": "2024-11-21T04:42:18-08:00", "vendor": "tentree", "product_type": "Mens", "tags": [/* Array of tags */], "variants": [/* Array of variants */], "images": [/* Array of image URLs */], "options": [/* Array of options */] } ] } #### Key Fields - id: Unique identifier for the product. - title: Name of the product. - handle: Shopify handle for the product. - url: URL of the product page. - body_html: HTML description of the product. - published_at: Date and time when the product was published. - created_at: Date and time when the product was created. - updated_at: Last update date and time. - vendor: Name of the vendor or store. - product_type: Category of the product. - tags: Tags associated with the product. - variants: Array of product variants (e.g., sizes, colors). - images: Array of product image URLs. - options: Product options (e.g., size, color). --- ## How to Use 1. Set Up Input: Provide the url of the Shopify store, a query string, and a limit value for results. 2. Run the Actor: Execute the actor with your specified parameters. 3. Analyze Results: Use the returned JSON to extract product details matching your search query. --- ## FAQs 1. Q: Can I search for multiple queries at once? A: Currently, the actor supports one query per run. You can loop through multiple queries programmatically. 2. Q: Does this actor return pricing details? A: Yes, if the product variants include pricing information. 3. Q: Is there a default limit on the number of products retrieved? A: The default limit is 10, but you can customize it by setting the limit parameter. 4. Q: Can I use this actor for non-Shopify stores? A: No, this actor is designed specifically for Shopify-based stores. 5. Q: Does the actor include unpublished or hidden products? A: No, it retrieves only publicly accessible products. 6. Q: How are product images returned? A: Images are provided as an array of URLs, which can be used directly in your application. 7. Q: Can I filter products by category? A: While this actor doesn’t support category filtering directly, you can use specific keywords in the query to approximate category-based results. 8. Q: Is there a free trial for this actor? A: Yes, a 2-hour free trial is included to test its capabilities. --- ## SEO Benefits - Enhanced Product Pages: Enrich your website with detailed product information. - Targeted Content: Attract more visitors by focusing on high-demand queries. - Competitive Analysis: Keep tabs on competitor products and pricing. --- Simplify your Shopify product searches with the Shopify Product Search Scraper today! 🚀