SerpAPI - Search API

在这里插入图片描述



关于 SerpAPI


This repository is the home of the soon–to–be official Python API wrapper for SerpApi. This serpapimodule allows you to access search data in your Python application.

SerpApi supports Google, Google Maps, Google Shopping, Bing, Baidu, Yandex, Yahoo, eBay, App Stores, and more. Check out the documentation for a full list.


serpapi & google-search-results

Please note that this package is separate from the legacy serpapi module, which is available on PyPi as google-search-results.

This package is maintained by SerpApi, and is the recommended way to access the SerpApi service from Python.


有四种方案,其中免费的如下

我的CN手机号,没有收到验证码,所以注册失败

在这里插入图片描述



http 请求示例:

https://serpapi.com/search.json?q=Coffee&location=Austin,+Texas,+United+States&hl=en&gl=us&google_domain=google.com
https://serpapi.com/search.json?q=Coffee&location=Brazil&hl=pt&gl=br&google_domain=google.com.br


Python 调用示例

pip install serpapi

from serpapi import GoogleSearch

params = {
  "q": "Coffee",
  "location": "Austin, Texas, United States",
  "hl": "en",
  "gl": "us",
  "google_domain": "google.com",
  "api_key": "secret_api_key"
}

search = GoogleSearch(params)
results = search.get_dict()


Let’s start by searching for Coffee on Google:

>>> import serpapi
>>> s = serpapi.search(q="Coffee", 
                       engine="google", 
                       location="Austin, Texas", 
                       hl="en", 
                       gl="us")
# s 是一个 SerpResults 对象,像是一个标准 dict,上面添加了一些便捷的功能

# 打印日志:
>>> s["organic_results"][0]["link"]
'https://en.wikipedia.org/wiki/Coffee'

# 打印第一个结果,以 Python 的方式
>>> s["organic_results"][0].get("title")
'Coffee - Wikipedia'

s 内容如下:

