Programmatically manage press releases, campaigns, and media contacts. Available on the Agency plan.
All API requests require a Bearer token in the Authorization header. API keys are available to users on the Agency plan.
To create an API key, go to Settings → API Keys in your ArtWire dashboard. The key is shown only once at creation time; store it securely.
Authorization: Bearer aw_live_abc123...All requests must be made over HTTPS. Requests without a valid token receive a 401 response.
The API allows 60 requests per minute per IP address. When the limit is exceeded, the API returns a 429 status with these headers:
| Parameter | Type | Required | Description |
|---|---|---|---|
| Retry-After | integer | Optional | Seconds until the rate limit window resets |
| X-RateLimit-Limit | integer | Optional | Maximum requests allowed per window (60) |
| X-RateLimit-Remaining | integer | Optional | Requests remaining in the current window |
| X-RateLimit-Reset | integer | Optional | Unix timestamp when the window resets |
All error responses return a JSON object with an error field. Validation errors also include a details object.
{
"error": "Validation failed",
"details": {
"title": ["Title is required"]
}
}/api/v1/press-releasesReturns a paginated list of the authenticated user's press releases, ordered by creation date (newest first).
| Parameter | Type | Required | Description |
|---|---|---|---|
| limit | integer | Optional | Number of results per page (1-100, default 20) |
| offset | integer | Optional | Number of results to skip (default 0) |
| status | string | Optional | Filter by status: "draft", "published", or "archived" |
curl https://artwire.art/api/v1/press-releases?limit=10&offset=0 \
-H "Authorization: Bearer aw_live_abc123..."{
"data": [
{
"id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"title": "Maria Alvarez: Luminous Threads",
"subtitle": "A solo exhibition at Tate Modern",
"body": "Tate Modern is pleased to announce...",
"category": "exhibition_opening",
"artist_name": "Maria Alvarez",
"venue_name": "Tate Modern",
"exhibition_title": "Luminous Threads",
"location": "London, UK",
"start_date": "2026-05-01",
"end_date": "2026-08-15",
"status": "published",
"slug": "maria-alvarez-luminous-threads-m3kx9",
"created_at": "2026-04-01T10:30:00Z",
"updated_at": "2026-04-01T10:30:00Z"
}
],
"meta": {
"total": 42,
"limit": 10,
"offset": 0
}
}/api/v1/press-releasesCreates a new press release. Returns the created resource.
| Parameter | Type | Required | Description |
|---|---|---|---|
| title | string | Required | Title of the press release (max 500 chars) |
| body | string | Required | Full body text of the press release |
| subtitle | string | Optional | Subtitle or tagline (max 500 chars) |
| category | string | Optional | Category slug (e.g. "exhibition_opening", "art_fair", "artist_award") |
| artist_name | string | Optional | Name of the featured artist |
| venue_name | string | Optional | Gallery or venue name |
| exhibition_title | string | Optional | Exhibition title if applicable |
| location | string | Optional | City and country (e.g. "London, UK") |
| start_date | string | Optional | Exhibition start date (ISO 8601) |
| end_date | string | Optional | Exhibition end date (ISO 8601) |
| status | string | Optional | "draft" (default) or "published" |
curl -X POST https://artwire.art/api/v1/press-releases \
-H "Authorization: Bearer aw_live_abc123..." \
-H "Content-Type: application/json" \
-d '{
"title": "Maria Alvarez: Luminous Threads",
"subtitle": "A solo exhibition at Tate Modern",
"body": "Tate Modern is pleased to announce...",
"category": "exhibition_opening",
"artist_name": "Maria Alvarez",
"venue_name": "Tate Modern",
"location": "London, UK",
"start_date": "2026-05-01",
"end_date": "2026-08-15",
"status": "draft"
}'{
"data": {
"id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"title": "Maria Alvarez: Luminous Threads",
"subtitle": "A solo exhibition at Tate Modern",
"body": "Tate Modern is pleased to announce...",
"category": "exhibition_opening",
"artist_name": "Maria Alvarez",
"venue_name": "Tate Modern",
"exhibition_title": null,
"location": "London, UK",
"start_date": "2026-05-01",
"end_date": "2026-08-15",
"status": "draft",
"slug": "maria-alvarez-luminous-threads-m3kx9",
"created_at": "2026-04-01T10:30:00Z",
"updated_at": "2026-04-01T10:30:00Z"
}
}/api/v1/campaignsCreate campaigns, add recipients, send emails, and track open/click metrics programmatically. This endpoint is under development.
/api/v1/media-contactsSearch and filter the ArtWire media contact database. Look up journalists by beat, region, publication, and more.
/api/v1/ai/generateGenerate press releases using ArtWire's AI engine via the API. Provide a category and details, and receive a full press release draft.