Writesonic

App · 19 actions

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

Actions

ActionWhat it does
Export AI platformsExport AI platforms.
Export citationsExport citations.
Export keywordsExport keywords.
Export promptsExport prompts.
Export topicsExport topics.
Export websitesExport websites.
Generate fixes for multiple pagesGenerate fixes for multiple pages.
Generate optimization fixesGenerate optimization fixes.
Get all page recommendationsGet all page recommendations.
Get answer performanceGet answer performance.
Get daily performance summaryGet daily performance summary.
Get fix generation statusGet fix generation status.
Get issue recommendationsGet issue recommendations.
Get optimization issue summaryGet optimization issue summary.
Get page optimization issuesGet page optimization issues.
Get prompt performanceGet prompt performance.
Get SEO audit issuesGet SEO audit issues.
List content pagesList content pages.
List scanned URLsList scanned URLs.

Export AI platforms

Export AI platforms.

Inputs

Urlurltext
Leave empty to use the site saved on this connection.
Project idproject_idtext
Optional Project ID to filter the site
Pagepagenumber
Page number for paginationAt least 1. Default: 1.
Sizesizenumber
Number of items per pageFrom 1 to 100. Default: 50.

Outputs

dataobject
Returned value.
Example output
{
  "data": {
    "count": 1,
    "items": [],
    "page": 1,
    "size": 1,
    "total": 1,
    "total_pages": 1
  }
}

Export citations

Export citations.

Inputs

DatedatedateRequired
Date to export (UTC)
Compare datecompare_datedate
Optional comparison date (UTC) for deltas
Topic idtopic_idtext
Filter by Topic ID
Platform idplatform_idtext
Filter by Platform/Model ID
Prompt idprompt_idtext
Filter by Prompt ID
Citation idcitation_idtext
Filter by Citation ID
Urlurltext
Leave empty to use the site saved on this connection.
Project idproject_idtext
Optional Project ID to filter the site
Pagepagenumber
Page number for paginationAt least 1. Default: 1.
Sizesizenumber
Number of items per pageFrom 1 to 100. Default: 50.

Outputs

dataobject
Returned value.
Example output
{
  "data": {
    "count": 1,
    "items": [],
    "page": 1,
    "size": 1,
    "total": 1,
    "total_pages": 1
  }
}

Export keywords

Export keywords.

Inputs

DatedatedateRequired
Date to export (UTC)
Compare datecompare_datedate
Optional comparison date (UTC) for deltas
Topic idtopic_idtext
Filter by Topic ID
Platform idplatform_idtext
Filter by Platform/Model ID
Subtheme idsubtheme_idtext
Filter by Subtheme ID
Urlurltext
Leave empty to use the site saved on this connection.
Project idproject_idtext
Optional Project ID to filter the site
Pagepagenumber
Page number for paginationAt least 1. Default: 1.
Sizesizenumber
Number of items per pageFrom 1 to 100. Default: 50.

Outputs