{
    "search_metadata": {
        "id": "6602701cfe41d084fd3ed5da",
        "status": "Success",
        "json_endpoint": "https://serpapi.com/searches/a15e1b92727f292c/6602701cfe41d084fd3ed5da.json",
        "created_at": "2024-03-26 06:50:04 UTC",
        "processed_at": "2024-03-26 06:50:04 UTC",
        "google_url": "https://www.google.com/search?q=Coffee&oq=Coffee&uule=w+CAIQICIdQXVzdGluLFRYLFRleGFzLFVuaXRlZCBTdGF0ZXM&hl=en&gl=us&sourceid=chrome&ie=UTF-8",
        "raw_html_file": "https://serpapi.com/searches/a15e1b92727f292c/6602701cfe41d084fd3ed5da.html",
        "total_time_taken": 7.62
    },
    "search_parameters": {
        "engine": "google",
        "q": "Coffee",
        "location_requested": "Austin, Texas",
        "location_used": "Austin,TX,Texas,United States",
        "google_domain": "google.com",
        "hl": "en",
        "gl": "us",
        "device": "desktop"
    },
    "search_information": {
        "query_displayed": "Coffee",
        "total_results": 5760000000,
        "time_taken_displayed": 0.37,
        "organic_results_state": "Results for exact spelling"
    },
    "local_map": {
        "link": "https://www.google.com/search?sca_esv=6cb148437a7a9a38&gl=us&hl=en&q=Coffee&npsic=0&rflfq=1&rldoc=1&rllag=31994604,-99807361,55029&tbm=lcl&sa=X&ved=2ahUKEwizk5Ccq5GFAxUDjokEHeceA94QtgN6BAglEAE",
        "image": "https://serpapi.com/searches/6602701cfe41d084fd3ed5da/images/2677b372a72544dbbc26036d5c7b09db.png",
        "gps_coordinates": {
            "latitude": 31.994604,
            "longitude": -99.807361,
            "altitude": 55029
        }
    },
    "local_results": {
        "places": [
            {
                "position": 1,
                "rating": 4.7,
                "reviews_original": "(63)",
                "reviews": 63,
                "description": "Dine-in\u00b7Drive-through\u00b7No delivery",
                "place_id": "16666839338430965111",
                "place_id_search": "https://serpapi.com/search.json?device=desktop&engine=google&gl=us&google_domain=google.com&hl=en&location=Austin%2C+Texas&ludocid=16666839338430965111&q=Coffee",
                "lsig": "AB86z5WD7smQJJZYj7Eh1KXWdsl2",
                "thumbnail": "https://serpapi.com/searches/6602701cfe41d084fd3ed5da/images/47f37fc32e9075402698b02afcfe658f15416b9c44ead714051999e4f099a16f03170b796c045734.jpeg",
                "service_options": {
                    "dine_in": true,
                    "drive_through": true,
                    "no_delivery": true
                },
                "title": "The Branch Coffeehouse",
                "type": "Coffee shop",
                "address": "Tuscola, TX",
                "hours": "Closed \u22c5 Opens 6 AM"
            },
            {
                "position": 2,
                "rating": 4.3,
               ...
            },
            {
                "position": 3,
                "rating": 4.8,
                ...
            }
        ],
        "more_locations_link": "https://www.google.com/search?sca_esv=6cb148437a7a9a38&gl=us&hl=en&tbs=lf:1,lf_ui:9&tbm=lcl&q=Coffee&rflfq=1&num=10&uule=w+CAIQICIdQXVzdGluLFRYLFRleGFzLFVuaXRlZCBTdGF0ZXM&sa=X&ved=2ahUKEwizk5Ccq5GFAxUDjokEHeceA94QjGp6BAgrEAE"
    },
    "immersive_products": [
        {
            "thumbnail": "https://serpapi.com/searches/6602701cfe41d084fd3ed5da/images/49e6224fb883d7093d9d5db8b6707fcdcb9bf962cec4743d996f7845da535981.webp",
            "source": "Amazon.com, 10+",
            "title": "Folgers Classic Roast Ground Coffee",
            "price": "$4.49",
            "extracted_price": 4.49,
            "immersive_product_page_token": "eyJlaSI6IkluQU...lZSJ9",
            "serpapi_link": "https://serpapi.com/search.json?engine=google_immersive_product&page_token=eyJlaS...UENfZmZlZSJ9"
        },
        {
            "thumbnail": "https://serpapi.com/searches/6602701cfe41d084fd3ed5da/images/49e6224fb883d7093d9d5db8b6707fcd77fcca065cb1ab76d1fc85c40626c4b4.webp",
            "source": "Black Rifle Coffee Company, 10+",
            "title": "Black Rifle Coffee Company Murdered Out Coffee Roast",
            "price": "$16.99",
            "extracted_price": 16.99,
            "immersive_product_page_token": "eyJlaSI6IkluQUNaclA2QklPY3B0UV....UFJPRF9QQ18xNTQ3NzA1NTU4Nzk2OTQ3MTc4NSIsInF1ZXJ5IjoiQ29mZmVlIn0=",
            "serpapi_link": "https://serpapi.com/search.json?engine=google_immer...oiQ29mZmVlIn0%3D"
        },
        {
            ...
            "title": "Bones Coffee Company New Flavors! Favorite Flavors Sample Pack 4 oz Pack of 5 Assorted Coffee Beans",
          ...
        },
      
      	...
      
        {
            ...
            "title": "Starbucks Breakfast Blend Medium Roast Ground Coffee",
            ...
        }
    ],
  
    "related_questions": [
        {
            "question": "Is coffee actually healthy for you?",
            "snippet": "Hu said that moderate coffee intake\u2014about 2\u20135 cups a day\u2014is linked to a lower likelihood of type 2 diabetes, heart disease, liver and endometrial cancers, Parkinson's disease, and depression. It's even possible that people who drink coffee can reduce their risk of early death.",
            "title": "Is coffee good or bad for your health? | News - hsph.harvard.edu",
            "link": "https://www.hsph.harvard.edu/news/hsph-in-the-news/is-coffee-good-or-bad-for-your-health/#:~:text=Hu%20said%20that%20moderate%20coffee,their%20risk%20of%20early%20death.",
            "displayed_link": "https://www.hsph.harvard.edu \u203a news \u203a hsph-in-the-news",
            "source_logo": "https://serpapi.com/searches/6602701cfe41d084fd3ed5da/images/b460e89a15194171da0396937f5d7133523eb116b317ef2548aa4c977ab879e3.png",
            "next_page_token": "eyJvbnMiOiIx...XzIifQ==",
            "serpapi_link": "https://serpapi.com/search.json?device=desktop&engine=..."
        },
        ...
        {
            "question": "What are the 4 types of coffee?",
            "snippet": "Learn about the four most popular types of coffee beans\u2014Arabica, Robusta, Excelsa and Liberica\u2014and when to use them.",
            "title": "4 Types of Coffee Beans: How to Choose - KitchenAid",
            ...
        }
    ],
    "organic_results": [
        {
            "position": 1,
            "title": "Coffee",
            "link": "https://en.wikipedia.org/wiki/Coffee",
            "redirect_link": "https://www.google.comhttps://en.wikipedia.org/wiki/Coffee",
            "displayed_link": "https://en.wikipedia.org \u203a wiki \u203a Coffee",
            "thumbnail": "https://serpapi.com/searches/6602701cfe41d084fd3ed5da/images/19875953fd2763176ecb268a71b09fd91b6fe1da2d76a8e70422cfe845dba055.jpeg",
            "favicon": "https://serpapi.com/searches/6602701cfe41d084fd3ed5da/images/19875953fd2763176ecb268a71b09fd980eab7533207994f46f9cbdee41bc698.png",
            "snippet": "Coffee is a beverage brewed from roasted coffee beans. Darkly colored, bitter, and slightly acidic, coffee has a stimulating effect on humans, primarily due ...",
            "snippet_highlighted_words": [
                "Coffee",
                "coffee",
                "coffee"
            ],
            "sitelinks": {
                "inline": [
                    {
                        "title": "History",
                        "link": "https://en.wikipedia.org/wiki/History_of_coffee"
                    },
                    {
                        "title": "Coffee bean",
                        "link": "https://en.wikipedia.org/wiki/Coffee_bean"
                    },
                    {
                        "title": "Coffee production",
                        "link": "https://en.wikipedia.org/wiki/Coffee_production"
                    },
                    {
                        "title": "Coffee preparation",
                        "link": "https://en.wikipedia.org/wiki/Coffee_preparation"
                    }
                ]
            },
            "source": "Wikipedia"
        },
        
      ...
        {
            "position": 6,
            "title": "Counter Culture Coffee",
            ...
            "snippet_highlighted_words": [
                "Coffee",
                "coffee",
                "coffee",
                "coffee"
            ],
            "sitelinks": {
                "inline": [
                    {
                        "title": "Our Coffees",
                        "link": "https://counterculturecoffee.com/collections/coffee"
                    },
                    ...
                    {
                        "title": "Subscriptions",
                        "link": "https://counterculturecoffee.com/pages/on-going-subscription"
                    }
                ]
            },
            "rich_snippet": {
                "top": {
                    "detected_extensions": {
                        "free_day_delivery": 1
                    },
                    "extensions": [
                        "Free 1\u20134 day delivery"
                    ]
                }
            },
            "source": "Counter Culture Coffee"
        },
        {
            "position": 7,
            "title": "Coffee | The Nutrition Source - hsph.harvard.edu",
            ...
        },
        {
            "position": 8,
            "title": "Blanchard's Coffee Roasting Company",
            ...
            "sitelinks": {
                "inline": [
                    {
                        "title": "Products",
                        "link": "https://blanchardscoffee.com/collections/all"
                    },
                    {
                        "title": "Decent Instant Coffee",
                        "link": "https://blanchardscoffee.com/products/decent"
                    },
                    {
                        "title": "Blanchard's Cafe Pickup",
                        "link": "https://pickup.blanchardscoffee.com/"
                    },
                    {
                        "title": "Shop",
                        "link": "https://blanchardscoffee.com/pages/shop"
                    }
                ]
            },
            "rich_snippet": {
                "top": {
                    "detected_extensions": {
                        "price": 14,
                        "currency": "$ to $",
                        "unknown": 5
                    },
                    "extensions": [
                        "$14 to $15",
                        "\u200e 5",
                        "day delivery"
                    ]
                }
            },
            "source": "Blanchard's Coffee"
        },
        {
            "position": 9,
            "title": "The Coffee Bean & Tea Leaf | CBTL",
            "link": "https://www.coffeebean.com/",
            "redirect_link": "https://www.google.comhttps://www.coffeebean.com/",
            "displayed_link": "https://www.coffeebean.com",
            "favicon": "https://serpapi.com/searches/6602701cfe41d084fd3ed5da/images/19875953fd2763176ecb268a71b09fd9f88be5e04c633b3b580c37b1b81751ac.png",
            "snippet": "Born and brewed in Southern California since 1963, The Coffee Bean & Tea Leaf\u00ae is passionate about connecting loyal customers with carefully handcrafted ...",
            "snippet_highlighted_words": [
                "Coffee"
            ],
            "source": "The Coffee Bean & Tea Leaf"
        }
    ],
    "related_searches": [
        {
            "block_position": 1,
            "query": "Coffee shops near Texas",
            "image": "https://lh5.googleusercontent.com/p/AF1QipOYChzmH_DA-1Yz3mF8lQyEcinfGtJzaiUBxyUP=w40-h40-n-k-no"
        },
        {
            "block_position": 2,
            "query": "Great coffee shop near Texas",
            "image": "https://lh5.googleusercontent.com/p/AF1QipOYChzmH_DA-1Yz3mF8lQyEcinfGtJzaiUBxyUP=w40-h40-n-k-no"
        },
      ...
        {
            "block_position": 1,
            "query": "coffee powder",
            ...
        }
    ],
    "refine_this_search": [
        {
            "query": "Whole Bean",
            "link": "https://www.google.com/search?sca_esv=6cb148437a7a9a38&gl=us&hl=en&q=whole+bean+coffee&sa=X&ved=2ahUKEwizk5Ccq5GFAxUDjokEHeceA94Qs9oBKAB6BAguEAE",
            "serpapi_link": "https://serpapi.com/search.json?device=desktop&engine=google&gl=us&google_domain=google.com&hl=en&location=Austin%2C+Texas&q=whole+bean+coffee",
            "thumbnail": "https://encrypted-tbn2.gstatic.com/shopping?q=tbn:ANd9GcTJVcQZ1jGbu7SLjXBxneWc_xYUvdxhPAI1Gflp9AMbK4w7HS5fw3ItzDKnAx5qEle9SIbzx4FE9CZVnBoJDcN1jdTfbWEM50gozzPkGxbTQJ8236a419jb"
        },
        ...
        {
            "query": "Bag",
          ...
        },
        {
            "query": "Box",
            ...
        }
    ],
    "pagination": {
        "current": 1,
        "next": "https://www.google.com/search?q=Coffee&oq=Coffee&hl=en&gl=us&start=10&sourceid=chrome&ie=UTF-8",
        "other_pages": {
            "2": "https://www.google.com/search?q=Coffee&oq=Coffee&hl=en&gl=us&start=10&sourceid=chrome&ie=UTF-8",
            ...
            "5": "https://www.google.com/search?q=Coffee&oq=Coffee&hl=en&gl=us&start=40&sourceid=chrome&ie=UTF-8"
        }
    },
    "serpapi_pagination": {
        "current": 1,
        "next_link": "https://serpapi.com/search.json?device=desktop&engine=google&gl=us&google_domain=google.com&hl=en&location=Austin%2C+Texas&q=Coffee&start=10",
        "next": "https://serpapi.com/search.json?device=desktop&engine=google&gl=us&google_domain=google.com&hl=en&location=Austin%2C+Texas&q=Coffee&start=10",
        "other_pages": {
            "2": "https://serpapi.com/search.json?device=desktop&engine=google&gl=us&google_domain=google.com&hl=en&location=Austin%2C+Texas&q=Coffee&start=10",
            ...
            "5": "https://serpapi.com/search.json?device=desktop&engine=google&gl=us&google_domain=google.com&hl=en&location=Austin%2C+Texas&q=Coffee&start=40"
        }
    }
}


