# ScrapingBee Gemini API

> Ask Gemini through ScrapingBee and receive citation objects when available.

## Endpoint and authentication

- Endpoint: `https://app.scrapingbee.com/api/v1/gemini`
- Required input: `prompt`.
- Authentication: `Authorization: Bearer YOUR_API_KEY`.
- The `api_key` query parameter remains supported for backward compatibility but is deprecated for new integrations.
- Cost: 15 credits per successful request.

## Parameters and response

- `add_html=false` by default; set `true` to include `full_html`.
- `country_code` accepts an ISO country code and sets request geolocation.
- `tag` is a response-header label and does not change model behavior.
- Gemini has no documented `search` parameter equivalent to the ChatGPT API's web-enhanced search.
- The response contains `prompt`, `results_markdown`, `results_text`, `citations`, and optional `full_html`.
- Failed requests are retried by ScrapingBee for up to 30 seconds. Account for that server-side retry window in client timeouts.
- Citations are not guaranteed and depend on the prompt; they are more likely for web-grounded answers than general-knowledge prompts. When present, each citation has `title`, `url`, `description`, and `text`.
- Use a specific prompt, relevant context, and explicit output expectations for more reliable results.