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.

Once a GEO Assets generation job completes, you can retrieve the results through three endpoints: list all your reports, read individual file contents for a specific job, or download all seven files as a ZIP archive for deployment.

​
List all GEO reports

Returns a summary list of every GEO Assets job you have run. 
curl https://api.cognerd.in/api/geo-assets/reports \
  -H "Authorization: Bearer YOUR_TOKEN"

​
Response

[
  {
    "jobId": "geo_abc123",
    "url": "https://yoursite.com",
    "status": "completed",
    "createdAt": "2024-01-15T10:30:00Z"
  }
]
​
jobId
string
The unique job identifier. Use this to fetch file contents or download the ZIP.
​
url
string
The website URL that was crawled.
​
status
string
Final job status: "completed" or "failed".
​
createdAt
string
ISO 8601 timestamp when the job was created.

​
Get GEO report file contents

Returns the text content of all seven generated files for a specific job. 
curl https://api.cognerd.in/api/geo-assets/reports/geo_abc123 \
  -H "Authorization: Bearer YOUR_TOKEN"

​
Response

{
  "llms.txt": "# YourBrand\n\nYourBrand is a ...",
  "robots.txt": "User-agent: GPTBot\nAllow: /\n...",
  "sitemap.xml": "<?xml version=\"1.0\" ...",
  "site.jsonld": "{\"@context\": \"https://schema.org\", ...}",
  "organization.jsonld": "{\"@context\": \"https://schema.org\", ...}",
  "website.jsonld": "{\"@context\": \"https://schema.org\", ...}",
  "entities.json": "{\"entities\": [...]}"
}
Use this endpoint to programmatically embed the JSON-LD files into your pages or push them to your CMS. The llms.txt content should be served at https://yourdomain.com/llms.txt.

​
Download GEO report as ZIP

Downloads all seven GEO files bundled as a ZIP archive. 
curl https://api.cognerd.in/api/geo-assets/reports/geo_abc123/download \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -o geo-assets.zip
The response is a binary ZIP file (Content-Type: application/zip). Extract it to get the seven files ready for deployment.

​
Deploying the files

After downloading, deploy each file to the correct location:
FileWhere to put it
llms.txthttps://yourdomain.com/llms.txt (web root)
robots.txthttps://yourdomain.com/robots.txt (merge with existing)
sitemap.xmlhttps://yourdomain.com/sitemap.xml
site.jsonldEmbed as <script type="application/ld+json"> in <head>
organization.jsonldEmbed as <script type="application/ld+json"> in <head>
website.jsonldEmbed as <script type="application/ld+json"> in <head>
entities.jsonServe at https://yourdomain.com/entities.json

​
Error responses

StatusCodeMeaning
401UNAUTHORIZEDMissing or invalid Bearer token
404NOT_FOUNDNo report found for the given jobId
500INTERNAL_ERRORServer error retrieving the report