100 free credits. No credit card required.Start building
Logo
Start for free
Google logoGoogle API

Scrape Google search and business data with one API

Fetch Google Search, Ads Transparency, Business Profiles, reviews, Q&A, and hotels as structured JSON with one SocialCrawl API key. No Google Cloud OAuth. Reads are priced in credits.

Read the docsHow it worksTry live
Google logo
/v1/google

10 active endpoints. SERP, ads, Maps business, hotels.

  • GET /v1/google/search
  • GET /v1/google/ad
  • GET /v1/google/adlibrary/advertisers/search
  • GET /v1/google/company/ads
  • GET /v1/google/business/info
  • GET /v1/google/business/extended-reviews
  • GET /v1/google/business/updates
  • GET /v1/google/business/questions
  • GET /v1/google/hotels/search
  • GET /v1/google/hotels/info

What Google endpoints does SocialCrawl ship?

Ten live read endpoints across Google web search, Ads Transparency, Business Profiles, and hotels. SERP at 1 credit. Ads and deep business pulls at 5. Data API only. No ranking tools, no Google Cloud project, no write access.

Web search

1 credit
/v1/google/search

Organic SERP rows for a query: title, URL, snippet, position. Optional region, date_posted window, and page.

query, region, date_posted, page

Ad creative

5 credits
/v1/google/ad

One Ads Transparency creative by full creative URL. Ad copy, advertiser, and format. Use a URL from company/ads.

url

Advertiser search

5 credits
/v1/google/adlibrary/advertisers/search

Find advertisers in the Ads Transparency Center by keyword. Optional region (defaults to US).

query, region

Company ads list

5 credits
/v1/google/company/ads

List ads by domain or advertiser_id. Filter by region, platform surface, format, and date range. Cursor pagination.

domain or advertiser_id, region, platform, cursor

Business profile

1 credit
/v1/google/business/info

Google Business Profile card: name, category, rating, address, phone, hours, attributes. Resolve by keyword, cid, or place_id.

keyword or cid or place_id, location_name, language_name

Extended reviews

5 credits
/v1/google/business/extended-reviews

Multi-source reviews for a place, including third-party outlets. Star rating, text, reviewer stats, owner replies. Depth controls count.

keyword or cid or place_id, depth

Business updates

1 credit
/v1/google/business/updates

Owner-published GBP posts: text, image, publish date, CTA link. Empty list means no posts, not a failure.

keyword or cid

Business Q&A

5 credits
/v1/google/business/questions

Community questions and answers on a Business Profile, flattened with parent_id links. Depth controls how many questions return.

keyword or cid or place_id, depth

Hotel search

1 credit
/v1/google/hotels/search

Hotels for a query: name, star rating, review score, coordinates, nightly price. Optional check_in and check_out. Returns hotel_identifier for detail.

keyword, check_in, check_out, location_name

Hotel detail

5 credits
/v1/google/hotels/info

Full hotel by hotel_identifier: description, amenities, review-sentiment topics, multi-vendor price comparison.

hotel_identifier

Google Search API10 endpoints supported
View docs

Returns Google web search results for a query: each result's title, page URL, text snippet, and its position in the ranking.

Use it for general web results; for Korean web pages use naver/webkr/search, and for news headlines use google_news/search.

1 credit

GET/v1/google/search?query=best+restaurants+in+London

query · Search keyword or phrase

$ curl https://www.socialcrawl.dev/v1/google/search?query=best+restaurants+in+London \
    -H "x-api-key: sc_YOUR_API_KEY"
idle
// Running this live needs your own API key. Hit "Try it" to see an example response

How the Google API works

Google is a normal SocialCrawl surface. You call GET /v1/google/… with an API key, spend credits on live misses, and get a single JSON envelope back. No Google Cloud OAuth. No second SDK.

Authenticate every call

Send your key in the x-api-key header. No Google Cloud project, no OAuth client secrets. The same key works for TikTok, Reddit, Google News, Google Finance, and the rest of the catalog.

GET with query params

All Google routes are GET. Pass query, url, domain, keyword, cid, place_id, hotel_identifier, region, depth, or cursor as query strings. We validate oneOf and formats before charging.

Pay in credits, not seats

SERP, business info, updates, and hotel search cost 1 credit. Ads Transparency, extended reviews, Q&A, and hotel info cost 5. Cache hits cost 0. Empty or hard failures refund.

