Amazon Search Autocomplete Actor The Amazon Search Autocomplete Actor is a web scraping tool deployed on the Apify platform that retrieves search suggestions from Amazon's autocomplete. This actor mimics the autocomplete functionality you see when typing in Amazon's search box, providing valuable keyword insights for SEO, market research, and product discovery. ## Overview This actor extracts search suggestions that Amazon provides when users start typing in the search box. It's particularly useful for: - Keyword research and SEO optimization - Understanding popular search terms in specific markets - Product research and market analysis - Content strategy development - Competitive analysis ## Input Parameters ### Required Parameters - query (string, required): The search term or keywords you want to get suggestions for - Example: "shoes", "laptop", "coffee maker" - This is the base query that Amazon will use to generate autocomplete suggestions ### Optional Parameters - countryIso (string, optional): Two-letter ISO country code to target specific Amazon regional sites - Default: "us" (United States) - Supported countries: - au - Australia - be - Belgium - br - Brazil - ca - Canada - cn - China - eg - Egypt - fr - France - de - Germany - in - India - ie - Ireland - it - Italy - jp - Japan - mx - Mexico - nl - Netherlands - pl - Poland - sa - Saudi Arabia - sg - Singapore - za - South Africa - es - Spain - se - Sweden - tr - Turkey - ae - United Arab Emirates - gb - United Kingdom - us - United States ## Input Example json { "query": "shoes", "countryIso": "us" } ## Output Format The actor returns an array of suggestion objects. Each suggestion contains the following fields: ### Output Fields - suggType: Type of suggestion (typically "KeywordSuggestion") - type: Category of the suggestion (typically "KEYWORD") - value: The actual suggested search term - refTag: Amazon's internal reference tag for the suggestion - candidateSources: Source of the suggestion (e.g., "local") - strategyId: Amazon's internal strategy identifier (e.g., "organic") - prior: Priority score (typically 0) - ghost: Boolean indicating if it's a ghost suggestion - help: Boolean indicating if it's a help suggestion - queryUnderstandingFeatures: Array of query understanding features with source and annotations ## Output Example json [ { "suggType": "KeywordSuggestion", "type": "KEYWORD", "value": "shoes", "refTag": "nb_sb_ss_i_1_5", "candidateSources": "local", "strategyId": "organic", "prior": 0, "ghost": false, "help": false, "queryUnderstandingFeatures": [ { "source": "QU_TOOL", "annotations": [] } ] }, { "suggType": "KeywordSuggestion", "type": "KEYWORD", "value": "hoka shoes for woman", "refTag": "nb_sb_ss_i_2_5", "candidateSources": "local", "strategyId": "organic", "prior": 0, "ghost": false, "help": false, "queryUnderstandingFeatures": [ { "source": "QU_TOOL", "annotations": [] } ] } ] ## Use Cases ### 1. Keyword Research Use this actor to discover popular search terms related to your products or niche. The suggestions represent real user search patterns on Amazon. ### 2. SEO Optimization Identify long-tail keywords that people are actually searching for on Amazon to optimize your product listings and content. ### 3. Market Research Understand what variations and related terms people use when searching for products in your category. ### 4. International Market Analysis Use different country codes to see how search behavior varies across different Amazon marketplaces. ### 5. Content Strategy Generate ideas for blog posts, product descriptions, and marketing content based on actual search behavior. ## Technical Details ### Dependencies - Apify SDK: Core framework for building Apify actors - Axios: HTTP client for making API requests - Custom Helper Functions: Internal functions for processing Amazon's autocomplete API ### Performance - The actor processes one query at a time - Response time depends on Amazon's API response time - Typically returns 10+ suggestions per query ### Data Storage - Results are automatically stored in Apify's dataset - Output is also saved as a named value called 'output' - Data can be exported in various formats (JSON, CSV, Excel, etc.) ## Error Handling The actor includes comprehensive error handling: - Network timeouts and connection errors - Invalid country codes - Empty or malformed responses - Rate limiting from Amazon If an error occurs, the actor will log the error message and terminate gracefully. ## Best Practices 1. Reasonable Query Frequency: Don't overwhelm Amazon's servers with too many requests 2. Relevant Queries: Use meaningful search terms that relate to actual products 3. Country-Specific Research: Use appropriate country codes for your target markets 4. Data Analysis: Combine results with other tools for comprehensive keyword research ## Support and Troubleshooting If you encounter issues: 1. Check that your input parameters are correctly formatted 2. Verify that the country code is supported 3. Ensure your query string is not empty 4. Check Apify platform status for any service disruptions --- ## Support If you have any questions or encounter any issues, please consult the Apify documentation or reach out to us through one of the following channels: * Telegram: @pintoflow * Email: pintoflowpt@gmail.com * Apify Platform: You can also contact us directly through this platform. ---