dataobject
Returned value.
Example output
{
  "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

Urlurltext
Leave empty to use the site saved on this connection.
Project idproject_idtext
Optional Project ID to filter the site
Pagepagenumber
Page number for paginationAt least 1. Default: 1.
Sizesizenumber
Number of items per pageFrom 1 to 100. Default: 50.

Outputs

dataobject
Returned value.
Example output
{
  "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

Urlurltext
Leave empty to use the site saved on this connection.
Project idproject_idtext
Optional Project ID to filter the site
Pagepagenumber
Page number for paginationAt least 1. Default: 1.
Sizesizenumber
Number of items per pageFrom 1 to 100. Default: 50.

Outputs

dataobject
Returned value.
Example output
{
  "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

Urlurltext
Leave empty to use the site saved on this connection.
Project idproject_idtext
Optional Project ID to filter the site
Pagepagenumber
Page number for paginationAt least 1. Default: 1.
Sizesizenumber
Number of items per pageFrom 1 to 100. Default: 50.

Outputs

dataobject
Returned value.
Example output
{
  "data": {
    "count": 1,
    "items": [],
    "page": 1,
    "size": 1,
    "total": 1,
    "total_pages": 1
  }
}

Generate fixes for multiple pages

Generate fixes for multiple pages.

Inputs

Urlurltext
Leave empty to use the site saved on this connection.
Project idproject_idtext
Optional Project ID to filter the site
Page urlspage_urlslistRequired
Page urls.

Outputs

dataobject
Returned value.
Example output
{
  "data": {
    "results": []
  }
}

Generate optimization fixes

Generate optimization fixes.

Inputs

Urlurltext
Leave empty to use the site saved on this connection.
Project idproject_idtext
Optional Project ID to filter the site
Page urlpage_urltextRequired
Page url.
Issue typeissue_typetextRequired
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 idsexcluded_issue_idslist
Excluded issue ids.

Outputs

dataobject
Returned value.
Example output
{
  "data": {
    "message": "example",
    "success": false
  }
}

Get all page recommendations

Get all page recommendations.

Inputs

Urlurltext
Leave empty to use the site saved on this connection.
Project idproject_idtext
Optional Project ID to filter the site
Page urlpage_urltextRequired
The URL of the specific page to analyze

Outputs

dataobject
Returned value.
Example output
{
  "data": {
    "optimization_page_id": "example",
    "page_url": "example",
    "recommendations": []
  }
}

Get answer performance

Get answer performance.

Inputs

DatedatedateRequired
Date to export (UTC)
Topic idtopic_idtext
Filter by Topic ID
Platform idplatform_idtext
Filter by Platform ID
Prompt idprompt_idtext
Filter by Prompt ID
Urlurltext
Leave empty to use the site saved on this connection.
Project idproject_idtext
Optional Project ID to filter the site
Pagepagenumber
Page number for paginationAt least 1. Default: 1.
Sizesizenumber
Number of items per pageFrom 1 to 100. Default: 50.

Outputs

dataobject
Returned value.
Example output
{
  "data": {
    "count": 1,
    "items": [],
    "page": 1,
    "size": 1,
    "total": 1,
    "total_pages": 1
  }
}

Get daily performance summary

Get daily performance summary.

Inputs

DatedatedateRequired
Date to export (UTC)
Compare datecompare_datedate
Optional comparison date (UTC) for deltas
Topic idtopic_idtext
Filter by Topic ID
Platform idplatform_idtext
Filter by Platform ID
Urlurltext
Leave empty to use the site saved on this connection.
Project idproject_idtext
Optional Project ID to filter the site
Website idswebsite_idslist
Optional list of Website IDs to filter (repeat the param for multiple values)
Pagepagenumber
Page number for paginationAt least 1. Default: 1.
Sizesizenumber
Number of items per pageFrom 1 to 100. Default: 50.

Outputs

dataobject
Returned value.
Example output
{
  "data": {
    "count": 1,
    "items": [],
    "page": 1,
    "size": 1,
    "total": 1,
    "total_pages": 1
  }
}

Get fix generation status

Get fix generation status.

Inputs

Urlurltext
Leave empty to use the site saved on this connection.
Project idproject_idtext
Optional Project ID to filter the site
Page urlpage_urltextRequired
The URL of the specific page to analyze
Issue typeissue_typetextRequired
The type of issue to get recommendations forOne 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

dataobject
Returned value.
Example output
{
  "data": {
    "error_message": "example",
    "status": "NOT_STARTED"
  }
}

Get issue recommendations

Get issue recommendations.

Inputs

Urlurltext
Leave empty to use the site saved on this connection.
Project idproject_idtext
Optional Project ID to filter the site
Page urlpage_urltextRequired
The URL of the specific page to analyze
Issue typeissue_typetextRequired
The type of issue to get recommendations forOne 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

dataobject
Returned value.
Example output
{
  "data": {
    "fixes": [],
    "message": "example",
    "success": false,
    "total_fixes": 1
  }
}

Get optimization issue summary

Get optimization issue summary.

Inputs

Urlurltext
Leave empty to use the site saved on this connection.
Project idproject_idtext
Optional Project ID to filter the site

Outputs

dataobject
Returned value.
Example output
{
  "data": {
    "issues": [],
    "last_scan_date": "example"
  }
}

Get page optimization issues

Get page optimization issues.

Inputs

Urlurltext
Leave empty to use the site saved on this connection.
Project idproject_idtext
Optional Project ID to filter the site
Page urlpage_urltextRequired
The URL of the specific page to analyze

Outputs

dataobject
Returned value.
Example output
{
  "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

DatedatedateRequired
Date to export (UTC)
Compare datecompare_datedate
Optional comparison date (UTC) for deltas
Topic idtopic_idtext
Filter by Topic ID
Platform idplatform_idtext
Filter by Platform ID
Prompt idprompt_idtext
Filter by Prompt ID
Urlurltext
Leave empty to use the site saved on this connection.
Project idproject_idtext
Optional Project ID to filter the site
Pagepagenumber
Page number for paginationAt least 1. Default: 1.
Sizesizenumber
Number of items per pageFrom 1 to 100. Default: 50.

Outputs

dataobject
Returned value.
Example output
{
  "data": {
    "count": 1,
    "items": [],
    "page": 1,
    "size": 1,
    "total": 1,
    "total_pages": 1
  }
}

Get SEO audit issues

Get SEO audit issues.

Inputs

Urlurltext
Leave empty to use the site saved on this connection.
Project idproject_idtext
Optional Project ID to filter the site
SeverityseveritylistRequired
Severity levels to filter issues. Pass multiple times for multiple severities (e.g., ?severity=Critical&severity=Warning).One or more of: Critical, Warning.

Outputs

dataobject
Response containing all audit issues grouped by class and category
Example output
{
  "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

Urlurltext
Leave empty to use the site saved on this connection.
Project idproject_idtext
Optional Project ID to filter the site
Searchsearchtext
Search term to filter pages by title or URL
Statusesstatusestext
Comma-separated list of statuses to filter pages (not_started, in_progress, completed, cancelled, verifying, cited, uncited, effective)
Pagepagenumber
Page number for paginationAt least 1. Default: 1.
Sizesizenumber
Number of items per pageFrom 1 to 100. Default: 50.

Outputs

dataobject
Returned value.
Example output
{
  "data": {
    "items": [],
    "page": 1,
    "pages": 1,
    "size": 1,
    "total": 1
  }
}

List scanned URLs

List scanned URLs.

Inputs

Urlurltext
Leave empty to use the site saved on this connection.
Project idproject_idtext
Optional Project ID to filter the site

Outputs

dataobject
Returned value.
Example output
{
  "data": {
    "items": [],
    "total": 1
  }
}

On this page