AI PSEO Ideas API

Description

Trying to find pSEO strategies but can't figure out what to search for? Let our AI help recommend ideas for you.

We use a variety of different AI models to linguistically parse your domain's content and suggest some strategies that you could employ to boost your Search Engine ranking.

Endpoint Cost

2 token/credit per request

Endpoint

> POST https://api.jsonrepo.com/v1/seo/ai_pseo_ideas

Headers

Field	Description
X-API-Key	`Required` Your API Key

Parameters

Field	Type	Description
url	String	`Required` Accepts: properly formatted fully qualified URL. Example: `https://jsonrepo.com`
limit	Integer	`Optional` The number of maximum recommendations to be generated by our AI Default: `10` Range: `1 <= limit <= 15`

Limitations

Scraping Protection: Please keep in mind that if you are using some bot protection service such as cloudflare or any other scraping prevention mechanism, the AI may be unable to access your website's content.
Dynamic Content: dynamically generated javascript content is sometimes ignored by the AI scraper.

Response

A successful request will result in a populated payload field with the expected output.

Response Time:

AI output is bound by the efficiency of the model and the prompt enabling it. The bigger your limit is, the longer the request will take to process. Please be patient as processing the information could sometimes take between 1 and 10 seconds.

Example

// Generate `5` pSEO recommendations for the domain `https://colormagic.app/`

curl -X POST https://api.jsonrepo.com/v1/seo/ai_pseo_ideas \
-H "X-API-Key: {YOUR_API_KEY_HERE}" \
--data-urlencode "url=https://colormagic.app/" \
--data-urlencode "limit=5"

// Server Response

{
    "http_code": 200,
    "http_message": "Ok",
    "timestamp": 1731614809,
    "message": "Successful execution.",
    "payload": {
        "ideas": {
            "input": {
                "url": "https://colormagic.app/"
            },
            "output": [
                {
                    "url": "/color/{adjectives}",
                    "examples": [
                        "vibrant",
                        "soft"
                    ]
                },
                {
                    "url": "/colors/{nature}",
                    "examples": [
                        "ocean",
                        "forest"
                    ]
                },
                {
                    "url": "/create/{effects}",
                    "examples": [
                        "highcontrast",
                        "monochromatic"
                    ]
                },
                {
                    "url": "/design/{aesthetics}",
                    "examples": [
                        "minimalist",
                        "boho"
                    ]
                },
                {
                    "url": "/discover/{colors}",
                    "examples": [
                        "blue",
                        "green"
                    ]
                }
            ]
        }
    }
}

Errors

A failed request will result in an error output as detailed in Error Rules. If the endpoint validation fails due to missing, badly formatted or invalid parameters, the endpoint will return HTTP code 400 along with a message detailing the error.

// Request without `url` parameter

{
    "http_code": 400,
    "http_message": "Bad Request",
    "timestamp": 1731614902,
    "message": "'url' must be provided with proper formatting. Ex: https://jsonrepo.com",
    "payload": []
}