The SerpApi.com API Documentation contains a list of all the possible parameters that can be passed to the API.


Basic Examples in Python

Search Bing

import os
import serpapi

client = serpapi.Client(api_key=os.getenv("API_KEY"))

results = client.search({
    'engine': 'bing',
    'q': 'coffee',
})

Search Baidu

results = client.search({
    'engine': 'baidu',
    'q': 'coffee',
})

Search Yahoo

results = client.search({
    'engine': 'yahoo',
    'p': 'coffee',
})

Search YouTube

results = client.search({
    'engine': 'youtube',
    'search_query': 'coffee',
})

Search Walmart

results = client.search({
    'engine': 'walmart',
    'query': 'coffee',
})

Search eBay

results = client.search({
    'engine': 'ebay',
    '_nkw': 'coffee',
})

Search Naver

results = client.search({
    'engine': 'naver',
    'query': 'coffee',
})

Search Home Depot

results = client.search({
    'engine': 'home_depot',
    'q': 'table',
})

Search Apple App Store

results = client.search({
    'engine': 'apple_app_store',
    'term': 'coffee',
})

Search DuckDuckGo

results = client.search({
    'engine': 'duckduckgo',
    'q': 'coffee',
})

Search Google

results = client.search({
    'engine': 'google',
    'q': 'coffee',
    'engine': 'google',
})

