Skip to content

About

Bing Search API by Autom: Bing search results as structured JSON. Python, TypeScript, cURL, PHP, C#, Go, Java, Ruby examples.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

5 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Bing Search API by Autom

Bing Search API

Discord Get API key API docs License: MIT

The Autom Bing Search API returns Bing search results as structured JSON.

  • Bing Search API — Query Bing Search via API and retrieve structured organic results (title, link, snippet, position).

Use it for rank tracking on Bing, SEO research or LLM grounding.

Endpoint Request Credits
Bing Search API GET /v1/bing/search 1

Table of contents

How it works

  1. Create a Autom account and copy your API key from the dashboard.
  2. Call https://api.autom.dev with the header x-api-key: YOUR_API_KEY.
  3. Use the result in your app — no infrastructure to run.
export AUTOM_API_KEY="your-api-key"
pip install requests        # Python
# TypeScript: Node.js 18+ (native fetch), run with `npx tsx file.ts`

Bing Search API

Query Bing Search via API and retrieve structured organic results (title, link, snippet, position).

GET https://api.autom.dev/v1/bing/search · 1 credit per request · API reference

Request parameters

Parameter In Type Required Description
query query string ✅ The search query you want to run on Bing.
page query number — Page number for pagination (1 = first page).
num query number — Number of results per page (e.g. 10, 20, 50). This value is a suggestion.
location query string — Search origin location (e.g. city).
lat query number — GPS latitude for the search origin.
lon query number — GPS longitude for the search origin.
mkt query string — Market code where results come from (e.g. en-US). Cannot be used together with cc.
cc query string — Country code to search from (2-letter ISO 3166-1). Cannot be used together with mkt.

Python example

import os

import requests

API_KEY = os.environ["AUTOM_API_KEY"]
HEADERS = {"x-api-key": API_KEY}

response = requests.get(
    "https://api.autom.dev/v1/bing/search",
    headers=HEADERS,
    params={
        "query": "home",
    },
    timeout=120,
)
response.raise_for_status()

data = response.json()
print(data)

TypeScript example

type BingSearchApi = {
  pagination?: {
    next?: number;
    current?: number;
    has_next_page?: boolean;
  };
  organic_results?: {
    link?: string;
    title?: string;
    domain?: string;
    snippet?: string;
    position?: number;
  }[];
  search_parameters?: {
    q?: string;
    cc?: string;
    mkt?: string;
    page?: number;
    engine?: string;
  };
};

const headers = { "x-api-key": process.env.AUTOM_API_KEY!, "Content-Type": "application/json" };

const params = new URLSearchParams({
  "query": "home",
});

const response = await fetch(`https://api.autom.dev/v1/bing/search?${params}`, { headers });
if (!response.ok) throw new Error(`HTTP ${response.status}: ${await response.text()}`);

const data = (await response.json()) as BingSearchApi;
console.log(data);

Output example

Example response from the API reference, abridged.

{
  "pagination": {
    "next": 2,
    "current": 1,
    "has_next_page": true
  },
  "organic_results": [
    {
      "link": "https://openai.com/",
      "title": "OpenAI",
      "domain": "openai.com",
      "snippet": "OpenAI is an AI research and deployment company.",
      "position": 1
    }
  ],
  "search_parameters": {
    "q": "openai",
    "cc": "us",
    "mkt": "en-US",
    "page": 1,
    "engine": "bing"
  }
}

Response fields

Field Type Description
pagination object
pagination.next integer
pagination.current integer
pagination.has_next_page boolean
organic_results[] object[]
organic_results[].link string
organic_results[].title string
organic_results[].domain string
organic_results[].snippet string
organic_results[].position integer
search_parameters object
search_parameters.q string
search_parameters.cc string
search_parameters.mkt string
search_parameters.page integer
search_parameters.engine string

Code examples in other languages

Ready-to-run examples live in examples/; each reads your key from AUTOM_API_KEY.

Language bing-search
cURL (Bash) bing_search.sh
PHP bing_search.php
C# BingSearch.cs
Go bing_search.go
Java BingSearchExample.java
Ruby bing_search.rb
Node.js bing_search.mjs

Use cases

  • Rank tracking — Track positions on Bing.
  • LLM grounding — Feed agents with fresh results.

Why Autom?

  • Every SERP in one API — Google Search, AI Mode, Maps, News, Shopping, Images, Videos, Jobs, Autocomplete, plus Bing and Brave.
  • Structured JSON — documented fields instead of brittle HTML parsing.
  • Geo & language targeting — search like a user from the country and language you need.
  • One API key, one header — x-api-key on every request.
  • Copy-paste examples — Python and TypeScript in each README, 7 more languages in examples/.

FAQ

How do I authenticate?

Create an account on Autom, copy your API key and send it in the x-api-key header of every request to https://api.autom.dev.

How much does a request cost?

Credits per call: /v1/bing/search 1. See Autom pricing.

Which languages are supported?

Any language that can make an HTTP request. This README shows Python and TypeScript; the examples/ folder contains cURL, PHP, C#, Go, Java, Ruby and Node.js.

Official SDKs

Use Autom from your own language with a typed client:

SDK Package Install
Node.js @automdev/sdk npm install @automdev/sdk
Python automdev pip install automdev
Go autom-go go get github.com/automdev/autom-go
.NET Autom dotnet add package Autom
Ruby autom gem install autom
PHP autom/sdk composer require autom/sdk
Java autom-java build from source, see its README
CLI @automdev/cli npm install -g @automdev/cli
MCP server @automdev/mcp npx -y @automdev/mcp

Related repositories

Support


Autom
Built by Autom. Examples are released under the MIT license.

About

Bing Search API by Autom: Bing search results as structured JSON. Python, TypeScript, cURL, PHP, C#, Go, Java, Ruby examples.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors