Google Search Actor

Scrape Google search results in real-time through an API. This actor returns structured data including organic results, ads, knowledge panels, and related queries.

Key Features

• Real-time results: Fetches current Google search data, not cached or delayed
• Structured output: Returns JSON with parsed search elements:
• Organic results (title, URL, snippet, position)
• Paid ads and shopping results
• Knowledge panels and featured snippets
• Related searches and "people also ask" questions
• Customizable searches: Supports location, language, and device type simulation
• Pagination: Automatically handles multiple search results pages
• Proxy support: Built-in proxy rotation to avoid blocks

How to Use

Run the actor via Apify API, Apify Console, or schedule regular crawls.

Basic API call:

curl "https://api.apify.com/v2/acts/apify~google-search/run-sync?token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"queries": ["web scraping tools"]}'

Using Apify SDK (JavaScript):

const results = await apify.call('apify/google-search', {
    queries: ['latest AI developments'],
    maxPagesPerQuery: 3,
    countryCode: 'US'
});

Configure runs in Apify Console by setting input parameters and selecting proxies.

Input/Output

Input configuration (main fields):
- queries: Array of search strings (required)
- maxPagesPerQuery: Results pages per query (default: 1)
- countryCode: Two-letter country code for localized results (e.g., "FR")
- languageCode: Language for results (e.g., "lang_en")
- mobileResults: Boolean to simulate mobile device

Output structure:
Each search result includes:
- query: The original search term
- organicResults: Array of standard search results with positions 1-N
- paidResults: Ads and sponsored listings
- knowledgePanel: Extracted entity information if present
- relatedQueries: Suggested searches from Google
- peopleAlsoAsk: Expanded Q&A sections

Example result object:

{
  "query": "web scraping",
  "organicResults": [
    {
      "title": "What Is Web Scraping?",
      "url": "https://example.com/web-scraping",
      "snippet": "Web scraping is data extraction from websites...",
      "position": 1
    }
  ],
  "searchMetadata": {
    "totalResults": "About 100,000,000 results",
    "timeTaken": 0.45
  }
}

Find the actor at: https://apify.com/apify/google-search?fpr=python_automation
View full documentation at: https://docs.apify.com/actors/examples/google-search