# Bing images

Search Bing Images with size, color, date and license filters. Needs q. Served by Litescrape.

Search Bing Images with size, color, date and license filters.

- Tool ID: `litescrape/bing-images`
- Name in the catalog: Bing Images
- Provider: [Litescrape](/providers/litescrape.md)
- Capability: [Web search for agents](/tools/web-search/web-search.md)
- Price: $0.00015 per call
- Authentication: an authorised Agentik workspace is required for execution, including zero-price tools.

## Pricing contract

The provider’s price, with no markup. Billed for measured usage.


```json
{
  "model": "per_call",
  "amountUsd": 0.00015
}
```

Pricing source: [https://litescrape.com/pricing](https://litescrape.com/pricing). $0.15 per 1,000 successful HTTP 200 requests; every native endpoint costs one call. Failed requests are not billed. Prepaid credits expire after six months..

Price verification date: 2026-11-03.

## Complete input schema


```json
{
  "additionalProperties": false,
  "properties": {
    "q": {
      "maxLength": 2048,
      "minLength": 1,
      "type": "string",
      "description": "Image search query, from 1 through 2,048 characters after trimming. Control characters are rejected."
    },
    "first": {
      "default": 1,
      "maximum": 10000,
      "minimum": 1,
      "type": "integer",
      "description": "One-based Bing result offset, from 1 through 10,000.\n\nPrefer litescrape_pagination.next when returned. Bing may reorder or repeat images between requests."
    },
    "count": {
      "default": 35,
      "maximum": 100,
      "minimum": 1,
      "type": "integer",
      "description": "Maximum images to return, from 1 through 100. Defaults to 35.\n\nBing may return fewer images. Follow the pagination link to retrieve another batch."
    },
    "mkt": {
      "anyOf": [
        {
          "pattern": "^[a-zA-Z]{2}-[a-zA-Z]{2}$",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Optional language-country market, such as en-US. Cannot be combined with cc."
    },
    "cc": {
      "anyOf": [
        {
          "pattern": "^[a-zA-Z]{2}$",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Optional two-letter country code. Cannot be combined with mkt."
    },
    "safeSearch": {
      "default": "moderate",
      "enum": [
        "off",
        "moderate",
        "strict"
      ],
      "type": "string",
      "description": "Bing content filter: off, moderate, or strict. Case-insensitive; defaults to moderate.\n\nBing may enforce stricter filtering for some markets."
    },
    "imagesize": {
      "anyOf": [
        {
          "enum": [
            "small",
            "medium",
            "large",
            "wallpaper"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Bing image size bucket: small, medium, large or wallpaper (extra large)."
    },
    "photo": {
      "anyOf": [
        {
          "enum": [
            "photo",
            "clipart",
            "linedrawing",
            "animatedgif",
            "transparent"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Photographs, clipart, line drawings, animated GIFs or images with transparent backgrounds."
    },
    "aspect": {
      "anyOf": [
        {
          "enum": [
            "square",
            "wide",
            "tall"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Filter to square, wide or tall images."
    },
    "color2": {
      "anyOf": [
        {
          "enum": [
            "color",
            "bw",
            "FGcls_RED",
            "FGcls_ORANGE",
            "FGcls_YELLOW",
            "FGcls_GREEN",
            "FGcls_TEAL",
            "FGcls_BLUE",
            "FGcls_PURPLE",
            "FGcls_PINK",
            "FGcls_BROWN",
            "FGcls_BLACK",
            "FGcls_GRAY",
            "FGcls_WHITE"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Use color for any color, bw for black and white, or a dominant color: FGcls_RED, FGcls_ORANGE, FGcls_YELLOW, FGcls_GREEN, FGcls_TEAL, FGcls_BLUE, FGcls_PURPLE, FGcls_PINK, FGcls_BROWN, FGcls_BLACK, FGcls_GRAY or FGcls_WHITE."
    },
    "face": {
      "anyOf": [
        {
          "enum": [
            "face",
            "portrait"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Use face for just faces or portrait for head-and-shoulders images."
    },
    "age": {
      "anyOf": [
        {
          "enum": [
            "lt1440",
            "lt10080",
            "lt43200",
            "lt525600"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Bing date filter: lt1440 (past 24 hours), lt10080 (past week), lt43200 (past month) or lt525600 (past year)."
    },
    "license": {
      "anyOf": [
        {
          "enum": [
            "L1",
            "L2",
            "L3",
            "L4",
            "L5",
            "L6",
            "L7",
            "L2_L3",
            "L2_L3_L4",
            "L2_L3_L5_L6",
            "L2_L3_L4_L5_L6_L7",
            "creativecommons"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Use creativecommons for all Creative Commons results, L1 for public domain, or native license categories L2 through L7. Bing also supports grouped categories.\n\nL2_L3_L4_L5_L6_L7: free to share and use. L2_L3_L4: free to share and use commercially. L2_L3_L5_L6: free to modify, share and use. L2_L3: free to modify, share and use commercially."
    },
    "qft": {
      "anyOf": [
        {
          "maxLength": 2048,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Optional native Bing Images qft filter expression, up to 2,048 characters without control characters.\n\nNamed image filters override the same category in qft and preserve unrelated categories. Without named filters, qft is passed through unchanged. Filter matching and availability are controlled by Bing."
    }
  },
  "required": [
    "q"
  ],
  "type": "object"
}
```

## Published example

This is the provider tool’s published example. Replace example values with the user’s requested inputs, respecting the schema; do not execute an example merely to test a connection.


```json
{
  "tool_id": "litescrape/bing-images",
  "input": {
    "q": "red panda",
    "count": 10,
    "mkt": "en-US"
  }
}
```

## Execute and retrieve

Inspect again before execution, explain the price and obtain the required authority. Use MCP run_tool or POST /v1/run with this tool ID, valid input and an idempotency key. Save the returned run ID and follow the actual state. If Agentik answers that the tool is temporarily unavailable, do not retry it blindly; use discovery to propose an alternative.

A partial or uncertain result can still have consumed provider resources. Consult [billing](/docs/billing.md), [idempotency](/docs/idempotency.md) and [asynchronous results](/docs/async.md).

[Provider documentation](https://litescrape.com/docs/reference#bing-images-parameters)

[REST inspection](https://api.agentik.cc/v1/tools/litescrape/bing-images) · [OpenAPI](/openapi.json) · [Connection guide](/connect.md)

---

[HTML page](/providers/litescrape/bing-images) · [Agent index](/llms.txt)
