# Writesonic

> Read Writesonic GEO and SEO exports, inspect content issues and generate optimization recommendations.

App · 19 actions. Web page: https://docs.lodol.com/docs/integrations/writesonic

## Actions

### Export AI platforms

Export AI platforms.

**Inputs**

- Url (`url`, text): Leave empty to use the site saved on this connection.
- Project id (`project_id`, text): Optional Project ID to filter the site
- Page (`page`, number): Page number for pagination. At least 1. Default: `1`.
- Size (`size`, number): Number of items per page. From 1 to 100. Default: `50`.

**Outputs**

- `data` (object): Returned value.

**Example output**

```json
{
  "data": {
    "count": 1,
    "items": [],
    "page": 1,
    "size": 1,
    "total": 1,
    "total_pages": 1
  }
}
```

### Export citations

Export citations.

**Inputs**

- Date (`date`, date, required): Date to export (UTC)
- Compare date (`compare_date`, date): Optional comparison date (UTC) for deltas
- Topic id (`topic_id`, text): Filter by Topic ID
- Platform id (`platform_id`, text): Filter by Platform/Model ID
- Prompt id (`prompt_id`, text): Filter by Prompt ID
- Citation id (`citation_id`, text): Filter by Citation ID
- Url (`url`, text): Leave empty to use the site saved on this connection.
- Project id (`project_id`, text): Optional Project ID to filter the site
- Page (`page`, number): Page number for pagination. At least 1. Default: `1`.
- Size (`size`, number): Number of items per page. From 1 to 100. Default: `50`.

**Outputs**

- `data` (object): Returned value.

**Example output**

```json
{
  "data": {
    "count": 1,
    "items": [],
    "page": 1,
    "size": 1,
    "total": 1,
    "total_pages": 1
  }
}
```

### Export keywords

Export keywords.

**Inputs**

- Date (`date`, date, required): Date to export (UTC)
- Compare date (`compare_date`, date): Optional comparison date (UTC) for deltas
- Topic id (`topic_id`, text): Filter by Topic ID
- Platform id (`platform_id`, text): Filter by Platform/Model ID
- Subtheme id (`subtheme_id`, text): Filter by Subtheme ID
- Url (`url`, text): Leave empty to use the site saved on this connection.
- Project id (`project_id`, text): Optional Project ID to filter the site
- Page (`page`, number): Page number for pagination. At least 1. Default: `1`.
- Size (`size`, number): Number of items per page. From 1 to 100. Default: `50`.

**Outputs**

- `data` (object): Returned value.

**Example output**

```json
{
  "data": {
    "count": 1,
    "items": [],
    "page": 1,
    "size": 1,
    "total": 1,
    "total_pages": 1
  }
}
```

### Export prompts

Export prompts. Returns one page; use its continuation fields to request the next page.

**Inputs**

- Url (`url`, text): Leave empty to use the site saved on this connection.
- Project id (`project_id`, text): Optional Project ID to filter the site
- Page (`page`, number): Page number for pagination. At least 1. Default: `1`.
- Size (`size`, number): Number of items per page. From 1 to 100. Default: `50`.

**Outputs**

- `data` (object): Returned value.

**Example output**

```json
{
  "data": {
    "count": 1,
    "items": [],
    "page": 1,
    "size": 1,
    "total": 1,
    "total_pages": 1
  }
}
```

### Export topics

Export topics. Returns one page; use its continuation fields to request the next page.

**Inputs**

- Url (`url`, text): Leave empty to use the site saved on this connection.
- Project id (`project_id`, text): Optional Project ID to filter the site
- Page (`page`, number): Page number for pagination. At least 1. Default: `1`.
- Size (`size`, number): Number of items per page. From 1 to 100. Default: `50`.

**Outputs**

- `data` (object): Returned value.

**Example output**

```json
{
  "data": {
    "count": 1,
    "items": [],
    "page": 1,
    "size": 1,
    "total": 1,
    "total_pages": 1
  }
}
```

### Export websites

Export websites. Returns one page; use its continuation fields to request the next page.

**Inputs**

- Url (`url`, text): Leave empty to use the site saved on this connection.
- Project id (`project_id`, text): Optional Project ID to filter the site
- Page (`page`, number): Page number for pagination. At least 1. Default: `1`.
- Size (`size`, number): Number of items per page. From 1 to 100. Default: `50`.

**Outputs**

- `data` (object): Returned value.

**Example output**

```json
{
  "data": {
    "count": 1,
    "items": [],
    "page": 1,
    "size": 1,
    "total": 1,
    "total_pages": 1
  }
}
```

### Generate fixes for multiple pages

Generate fixes for multiple pages.

**Inputs**