Search Google Scholar

results = client.search({
    'engine': 'google_scholar',
    'q': 'coffee',
})

Search Google Autocomplete

results = client.search({
    'engine': 'google_autocomplete',
    'q': 'coffee',
})

Search Google Product

results = client.search({
    'engine': 'google_product',
    'q': 'coffee',
    'product_id': '4887235756540435899',
})

Search Google Reverse Image

results = client.search({
    'engine': 'google_reverse_image',
    'image_url': 'https://i.imgur.com/5bGzZi7.jpg',
    'max_results': '1',
})

Search Google Events

results = client.search({
    'engine': 'google_events',
    'q': 'coffee',
})

Search Google Local Services

results = client.search({
    'engine': 'google_local_services',
    'q': 'electrician',
    'data_cid': '6745062158417646970',
})

Search Google Maps

results = client.search({
    'engine': 'google_maps',
    'q': 'pizza',
    'll': '@40.7455096,-74.0083012,15.1z',
    'type': 'search',
})

Search Google Jobs

results = client.search({
    'engine': 'google_jobs',
    'q': 'coffee',
})

Search Google Play

results = client.search({
    'engine': 'google_play',
    'q': 'kite',
    'store': 'apps',
    'max_results': '2',
})

Search Google Images

results = client.search({
    'engine': 'google_images',
    'tbm': 'isch',
    'q': 'coffee',
})

2024-03-26(二)
头晕

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

编程乐园

请我喝杯伯爵奶茶~!

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值