Read one JSON envelope

Every response is the same shape: success, data, credits_used, credits_remaining, request_id, cached. Lists may carry pagination (page, cursor, has_more).

The usual integration chain

Most products do not call every endpoint on every tick. They search the web or resolve an advertiser, then deepen ads or business detail only when a hit matters.

01SERP
GET /v1/google/search?query=…

SearchResult list: title, url, snippet, position

Broad discovery by keyword. Page with page. Region narrows country results.

02Advertisers
GET /v1/google/adlibrary/advertisers/search?query=…

AuthorList of Ads Transparency advertisers

Resolve brand names to advertiser entities before listing creatives.

03Company ads
GET /v1/google/company/ads?domain=…

PostList of ads by domain or advertiser_id

Inventory of creatives and creative URLs. Feed /ad for full detail.

04Business profile
GET /v1/google/business/info?keyword=…

Place with rating, hours, contact, attributes

Local entity card once you have keyword, cid, or place_id.

request
GET /v1/google/search
  ?query=best+restaurants+in+London
  &region=UK
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here

# ads transparency
GET /v1/google/company/ads?domain=example.com&region=US
GET /v1/google/ad?url=https://adstransparency.google.com/advertiser/…/creative/…
response envelope
{
  "success": true,
  "data": {
    "items": [
      {
        "title": "Example result",
        "url": "https://example.com",
        "snippet": "…",
        "position": 1
      }
    ]
  },
  "credits_used": 1,
  "credits_remaining": 9999,
  "request_id": "req_…",
  "cached": false
}

What lands in data

Field names match the rest of SocialCrawl. SERP, ads, places, and reviews use shared archetypes so parsers stay reusable.

SearchResultsearch

items[] with title, url, snippet, position; page for further SERP pages

Post / PostListad, company/ads

ad creative detail or company ad rows; GBP updates as PostList with text, media, published_at

AuthorListadlibrary/advertisers/search

advertiser search hits: id, name, region context, transparency URLs in ext