- Url (`url`, text): Leave empty to use the site saved on this connection.
- Project id (`project_id`, text): Optional Project ID to filter the site
- Page urls (`page_urls`, list, required): Page urls.

**Outputs**

- `data` (object): Returned value.

**Example output**

```json
{
  "data": {
    "results": []
  }
}
```

### Generate optimization fixes

Generate optimization fixes.

**Inputs**

- Url (`url`, text): Leave empty to use the site saved on this connection.
- Project id (`project_id`, text): Optional Project ID to filter the site
- Page url (`page_url`, text, required): Page url.
- Issue type (`issue_type`, text, required): Issue type. One of: `TITLE`, `META_DESCRIPTION` (Meta description), `SCHEMA_MARKUP` (Schema markup), `KEY_TAKEAWAY` (Key takeaway), `FAQ`, `FAQ_ENHANCEMENTS` (Faq enhancements), `AUTHORITY_SIGNAL` (Authority signal), `BRAND_MENTIONED` (Brand mentioned), `EXPERT_QUOTE` (Expert quote), `COMPARISON_TABLE` (Comparison table), and 4 more.
- Excluded issue ids (`excluded_issue_ids`, list): Excluded issue ids.

**Outputs**

- `data` (object): Returned value.

**Example output**

```json
{
  "data": {
    "message": "example",
    "success": false
  }
}
```

### Get all page recommendations

Get all page recommendations.

**Inputs**

- Url (`url`, text): Leave empty to use the site saved on this connection.
- Project id (`project_id`, text): Optional Project ID to filter the site
- Page url (`page_url`, text, required): The URL of the specific page to analyze

**Outputs**

- `data` (object): Returned value.

**Example output**

```json
{
  "data": {
    "optimization_page_id": "example",
    "page_url": "example",
    "recommendations": []
  }
}
```

### Get answer performance

Get answer performance.

**Inputs**

- Date (`date`, date, required): Date to export (UTC)
- Topic id (`topic_id`, text): Filter by Topic ID
- Platform id (`platform_id`, text): Filter by Platform ID
- Prompt id (`prompt_id`, text): Filter by Prompt ID
- Url (`url`, text): Leave empty to use the site saved on this connection.
- Project id (`project_id`, text): Optional Project ID to filter the site
- Page (`page`, number): Page number for pagination. At least 1. Default: `1`.
- Size (`size`, number): Number of items per page. From 1 to 100. Default: `50`.

**Outputs**

- `data` (object): Returned value.

**Example output**

```json
{
  "data": {
    "count": 1,
    "items": [],
    "page": 1,
    "size": 1,
    "total": 1,
    "total_pages": 1
  }
}
```

### Get daily performance summary

Get daily performance summary.

**Inputs**

- Date (`date`, date, required): Date to export (UTC)
- Compare date (`compare_date`, date): Optional comparison date (UTC) for deltas
- Topic id (`topic_id`, text): Filter by Topic ID
- Platform id (`platform_id`, text): Filter by Platform ID
- Url (`url`, text): Leave empty to use the site saved on this connection.
- Project id (`project_id`, text): Optional Project ID to filter the site
- Website ids (`website_ids`, list): Optional list of Website IDs to filter (repeat the param for multiple values)
- Page (`page`, number): Page number for pagination. At least 1. Default: `1`.
- Size (`size`, number): Number of items per page. From 1 to 100. Default: `50`.

**Outputs**

- `data` (object): Returned value.

**Example output**

```json
{
  "data": {
    "count": 1,
    "items": [],
    "page": 1,
    "size": 1,
    "total": 1,
    "total_pages": 1
  }
}
```

### Get fix generation status

Get fix generation status.

**Inputs**

- Url (`url`, text): Leave empty to use the site saved on this connection.
- Project id (`project_id`, text): Optional Project ID to filter the site
- Page url (`page_url`, text, required): The URL of the specific page to analyze
- Issue type (`issue_type`, text, required): The type of issue to get recommendations for. One of: `TITLE`, `META_DESCRIPTION` (Meta description), `SCHEMA_MARKUP` (Schema markup), `KEY_TAKEAWAY` (Key takeaway), `FAQ`, `FAQ_ENHANCEMENTS` (Faq enhancements), `AUTHORITY_SIGNAL` (Authority signal), `BRAND_MENTIONED` (Brand mentioned), `EXPERT_QUOTE` (Expert quote), `COMPARISON_TABLE` (Comparison table), and 4 more.

**Outputs**

- `data` (object): Returned value.

**Example output**

```json
{
  "data": {
    "error_message": "example",
    "status": "NOT_STARTED"
  }
}
```

### Get issue recommendations

Get issue recommendations.

**Inputs**

