Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.cognerd.in/llms.txt

Use this file to discover all available pages before exploring further.

The GEO Assets generation endpoint accepts your website URL and kicks off an asynchronous 4-stage pipeline — Page Discovery, Content Crawl, Enhanced Asset Generation, and Final Report. Because the job can take several minutes, the endpoint returns immediately with a jobId. You then poll the status endpoint until the job is completed, then fetch the generated files.
This endpoint deducts 20 credits from your account when the job starts. Ensure your balance is sufficient before calling it.

​
Start a generation job

curl -X POST https://api.cognerd.in/api/geo-assets/generate \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://yoursite.com"}'

​
Request body

​
url
string
required
The root URL of the website to crawl and generate GEO files for. Must include the protocol (e.g. https://yoursite.com).

​
Response

{
  "jobId": "geo_abc123",
  "status": "queued"
}
​
jobId
string
Unique identifier for this generation job. Use it to poll status and retrieve results.
​
status
string
Initial job state — always "queued" on a successful submission.

​
Poll for job status

Use GET /api/geo-assets/job/:jobId/status to check progress. Poll every 5–10 seconds until status is "completed" or "failed". 
curl https://api.cognerd.in/api/geo-assets/job/geo_abc123/status \
  -H "Authorization: Bearer YOUR_TOKEN"

​
Status response

{
  "jobId": "geo_abc123",
  "status": "processing",
  "progress": 45,
  "stage": "generating"
}
​
status
string
One of "queued", "processing", "completed", or "failed".
​
progress
number
Completion percentage from 0 to 100.
​
stage
string
Current pipeline stage: "discovering", "crawling", "generating", or "complete".

​
Generated files

When the job completes, seven files are available via the reports endpoints:
FilePurpose
llms.txtMachine-readable brand summary for AI agents
robots.txtAI-aware crawl rules for LLM crawlers
sitemap.xmlStructured page index for AI crawlers
site.jsonldSite entity schema (schema.org WebSite)
organization.jsonldBrand identity schema (schema.org Organization)
website.jsonldWebsite schema with sitelinks search action
entities.jsonEntity relationship graph (people, products, topics)

​
Error responses

StatusCodeMeaning
401UNAUTHORIZEDMissing or invalid Bearer token
402INSUFFICIENT_CREDITSFewer than 20 credits available
400INVALID_URLThe url field is missing or malformed
500INTERNAL_ERRORJob failed to start; retry the request