> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brightdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 文本搜索

```示例 theme={null}
https://www.google.com/search?q=pizza
```

## 参数

<ParamField query="q" type="string" required>
  搜索查询参数。指定您要在 Google 上搜索的关键字或短语。

  ```示例 theme={null}
  https://www.google.com/search?q=pizza
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/search?q=pizza",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/search?q=pizza"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/search?q=pizza',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API 配置
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/search?q=pizza',
      'format': 'raw'
  }

  # 发送请求
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 highlight={4} theme={null}
  {
    "general": {
      "search_engine": "google",
      "query": "pizza",
      "results_cnt": 973000000,
      "search_time": 0.46,
      "language": "en-FR",
      "country": "France",
      "country_code": "FR",
      "location": "United States",
      "gl": "FR",
      "mobile": false,
      "basic_view": false,
      "search_type": "text",
      "page_title": "pizza - Google Search",
      "timestamp": "2026-02-24T20:05:07.171Z"
    },
    "input": {
      "original_url": "https://www.google.com/search?q=pizza&brd_json=1",
      "request_id": "hl_xxxxxxxxxxxxxxx"
    },
    "navigation": [
      {
        "title": "Images",
        "href": "https://www.google.com/search?sca_esv=016f34706b28a015&hl=en&udm=2&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3vWUtYx0DZdicpfE1faGYenqWn-q4MFiFFtvJjTKeAVxZj_-zzAfU38gMel7zJW-zoNwHG-ArsO6TrTEJcFsob0pdGO2ABo8o_HC5yJWwFB_-GDw4ME9hn952oqoD4-m1e6t3rE&q=pizza&sa=X&ved=2ahUKEwjh3oW59vKSAxV4bKQEHd32ALEQtKgLegQIHxAB"
      },
      {
        "title": "Videos",
        "href": "https://www.google.com/search?sca_esv=016f34706b28a015&hl=en&udm=7&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3vWUtYx0DZdicpfE1faGYenqWn-q4MFiFFtvJjTKeAVxZj_-zzAfU38gMel7zJW-zoNwHG-ArsO6TrTEJcFsob0pdGO2ABo8o_HC5yJWwFB_-GDw4ME9hn952oqoD4-m1e6t3rE&q=pizza&sa=X&ved=2ahUKEwjh3oW59vKSAxV4bKQEHd32ALEQtKgLegQIHhAB"
      },
      {
        "title": "Short videos",
        "href": "https://www.google.com/search?sca_esv=016f34706b28a015&hl=en&udm=39&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3vWUtYx0DZdicpfE1faGYenqWn-q4MFiFFtvJjTKeAVxZj_-zzAfU38gMel7zJW-zoNwHG-ArsO6TrTEJcFsob0pdGO2ABo8o_HC5yJWwFB_-GDw4ME9hn952oqoD4-m1e6t3rE&q=pizza&sa=X&ved=2ahUKEwjh3oW59vKSAxV4bKQEHd32ALEQs6gLegQIGhAB"
      },
      {
        "title": "News",
        "href": "https://www.google.com/search?sca_esv=016f34706b28a015&hl=en&q=pizza&tbm=nws&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3vWUtYx0DZdicpfE1faGYenqWn-q4MFiFFtvJjTKeAVxZj_-zzAfU38gMel7zJW-zoNwHG-ArsO6TrTEJcFsob0pdGO2ABo8o_HC5yJWwFB_-GDw4ME9hn952oqoD4-m1e6t3rE&sa=X&ved=2ahUKEwjh3oW59vKSAxV4bKQEHd32ALEQ0pQJegQIGBAB"
      },
      {
        "title": "Web",
        "href": "https://www.google.com/search?sca_esv=016f34706b28a015&hl=en&udm=web&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3vWUtYx0DZdicpfE1faGYenqWn-q4MFiFFtvJjTKeAVxZj_-zzAfU38gMel7zJW-zoNwHG-ArsO6TrTEJcFsob0pdGO2ABo8o_HC5yJWwFB_-GDw4ME9hn952oqoD4-m1e6t3rE&q=pizza&sa=X&ved=2ahUKEwjh3oW59vKSAxV4bKQEHd32ALEQs6gLegQIFxAB"
      },
      {
        "title": "Books",
        "href": "https://www.google.com/search?sca_esv=016f34706b28a015&hl=en&q=pizza&udm=36&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3vWUtYx0DZdicpfE1faGYenqWn-q4MFiFFtvJjTKeAVxZj_-zzAfU38gMel7zJW-zoNwHG-ArsO6TrTEJcFsob0pdGO2ABo8o_HC5yJWwFB_-GDw4ME9hn952oqoD4-m1e6t3rE&sa=X&ved=2ahUKEwjh3oW59vKSAxV4bKQEHd32ALEQ0pQJegQIFhAB"
      },
      {
        "title": "Finance",
        "href": "https://www.google.com/finance?sca_esv=016f34706b28a015&hl=en&output=search&q=pizza&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3vWUtYx0DZdicpfE1faGYenqWn-q4MFiFFtvJjTKeAVxZj_-zzAfU38gMel7zJW-zoNwHG-ArsO6TrTEJcFsob0pdGO2ABo8o_HC5yJWwFB_-GDw4ME9hn952oqoD4-m1e6t3rE&sa=X&ved=2ahUKEwjh3oW59vKSAxV4bKQEHd32ALEQ0pQJegQIexAB"
      }
    ],
    "organic": [
      {
        "link": "https://fr.wikipedia.org/wiki/Pizza",
        "source": "Wikipédia",
        "display_link": "https://fr.wikipedia.org › wiki › Pi...",
        "title": "Pizza",
        "description": "La pizza est une recette de cuisine traditionnelle de la cuisine italienne, originaire de Naples à base de galette de pâte à pain, garnie principalement ...Read more",
        "snippet_highlighted_words": [
          "pizza"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_alt": "pizza from fr.wikipedia.org",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 1,
        "global_rank": 1
      },
      {
        "link": "https://www.marmiton.org/recettes/recette_pizza-maison_313213.aspx",
        "source": "Marmiton",
        "display_link": "https://www.marmiton.org › recettes",
        "title": "Recette de Pizza maison",
        "description": "Partager la recette · Étape 1. Dans un saladier, placez les 300 g de farine, puis la levure, puis le bicarbonate de soude, la pincée de sel et celle de poivre.Read more",
        "extensions": [
          {
            "type": "rating",
            "rating": 5,
            "reviews_cnt": 23,
            "rank": 1
          }
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 2,
        "global_rank": 2
      },
      {
        "link": "https://cuisine.journaldesfemmes.fr/recette-pizza",
        "source": "Journal des Femmes",
        "display_link": "https://cuisine.journaldesfemmes.fr › ...",
        "title": "Pizza maison : recettes faciles et savoureuses",
        "description": "Pizza : Meilleures recettes · Pizza chèvre, figues, pistaches et miel · Pizza blanche au saumon fumé et à la cancoillotte · Pizza au salami de Milano et chorizo.Read more",
        "snippet_highlighted_words": [
          "Pizza",
          "Pizza",
          "Pizza",
          "Pizza"
        ],
        "extensions": [
          {
            "type": "rating",
            "rating": 4.3,
            "reviews_cnt": 96,
            "rank": 1
          }
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 3,
        "global_rank": 3
      },
      {
        "link": "https://www.pizzahut.fr/",
        "source": "Pizza Hut",
        "display_link": "https://www.pizzahut.fr",
        "title": "Pizza Hut Livraison, vente à emporter | Commande en ligne ...",
        "description": "Pizza Hut Livraison, vente à emporter | Commande en ligne | Coupons, Promos.",
        "snippet_highlighted_words": [
          "Pizza"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 4,
        "global_rank": 4
      },
      {
        "link": "https://www.dominos.fr/",
        "source": "Domino's Pizza",
        "display_link": "https://www.dominos.fr",
        "title": "Domino's Pizza, livraison et à emporter, commande en ligne",
        "description": "Commandez vos pizzas en ligne en livraison ou à emporter dans votre pizzeria Domino's la plus proche et dégustez-les en famille ou avec vos amis.",
        "snippet_highlighted_words": [
          "pizzas",
          "pizzeria"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTCf5qNZRvb7AOasK4bkZVf43P-y-6lDa_eBaxgXGw3BuqKmU5ictBb&usqp=CAE&s",
        "image_alt": "pizza from www.dominos.fr",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTCf5qN

  ```
</ResponseExample>
