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

{
  "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

[
  {
    "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.

---