Place / PlaceList / ReviewList / CommentListbusiness/*, hotels/*

business info and hotels as Place; hotel search as PlaceList; extended-reviews as ReviewList; Q&A as CommentList with parent_id

Inside the gateway

Same request lifecycle as every other /v1 platform endpoint. Google is not a sidecar.

  1. 01

    Edge receives the call

    Next.js catch-all routes into the Hono social API. We mint a request_id, authenticate the key, then enforce rate limit (600/min) and concurrency (50 in flight per key).

  2. 02

    Validate, then debit

    Registry lookup finds google/search (or ad, business/info, hotels/*). Required params and oneOf constraints run first. Invalid input returns 400 with no charge. Valid calls debit the tier cost atomically before upstream work.

  3. 03

    Cache or fetch

    A deterministic cache key is built from platform + resource + params. Hit: return immediately, credits_used = 0. Miss: SERP and ads read live; business and hotels run as server-side business-data reads. Retries on 5xx/network with a circuit breaker if the source is unhealthy.

  4. 04

    Normalize and return

    Upstream JSON is mapped to SearchResult, Post, AuthorList, Place, PlaceList, ReviewList, or CommentList, validated against the canonical Zod schema, then wrapped in the success envelope and logged for billing audit.

Billing rules that matter in production

  • SERP, business info, updates, hotel search live miss: 1 credit
  • Ads, extended reviews, Q&A, hotel info live miss: 5 credits
  • Optional company/ads get_ad_details path bills at the documented higher rate when enabled
  • Cache hit: 0 credits
  • Empty / hard fail: auto-refund
  • Bad params or oneOf miss: 400, never charged
  • No credits: 402, never charged
  • Upstream outage after debit: refund path applies
  • Disabled routes: 503, never charged

How we get the data

Google surfaces here are public-read search, ads transparency, and business data. We normalize them into the SocialCrawl schema so your code does not learn a second OAuth flow or three upstream SDKs.

What Google is for this API

Organic SERP, Ads Transparency creatives and advertisers, Business Profile cards, multi-source reviews, owner updates, Q&A, and hotel search plus detail. Read-only. No Search Console, no Ads Manager writes, no private account data.

How SocialCrawl reaches it

Search and Ads Transparency routes are read live on request. Business Profiles, extended reviews, updates, Q&A, and hotels run as server-side business-data reads. One SocialCrawl key covers all of them.

What leaves our edge

A unified JSON envelope: success, data, credits_used, request_id, cached. Organic rows become SearchResult. Creatives become Post. Places and hotels become Place or PlaceList. Reviews and Q&A share ReviewList and CommentList leaves.

What we do not ship live

No Google Cloud OAuth. No ranking history product. No async job_id surface for multi-minute review crawls yet. No write or moderation endpoints.

field map sketch
organic SERP row→ SearchResultorganic row title, url, snippet, position
Ads Transparency creative→ Post / PostListcreative URL, copy, advertiser, format from Ads Transparency
GBP / hotel listing→ Place / PlaceList / ReviewListGBP name, rating, hours; reviews and Q&A; hotel_identifier to detail

What this API is used for

The jobs this API is most often used for.

10active Google endpoints in the registry
1 / 5credit ladder for standard (1) and advanced (5)

SERP checks, ad intel, and local business enrichment

Callers concentrate on search, company/ads chains, and business/info. Hotels and Q&A show up when travel or local reputation jobs need deeper place data. SERP at 1 credit, Ads Transparency, and business and hotels on the same key. No Google Cloud OAuth project.

SERP and standard business reads are typically a few seconds on live miss. Ads lists and deep hotel detail can run longer when upstream work is heavier.

What people build with the Google API

The jobs Google data is most often used for. Each one is a full recipe with the endpoint chain and pricing.

Use case examples

Common ways teams put this data to work, and the stack each one tends to run.

SEO and research jobs

Python, cron, notebooks

Poll google/search for keyword SERP snapshots by region and date window. Store title, URL, position. Cache hits keep recurring runs cheap.

Competitive ad monitors

Node, workers, Slack bots

Resolve advertisers, list company/ads by domain, then open /ad for creative detail. Filter by platform surface and format.

Local data pipelines

Go, ETL, Explorer

business/info plus reviews, updates, or Q&A into CRM enrichment. hotels/search then hotels/info for travel inventory jobs. Same key as the rest of SocialCrawl.

Call it in two lines

Standard tier is one credit per live call. Advanced ads and deep business pulls are five. Cache hits are free.

curl "https://www.socialcrawl.dev/v1/google/search?query=best+restaurants+in+London&region=UK" \
  -H "x-api-key: sc_your_api_key_here"
curl "https://www.socialcrawl.dev/v1/google/business/info?keyword=Blue+Bottle+Coffee&location_name=San+Francisco" \
  -H "x-api-key: sc_your_api_key_here"
Google logoGoogle on SocialCrawl

Same key as the rest of the catalog

Platform docsGet an API key
Endpoints

What data does the Google Search API return?

Every endpoint returns structured JSON in a unified envelope. Computed fields such as engagement rate and content category are included only where the endpoint supports them and the required source inputs are present.

SearchGoogle web searchAdGet Google ad detailsAdlibrary Advertisers SearchSearch Google Ad Library advertisersCompany AdsList Google ads by companyBusiness InfoGet a Google Business ProfileBusiness Extended ReviewsGet Google extended (multi-source) reviewsBusiness UpdatesGet Google Business Profile posts (updates)Business QuestionsGet Google Business Profile questions & answersHotels SearchSearch Google hotelsHotels InfoGet Google hotel detail
Comparison

How does SocialCrawl compare to DIY SERP scraping for Google Search data?

Same Google Search data, two very different paths. Auth, rate limits, schema, and cost, side by side.

Authentication

SocialCrawl
One x-api-key header shared across 51 platforms
DIY SERP scraping
None, but you manage proxy credentials and session cookies yourself

Setup

SocialCrawl
One GET request; first call in minutes
DIY SERP scraping
Headless browsers, proxy rotation, and HTML parsers to build and host

Rate limits / CAPTCHAs

SocialCrawl
Flat credit pricing; CAPTCHA and block handling happens upstream
DIY SERP scraping
Google blocks aggressively. CAPTCHAs and IP bans are your problem

Response schema

SocialCrawl
Unified JSON envelope shared with all 51 platforms
DIY SERP scraping
Raw HTML that breaks every time Google changes its markup

Pricing

SocialCrawl
1 credit per SERP query, 5 for ad and review endpoints; 100 free credits
DIY SERP scraping
Free to attempt, but proxies and CAPTCHA solvers cost real money at scale

Data coverage

SocialCrawl
SERP, ad transparency, business profiles, reviews, Q&A, and hotels in one API
DIY SERP scraping
Each surface needs its own scraper and parser

Maintenance

SocialCrawl
Schema stays stable when Google changes its layout
DIY SERP scraping
Constant parser fixes as Google updates its HTML
FAQ

Have a question? We got answers

Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.

Contact us
How do I scrape Google with an API?
SocialCrawl provides 10 Google endpoints covering web search SERPs and the Google Ads Transparency Center (advertiser search and company ads). Send a GET request with your x-api-key. No Google Cloud project, no OAuth, and no SerpApi subscription required.
What Google endpoints does SocialCrawl offer?
10 endpoints, including Google web search (organic SERP results with title, URL, snippet, position), Google Ad Library advertiser search by keyword, and a company/advertiser ads feed filtered by domain, region, topic, and date range.
Is this a SerpApi or Bright Data alternative?
Yes. SocialCrawl returns Google SERP results and Ads Transparency Center data in the same unified schema used across all 51 platforms, so the code you write for Google search works identically for TikTok, Reddit, and YouTube. Flat pricing, no per-query CAPTCHA failures.
How much does the Google API cost?
Google web search costs 1 credit on the standard tier. Ad Transparency endpoints (advertiser search and company ads) cost 5 credits on the advanced tier because the upstream rendering is heavier. New accounts get 100 free credits, no credit card required.
Can I pull Google ads for competitor research?
Yes. Two endpoints wrap the Google Ads Transparency Center: search advertisers by name or brand keyword, and list every ad a company has run filtered by region, topic, and date range. Perfect for ad intelligence.
Do I need a Google Cloud or Google Ads account?
No. SocialCrawl works without a Google Cloud project, Custom Search Engine ID, Programmable Search API key, or Google Ads developer token. Pass your SocialCrawl x-api-key and a query or URL. The response comes back in the same schema every SocialCrawl platform uses.
Can I pull Google Business Profiles and reviews without the Places API?
Yes. SocialCrawl covers Google Business Profiles: profile info, reviews (including third-party sources like TripAdvisor and Yelp), owner posts, and community Q&A, with no Google Cloud project, no OAuth, and no per-place quota. It is a drop-in alternative to the Google Places and Business Profile APIs.
Does SocialCrawl cover Google Hotels and Travel data?
Yes. Two endpoints wrap Google Travel: hotel search returns name, star rating, review score, coordinates, images, and nightly price, while hotel info adds amenities across 14 categories, 27 review-sentiment topics, and a multi-vendor price comparison. All in the same unified schema.
What is the best Google scraper API?
SocialCrawl is a strong pick: 10 Google endpoints spanning SERP search, the Ads Transparency Center, Business Profiles with reviews and Q&A, and Google Travel hotels, all behind one x-api-key and a unified schema shared across 51 platforms. SERP queries cost 1 credit, with 100 free credits at signup and no credit card.
Does SocialCrawl offer a Google search results API?
Yes. SocialCrawl is the Google data API: one x-api-key returns Google web search SERPs (title, URL, snippet, position), Ads Transparency Center advertisers and creatives, Business Profiles with reviews and community Q&A, and Google Travel hotels, all in the unified schema shared across 51 platforms. There is no Google Cloud project, Custom Search Engine ID, or OAuth to set up. SERP queries cost 1 credit, and signup includes 100 free credits with no card.
Is scraping Google Search data legal?
SocialCrawl returns publicly available Google Search data and does not access private or login-gated content. Whether scraping fits your project depends on your use case and jurisdiction. You are responsible for complying with Google Search's terms of service and applicable data-protection laws such as GDPR and CCPA. This is general information, not legal advice.
Google Search scraping API vs the official Google Search API: what's the difference?
With SocialCrawl there is no app review or approval queue. Sign up and call Google Search endpoints immediately with a single x-api-key. Responses share one unified schema with every other SocialCrawl platform, and credit-based pricing replaces per-platform quotas. Official APIs are still the right choice for posting and other write actions: SocialCrawl is read-only data.

Ask AI about SocialCrawl

Ask ChatGPTAsk PerplexityAsk GeminiAsk ClaudeAsk Grok

Read the Google Search API reference in the docs

🤖 AI agent or LLM? Read this page as markdown