Writesonic
App · 19 actions
Read Writesonic GEO and SEO exports, inspect content issues and generate optimization recommendations.
Actions
| Action | What it does |
|---|---|
| Export AI platforms | Export AI platforms. |
| Export citations | Export citations. |
| Export keywords | Export keywords. |
| Export prompts | Export prompts. |
| Export topics | Export topics. |
| Export websites | Export websites. |
| Generate fixes for multiple pages | Generate fixes for multiple pages. |
| Generate optimization fixes | Generate optimization fixes. |
| Get all page recommendations | Get all page recommendations. |
| Get answer performance | Get answer performance. |
| Get daily performance summary | Get daily performance summary. |
| Get fix generation status | Get fix generation status. |
| Get issue recommendations | Get issue recommendations. |
| Get optimization issue summary | Get optimization issue summary. |
| Get page optimization issues | Get page optimization issues. |
| Get prompt performance | Get prompt performance. |
| Get SEO audit issues | Get SEO audit issues. |
| List content pages | List content pages. |
| List scanned URLs | List scanned URLs. |
Export AI platforms
Export AI platforms.
Inputs
- Url
urltext - Leave empty to use the site saved on this connection.
- Project id
project_idtext - Optional Project ID to filter the site
- Page
pagenumber - Page number for paginationAt least 1. Default:
1. - Size
sizenumber - 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
- Date
datedateRequired - Date to export (UTC)
- Compare date
compare_datedate - Optional comparison date (UTC) for deltas
- Topic id
topic_idtext - Filter by Topic ID
- Platform id
platform_idtext - Filter by Platform/Model ID
- Prompt id
prompt_idtext - Filter by Prompt ID
- Citation id
citation_idtext - Filter by Citation ID
- Url
urltext - Leave empty to use the site saved on this connection.
- Project id
project_idtext - Optional Project ID to filter the site
- Page
pagenumber - Page number for paginationAt least 1. Default:
1. - Size
sizenumber - 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
- Date
datedateRequired - Date to export (UTC)
- Compare date
compare_datedate - Optional comparison date (UTC) for deltas
- Topic id
topic_idtext - Filter by Topic ID
- Platform id
platform_idtext - Filter by Platform/Model ID
- Subtheme id
subtheme_idtext - Filter by Subtheme ID
- Url
urltext - Leave empty to use the site saved on this connection.
- Project id
project_idtext - Optional Project ID to filter the site
- Page
pagenumber - Page number for paginationAt least 1. Default:
1. - Size
sizenumber - 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
- Url
urltext - Leave empty to use the site saved on this connection.
- Project id
project_idtext - Optional Project ID to filter the site
- Page
pagenumber - Page number for paginationAt least 1. Default:
1. - Size
sizenumber - 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
- Url
urltext - Leave empty to use the site saved on this connection.
- Project id
project_idtext - Optional Project ID to filter the site
- Page
pagenumber - Page number for paginationAt least 1. Default:
1. - Size
sizenumber - 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
- Url
urltext - Leave empty to use the site saved on this connection.
- Project id
project_idtext - Optional Project ID to filter the site
- Page
pagenumber - Page number for paginationAt least 1. Default:
1. - Size
sizenumber - 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
- Url
urltext - Leave empty to use the site saved on this connection.
- Project id
project_idtext - Optional Project ID to filter the site
- Page urls
page_urlslistRequired - Page urls.
Outputs
dataobject- Returned value.
Example output
{
"data": {
"results": []
}
}Generate optimization fixes
Generate optimization fixes.
Inputs
- Url
urltext - Leave empty to use the site saved on this connection.
- Project id
project_idtext - Optional Project ID to filter the site
- Page url
page_urltextRequired - Page url.
- Issue type
issue_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 ids
excluded_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
- Url
urltext - Leave empty to use the site saved on this connection.
- Project id
project_idtext - Optional Project ID to filter the site
- Page url
page_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
- Date
datedateRequired - Date to export (UTC)
- Topic id
topic_idtext - Filter by Topic ID
- Platform id
platform_idtext - Filter by Platform ID
- Prompt id
prompt_idtext - Filter by Prompt ID
- Url
urltext - Leave empty to use the site saved on this connection.
- Project id
project_idtext - Optional Project ID to filter the site
- Page
pagenumber - Page number for paginationAt least 1. Default:
1. - Size
sizenumber - 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
- Date
datedateRequired - Date to export (UTC)
- Compare date
compare_datedate - Optional comparison date (UTC) for deltas
- Topic id
topic_idtext - Filter by Topic ID
- Platform id
platform_idtext - Filter by Platform ID
- Url
urltext - Leave empty to use the site saved on this connection.
- Project id
project_idtext - Optional Project ID to filter the site
- Website ids
website_idslist - Optional list of Website IDs to filter (repeat the param for multiple values)
- Page
pagenumber - Page number for paginationAt least 1. Default:
1. - Size
sizenumber - 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
- Url
urltext - Leave empty to use the site saved on this connection.
- Project id
project_idtext - Optional Project ID to filter the site
- Page url
page_urltextRequired - The URL of the specific page to analyze
- Issue type
issue_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
- Url
urltext - Leave empty to use the site saved on this connection.
- Project id
project_idtext - Optional Project ID to filter the site
- Page url
page_urltextRequired - The URL of the specific page to analyze
- Issue type
issue_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
- Url
urltext - Leave empty to use the site saved on this connection.
- Project id
project_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
- Url
urltext - Leave empty to use the site saved on this connection.
- Project id
project_idtext - Optional Project ID to filter the site
- Page url
page_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
- Date
datedateRequired - Date to export (UTC)
- Compare date
compare_datedate - Optional comparison date (UTC) for deltas
- Topic id
topic_idtext - Filter by Topic ID
- Platform id
platform_idtext - Filter by Platform ID
- Prompt id
prompt_idtext - Filter by Prompt ID
- Url
urltext - Leave empty to use the site saved on this connection.
- Project id
project_idtext - Optional Project ID to filter the site
- Page
pagenumber - Page number for paginationAt least 1. Default:
1. - Size
sizenumber - 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
- Url
urltext - Leave empty to use the site saved on this connection.
- Project id
project_idtext - Optional Project ID to filter the site
- Severity
severitylistRequired - 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
- Url
urltext - Leave empty to use the site saved on this connection.
- Project id
project_idtext - Optional Project ID to filter the site
- Search
searchtext - Search term to filter pages by title or URL
- Statuses
statusestext - Comma-separated list of statuses to filter pages (not_started, in_progress, completed, cancelled, verifying, cited, uncited, effective)
- Page
pagenumber - Page number for paginationAt least 1. Default:
1. - Size
sizenumber - 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
- Url
urltext - Leave empty to use the site saved on this connection.
- Project id
project_idtext - Optional Project ID to filter the site
Outputs
dataobject- Returned value.
Example output
{
"data": {
"items": [],
"total": 1
}
}