Rename a competitor, pause it, or change how many pages are read.

PATCHhttps://app.softsolz.uk/api/v1/services/seo/competitors/{competitor_id}

Recent Requests

TimeStatusUser Agent

Make a request to see history.

Path Params

competitor_idstringrequired

Headers

Authorizationstringrequired

Bearer token: `Bearer sk_live_...` (or `sk_test_...` for sandbox). A login token will not work here.

Body Params

labelstring | null

What you call them.

statusstring | null

active or paused.

crawl_budgetinteger | null

How many of their pages to read at most.

Response

Response Body

idstringThe competitor id.

domainstringTheir domain.

labelstring | nullWhat you call them.

statusstringactive, paused or removed.

crawl_budgetintegerHow many of their pages will be read at most.

robots_allowsboolean | nullWhether their robots.txt lets us read the site. Null until first read.

pages_crawledintegerPages read last time.

last_crawled_atstring | nullWhen they were last read.

last_errorstring | nullWhy the last read did not finish, when it did not.

Request

import { SoftSolz } from '@softsolz/sdk';

const client = new SoftSolz({ apiKey: process.env.SOFTSOLZ_API_KEY });

const result = await client.seo.updateCompetitor('<competitor_id>', {});
console.log(result);

Credentials

Authorization

Sent as a Bearer token. Stored only in your browser.

Response · 200

{
  "data": {
    "id": "string",
    "domain": "string",
    "label": "string",
    "status": "string",
    "crawl_budget": 0,
    "robots_allows": true,
    "pages_crawled": 0,
    "last_crawled_at": "string",
    "last_error": "string"
  }
}