apyhub
Back
▣ MARKETING · SEO

SEO Tags Generator API

What it does

SEO Tag Generator turns page content into a structured set of SEO meta tags. Send content, and optionally set language and voice_tone; the job returns a job_id you can poll for completion.

Use it when you need consistent metadata for blog posts, landing pages, product pages, or CMS imports without hand-writing titles and descriptions for every page. The output is a meta_tags object containing fields such as title, description, keywords, author, og:title, og:description, og:image, og:url, og:type, og:site_name, twitter:card, twitter:title, twitter:description, twitter:image, and twitter:creator.

Because generation runs asynchronously, the workflow fits batch jobs as well as on-demand content pipelines. You submit the content once, check job status by job_id, and read the generated tags from the result when the job succeeds.

SEO Tag Generator is useful anywhere you want page metadata that is derived from the source text and returned in a predictable structure for publishing, preview cards, and search optimization workflows.

▣ ENDPOINT 01 / 02
POST
Generate SEO Tags
https://api.eu.apyhub.com/sharpapi/generate-seo-tags

QUICKSTART

GUIDE

Quickstart

Submit content to generate SEO tags asynchronously using the required content field.

curl -X POST "https://api.eu.apyhub.com/sharpapi/generate-seo-tags" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "How to improve website SEO with simple on-page techniques."
  }'

What you'll get back

Returns a JSON object with a job_id string — the UUID of the submitted job. Poll the job status endpoint with this id to retrieve the result.

{
  "job_id": "fbb41657-811b-4c96-9929-4783b9504c6f"
}
TRY ITLIVE · 50 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.
body*
Provide the content to generate SEO tags.
Specify the language of the output.
Specify the voice tone of the output. It can be adjectives like funny or joyous, or even the name of a famous writer.

About this endpoint

What it does

Submits content to generate SEO tags asynchronously. The request body includes the source content to analyze, with optional language and voice_tone settings, and the response returns a job identifier.

Request Body

ParameterTypeMandatoryDescription
contentStringYesProvide the content to generate SEO tags.
languageStringNoSpecify the language of the output. Default: English.
voice_toneStringNoSpecify the voice tone of the output. It can be adjectives like funny or joyous, or even the name of a famous writer.

Response

Returns a JSON object with a job_id string — the UUID of the submitted job. Poll the job status endpoint with this id to retrieve the result.

ParameterTypeMandatoryDescription
job_idStringYesThe unique identifier for the submitted job.

Notes

This endpoint kicks off an async job and returns immediately with a job identifier; the actual work runs in the background. Pair this call with the corresponding job_check endpoint — poll that until the status reaches a terminal state to retrieve the result. Use job_id to track the job.

▣ ENDPOINT 02 / 02
GET
Check SEO Tags Status
https://api.eu.apyhub.com/sharpapi/generate-seo-tags/job/status/:job_id

QUICKSTART

GUIDE

Quickstart

Check the status of a generated SEO tags job by passing its job_id in the URL path.

curl -X GET "https://api.eu.apyhub.com/sharpapi/generate-seo-tags/job/status/:job_id" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object with a data object. Inside data, id is the job UUID, type is the job result type, and attributes.status is the current job status. When the job succeeds, attributes.result.meta_tags contains the generated SEO meta tags.

{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "type": "api_job_result",
    "attributes": {
      "type": "seo_generate_tags",
      "status": "success",
      "result": {
        "meta_tags": {
          "title": "Example Page Title",
          "description": "Example page description",
          "keywords": "seo, meta tags, example"
        }
      }
    }
  }
}
TRY ITLIVE · 1 ATOM
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Checks the status of an asynchronous SEO tag generation job identified by job_id. When the job reaches success, the response includes the generated SEO meta tags in the job result.

Path Parameter(s)

AttributeTypeMandatoryDescription
job_idStringYesThe job's unique UUID.

Response

Returns a JSON object with a data object field. data contains the job id string, the job type string, and an attributes object with the job operation type, current status, and, when the job has succeeded, a nested result object containing meta_tags.

AttributeTypeMandatoryDescription
dataObjectYesJob response wrapper. Contains id, type, and attributes.
data.idStringNoThe job's unique UUID.
data.typeStringNoJob resource type.
data.attributesObjectNoJob attributes wrapper. Contains the operation type, status, and the success result payload.
data.attributes.typeStringNoThe operation type associated with the job.
data.attributes.statusENUMNoCurrent status of the asynchronous job. Allowed values: queued, running, success, failed.
data.attributes.resultObjectNoGenerated SEO meta tag result. Present in the success payload.
data.attributes.result.meta_tagsObjectNoGenerated SEO meta tags.
data.attributes.result.meta_tags.titleStringNoSEO title tag value.
data.attributes.result.meta_tags.authorStringNoAuthor meta tag value.
data.attributes.result.meta_tags.og:urlStringNoOpen Graph URL tag value.
data.attributes.result.meta_tags.og:typeStringNoOpen Graph type tag value.
data.attributes.result.meta_tags.keywordsStringNoKeywords meta tag value.
data.attributes.result.meta_tags.og:imageStringNoOpen Graph image tag value.
data.attributes.result.meta_tags.og:titleStringNoOpen Graph title tag value.
data.attributes.result.meta_tags.descriptionStringNoMeta description tag value.
data.attributes.result.meta_tags.og:site_nameStringNoOpen Graph site name tag value.
data.attributes.result.meta_tags.twitter:cardStringNoTwitter card tag value.
data.attributes.result.meta_tags.twitter:imageStringNoTwitter image tag value.
data.attributes.result.meta_tags.twitter:titleStringNoTwitter title tag value.
data.attributes.result.meta_tags.og:descriptionStringNoOpen Graph description tag value.
data.attributes.result.meta_tags.twitter:creatorStringNoTwitter creator tag value.
data.attributes.result.meta_tags.twitter:descriptionStringNoTwitter description tag value.

Notes

Poll this endpoint with the job_id returned by the submit call. The data.attributes.status field cycles through queued, running, success, and failed. The result fields are only populated once status is success; read the generated SEO meta tags from data.attributes.result.meta_tags.

▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.

Similar APIs

Closest matches in the catalog based on this service.

CALLGenerate Keywords/Tags APISharpAPICALLJob Description Generator APISharpAPICALLJob Description Generator APISumalya APIsCALLDynamic OG Image APIWebsite Intelligence

From the blog

Reads that touch this API.

How SEO Agencies Can Differentiate with Powerful Automation APIs from ApyHubJul 9, 2026Top 5 Rank Tracking APIs to Build Your Own SEO Monitoring StackAug 24, 2026Paraphrasing in the Age of AI: Why Uniqueness, SEO, and a Powerful Text API MattJul 9, 2026Video Thumbnails for SEO: How They Lift CTR, and How to Generate Them with an APISep 22, 2026