Sahifa Take API
The Take API from Sahifa — 1 operation(s) for take.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/sahifa:sahifa-take-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Sahifa Take API
version: '2026-09-24'
description: 'HTML to PDF and screenshot API hosted in Jeddah, Saudi Arabia. Compatible with PDFShift v3 and ScreenshotOne. Documentation: https://sahifa.dev/docs'
contact:
email: support@sahifa.dev
url: https://sahifa.dev/docs
servers:
- url: https://api.sahifa.dev
description: Jeddah (me-jeddah-1)
security:
- basicAuth: []
- apiKeyHeader: []
- accessKey: []
tags:
- name: Take
paths:
/take:
get:
operationId: takeScreenshot
summary: Screenshot of a URL or HTML (ScreenshotOne compatible)
parameters:
- name: url
in: query
required: false
schema:
type: string
format: uri
description: Public http(s) address to capture. Send exactly one of url and html.
description: Public http(s) address to capture. Send exactly one of url and html.
- name: html
in: query
required: false
schema:
type: string
description: HTML document to capture.
description: HTML document to capture.
- name: format
in: query
required: false
schema:
type: string
enum:
- png
- jpeg
- jpg
- webp
- pdf
default: png
description: ''
- name: image_quality
in: query
required: false
schema:
type: integer
minimum: 1
maximum: 100
description: For jpeg and webp.
description: For jpeg and webp.
- name: omit_background
in: query
required: false
schema:
type: boolean
description: ''
- name: full_page
in: query
required: false
schema:
type: boolean
description: ''
- name: viewport_width
in: query
required: false
schema:
type: integer
default: 1280
maximum: 10000
description: ''
- name: viewport_height
in: query
required: false
schema:
type: integer
default: 720
maximum: 10000
description: ''
- name: device_scale_factor
in: query
required: false
schema:
type: number
default: 1
minimum: 0.1
maximum: 4
description: ''
- name: selector
in: query
required: false
schema:
type: string
description: CSS selector of one element to capture; 404 if nothing matches.
description: CSS selector of one element to capture; 404 if nothing matches.
- name: clip_x
in: query
required: false
schema:
type: integer
description: ''
- name: clip_y
in: query
required: false
schema:
type: integer
description: ''
- name: clip_width
in: query
required: false
schema:
type: integer
description: ''
- name: clip_height
in: query
required: false
schema:
type: integer
description: ''
- name: dark_mode
in: query
required: false
schema:
type: boolean
description: ''
- name: reduced_motion
in: query
required: false
schema:
type: boolean
description: ''
- name: user_agent
in: query
required: false
schema:
type: string
description: ''
- name: authorization
in: query
required: false
schema:
type: string
description: Authorization header sent to the page.
description: Authorization header sent to the page.
- name: headers
in: query
required: false
schema:
type: array
items:
type: string
description: Name=value pairs.
description: Name=value pairs.
- name: cookies
in: query
required: false
schema:
type: array
items:
type: string
description: name=value pairs.
description: name=value pairs.
- name: delay
in: query
required: false
schema:
type: number
minimum: 0
maximum: 30
description: Seconds.
description: Seconds.
- name: timeout
in: query
required: false
schema:
type: number
minimum: 1
maximum: 100
description: Seconds; capped at 30.
description: Seconds; capped at 30.
- name: wait_until
in: query
required: false
schema:
type: string
enum:
- load
- domcontentloaded
- networkidle
- commit
default: load
description: ''
- name: wait_for_selector
in: query
required: false
schema:
type: string
description: ''
- name: response_type
in: query
required: false
schema:
type: string
enum:
- by_format
- json
default: by_format
description: ''
- name: cache
in: query
required: false
schema:
type: boolean
description: Accepted and ignored.
description: Accepted and ignored.
- name: block_ads
in: query
required: false
schema:
type: boolean
description: ''
- name: block_trackers
in: query
required: false
schema:
type: boolean
description: ''
- name: block_cookie_banners
in: query
required: false
schema:
type: boolean
description: ''
- name: block_chats
in: query
required: false
schema:
type: boolean
description: ''
- name: hide_selectors
in: query
required: false
schema:
type: array
items:
type: string
description: ''
- name: block_requests
in: query
required: false
schema:
type: array
items:
type: string
description: URL patterns, * as wildcard.
description: URL patterns, * as wildcard.
- name: block_resources
in: query
required: false
schema:
type: array
items:
type: string
enum:
- image
- font
- media
- script
- stylesheet
- xhr
- fetch
- websocket
- other
- document
description: ''
responses:
'200':
$ref: '#/components/responses/Screenshot'
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
description: Selector not found
'400':
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
description: Invalid request
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
description: Missing or invalid API key
'402':
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
description: Monthly render allowance used up
'408':
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
description: Rendering timed out
'413':
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
description: Request body over 10 MB
'429':
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
description: Render queue full; retry
'500':
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
description: Rendering error
'503':
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
description: Temporarily unavailable; retry
tags:
- Take
post:
operationId: takeScreenshotPost
summary: Screenshot with a JSON body
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
url:
type: string
format: uri
description: Public http(s) address to capture. Send exactly one of url and html.
html:
type: string
description: HTML document to capture.
format:
type: string
enum:
- png
- jpeg
- jpg
- webp
- pdf
default: png
image_quality:
type: integer
minimum: 1
maximum: 100
description: For jpeg and webp.
omit_background:
type: boolean
full_page:
type: boolean
viewport_width:
type: integer
default: 1280
maximum: 10000
viewport_height:
type: integer
default: 720
maximum: 10000
device_scale_factor:
type: number
default: 1
minimum: 0.1
maximum: 4
selector:
type: string
description: CSS selector of one element to capture; 404 if nothing matches.
clip_x:
type: integer
clip_y:
type: integer
clip_width:
type: integer
clip_height:
type: integer
dark_mode:
type: boolean
reduced_motion:
type: boolean
user_agent:
type: string
authorization:
type: string
description: Authorization header sent to the page.
headers:
type: array
items:
type: string
description: Name=value pairs.
cookies:
type: array
items:
type: string
description: name=value pairs.
delay:
type: number
minimum: 0
maximum: 30
description: Seconds.
timeout:
type: number
minimum: 1
maximum: 100
description: Seconds; capped at 30.
wait_until:
type: string
enum:
- load
- domcontentloaded
- networkidle
- commit
default: load
wait_for_selector:
type: string
response_type:
type: string
enum:
- by_format
- json
default: by_format
cache:
type: boolean
description: Accepted and ignored.
block_ads:
type: boolean
block_trackers:
type: boolean
block_cookie_banners:
type: boolean
block_chats:
type: boolean
hide_selectors:
type: array
items:
type: string
block_requests:
type: array
items:
type: string
description: URL patterns, * as wildcard.
block_resources:
type: array
items:
type: string
enum:
- image
- font
- media
- script
- stylesheet
- xhr
- fetch
- websocket
- other
- document
responses:
'200':
$ref: '#/components/responses/Screenshot'
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
description: Selector not found
'400':
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
description: Invalid request
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
description: Missing or invalid API key
'402':
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
description: Monthly render allowance used up
'408':
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
description: Rendering timed out
'413':
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
description: Request body over 10 MB
'429':
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
description: Render queue full; retry
'500':
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
description: Rendering error
'503':
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
description: Temporarily unavailable; retry
tags:
- Take
components:
schemas:
Error:
type: object
properties:
success:
type: boolean
const: false
error:
type: string
responses:
Screenshot:
description: The image or PDF, or JSON when response_type=json
headers:
X-Response-Duration:
schema:
type: integer
description: Render time in milliseconds
X-Quota-Limit:
schema:
type: integer
description: Monthly render allowance of the key
X-Quota-Remaining:
schema:
type: integer
description: Renders left this month before this request
content:
image/png:
schema:
type: string
format: binary
image/jpeg:
schema:
type: string
format: binary
image/webp:
schema:
type: string
format: binary
application/pdf:
schema:
type: string
format: binary
application/json:
schema:
type: object
properties:
success:
type: boolean
content_type:
type: string
data:
type: string
contentEncoding: base64
size:
type: integer
securitySchemes:
basicAuth:
type: http
scheme: basic
description: User 'api', password = your API key (PDFShift style).
apiKeyHeader:
type: apiKey
in: header
name: X-API-Key
accessKey:
type: apiKey
in: query
name: access_key
description: ScreenshotOne style.