- Url (`url`, text): Leave empty to use the site saved on this connection.
- Project id (`project_id`, text): Optional Project ID to filter the site
- Page url (`page_url`, text, required): The URL of the specific page to analyze
- Issue type (`issue_type`, text, required): The type of issue to get recommendations for. One of: `TITLE`, `META_DESCRIPTION` (Meta description), `SCHEMA_MARKUP` (Schema markup), `KEY_TAKEAWAY` (Key takeaway), `FAQ`, `FAQ_ENHANCEMENTS` (Faq enhancements), `AUTHORITY_SIGNAL` (Authority signal), `BRAND_MENTIONED` (Brand mentioned), `EXPERT_QUOTE` (Expert quote), `COMPARISON_TABLE` (Comparison table), and 4 more.

**Outputs**

- `data` (object): Returned value.

**Example output**

```json
{
  "data": {
    "fixes": [],
    "message": "example",
    "success": false,
    "total_fixes": 1
  }
}
```

### Get optimization issue summary

Get optimization issue summary.

**Inputs**

- Url (`url`, text): Leave empty to use the site saved on this connection.
- Project id (`project_id`, text): Optional Project ID to filter the site

**Outputs**

- `data` (object): Returned value.

**Example output**

```json
{
  "data": {
    "issues": [],
    "last_scan_date": "example"
  }
}
```

### Get page optimization issues

Get page optimization issues.

**Inputs**

- Url (`url`, text): Leave empty to use the site saved on this connection.
- Project id (`project_id`, text): Optional Project ID to filter the site
- Page url (`page_url`, text, required): The URL of the specific page to analyze

**Outputs**

- `data` (object): Returned value.

**Example output**

```json
{
  "data": {
    "cited_websites": [],
    "competitor_citing_count": 1,
    "content_type": "example",
    "issues": [],
    "last_optimized_on": "example",
    "optimization_page_id": "example",
    "page_type": "example",
    "self_citing_count": 1,
    "source_url": "example",
    "status": "not_started",
    "title": "example"
  }
}
```

### Get prompt performance

Get prompt performance.

**Inputs**

- Date (`date`, date, required): Date to export (UTC)
- Compare date (`compare_date`, date): Optional comparison date (UTC) for deltas
- Topic id (`topic_id`, text): Filter by Topic ID
- Platform id (`platform_id`, text): Filter by Platform ID
- Prompt id (`prompt_id`, text): Filter by Prompt ID
- Url (`url`, text): Leave empty to use the site saved on this connection.
- Project id (`project_id`, text): Optional Project ID to filter the site
- Page (`page`, number): Page number for pagination. At least 1. Default: `1`.
- Size (`size`, number): Number of items per page. From 1 to 100. Default: `50`.

**Outputs**

- `data` (object): Returned value.

**Example output**

```json
{
  "data": {
    "count": 1,
    "items": [],
    "page": 1,
    "size": 1,
    "total": 1,
    "total_pages": 1
  }
}
```

### Get SEO audit issues

Get SEO audit issues.

**Inputs**

- Url (`url`, text): Leave empty to use the site saved on this connection.
- Project id (`project_id`, text): Optional Project ID to filter the site
- Severity (`severity`, list, required): Severity levels to filter issues. Pass multiple times for multiple severities (e.g., ?severity=Critical&severity=Warning). One or more of: `Critical`, `Warning`.

**Outputs**

- `data` (object): Response containing all audit issues grouped by class and category

**Example output**

```json
{
  "data": {
    "audit_id": "example",
    "issue_classes": []
  }
}
```

### List content pages

List content pages. Returns one page; use its continuation fields to request the next page.

**Inputs**

- Url (`url`, text): Leave empty to use the site saved on this connection.
- Project id (`project_id`, text): Optional Project ID to filter the site
- Search (`search`, text): Search term to filter pages by title or URL
- Statuses (`statuses`, text): Comma-separated list of statuses to filter pages (not_started, in_progress, completed, cancelled, verifying, cited, uncited, effective)
- Page (`page`, number): Page number for pagination. At least 1. Default: `1`.
- Size (`size`, number): Number of items per page. From 1 to 100. Default: `50`.

**Outputs**

- `data` (object): Returned value.

**Example output**

```json
{
  "data": {
    "items": [],
    "page": 1,
    "pages": 1,
    "size": 1,
    "total": 1
  }
}
```

### List scanned URLs

List scanned URLs.

**Inputs**

- Url (`url`, text): Leave empty to use the site saved on this connection.
- Project id (`project_id`, text): Optional Project ID to filter the site

**Outputs**

- `data` (object): Returned value.

**Example output**

```json
{
  "data": {
    "items": [],
    "total": 1
  }
}
```
