Endpoints, authentication, and response formats for the Expand API
The Expand API extracts structured content from any web page. This reference covers the endpoints, authentication, and response formats.
Send all API requests to:
https://api.expand.aiEvery request needs an API key, passed in the x-expand-api-key header.
import Expand
The SDK can also read from the EXPAND_API_KEY environment variable.
curl -X POST https://api.expand.ai/v1/fetch \
-H "x-expand-api-key: {{API_KEY}}" \
-H "Content-Type: application/json" \
-d '{"url": "https://example.com"}'Make your first API call to extract content from a web page:
import Expand from 'expandai'
const client = new Expand({
apiKey: '{{API_KEY}}'
})
const result = await client.fetch({
url: 'https://example.com',
include: {
markdown: true
}
})
console.log(result.data.markdown)curl -X POST
Rate limits apply per organization. When you exceed yours, the API returns a 429 Too Many Requests status. See rate limiting.
Errors come back as standard HTTP status codes plus a JSON body whose _tag field identifies the error type. See error handling.