Domain Classification - setting task request

The DomainClassification.addTask method allows sending a list of domains to categorize it.
You can send up to 1K of domains per request.

Use Case: Efficient Domain Classification
1. Identify Domain for Classification: Start by selecting the domain you wish to classify based on the specific criteria relevant to your project.
2. Create Classification Task: Use DomainClassification.addTask to set up a domain classification task via the API.
3. Monitor Task: Get the task identifier to monitor its progress.

General request parameters and instructions for using Serpstat API

Request parameters

Parameter

Description

Type

Required

Default value

Value options

method API method name string yes DomainClassification.addTask

id

A request id: the response contains the same id. Enter any number (number) or text (string) value

int/string

yes

Any text or number value. For example: 1, test

params

The object with parameters {...}, it lists all the following parameters and arrays [...]

array

yes

domains

Domains name

array

yes

 

"serpstat.com",
"facebook.com"


Response parameters

Parameter

Description

id

Response id corresponds the request id

result

Contains the answer

task_id

Task identifier

status

Task status

created_at

Date and time, when the task was created


Task statuses

Code

Description

1

Pending

2

Complete

3

Error

This request charges 0.03$ from SERP Crawling wallet for each domain in request.

Example
Request data:
{
    "method": "DomainClassification.addTask",
    "id": 1,
    "params": {
        "domains": [
            "serpstat.com",
            "facebook.com"
        ]
    }
}
Response data:
{
    "id": "1",
    "result": {
        "task_id": "565892-fb87d8fa-f4c2-4b87-aa20-8ef72639625f",
        "status": "1",
        "created_at": "2024-07-31 13:36:20"
    }
}

Share this article with your friends

Are you sure?

Introducing Serpstat

Find out about the main features of the service in a convenient way for you!

Please send a request, and our specialist will offer you education options: a personal demonstration, a trial period, or materials for self-study and increasing expertise — everything for a comfortable start to work with Serpstat.

Name

Email

Phone

We are glad of your comment
I agree to Serpstat`s Privacy Policy.

Thank you, we have saved your new mailing settings.

Open support chat