{
    "schemaVersion": "1.0.0",
    "@context": "https://schema.org",
    "@type": "WebPage",
    "@id": "https://nrlc.ai/neural-command/machine-understanding/natural-language-api-basics/#webpage",
    "url": "https://nrlc.ai/neural-command/machine-understanding/natural-language-api-basics/",
    "name": "Natural Language API Basics for Machine Interpretation | Neural Command Lessons",
    "description": "Learn how Google Natural Language API reveals what machines understand from page copy, including entities, sentiment, syntax, classification, and salience.",
    "inLanguage": "en-US",
    "content": {
        "format": "text/markdown",
        "wordCount": 2413,
        "headings": [
            {
                "level": 2,
                "text": "What this teaches"
            },
            {
                "level": 2,
                "text": "Why it matters for retrieval and machine interpretation"
            },
            {
                "level": 2,
                "text": "Core concepts"
            },
            {
                "level": 3,
                "text": "Entity salience"
            },
            {
                "level": 3,
                "text": "PLAIN_TEXT"
            },
            {
                "level": 3,
                "text": "HTML input"
            },
            {
                "level": 3,
                "text": "content vs gcsContentUri"
            },
            {
                "level": 3,
                "text": "UTF-8 encoding"
            },
            {
                "level": 3,
                "text": "annotateText"
            },
            {
                "level": 2,
                "text": "Example: premium domain brokerage homepage (anonymized pattern)"
            },
            {
                "level": 2,
                "text": "Illustrative analyzeEntities output (pattern — not a live API dump)"
            },
            {
                "level": 2,
                "text": "NRLC interpretation layer"
            },
            {
                "level": 2,
                "text": "Operational application"
            },
            {
                "level": 2,
                "text": "Additional audit patterns"
            },
            {
                "level": 3,
                "text": "AI consultancy homepage"
            },
            {
                "level": 3,
                "text": "Local service page"
            },
            {
                "level": 3,
                "text": "SaaS landing page"
            },
            {
                "level": 2,
                "text": "Common mistakes"
            },
            {
                "level": 2,
                "text": "Practical exercise"
            },
            {
                "level": 2,
                "text": "Sources"
            },
            {
                "level": 2,
                "text": "Briefing quiz"
            }
        ],
        "markdown": "---\ntitle: Natural Language API Basics for Machine Interpretation | Neural Command Lessons\ndescription: Learn how Google Natural Language API reveals what machines understand from page copy, including entities, sentiment, syntax, classification, and salience.\norganization: Neural Command LLC\ncanonical: https://nrlc.ai/neural-command/machine-understanding/natural-language-api-basics/\n---\n\nLESSON 1 · OPERATOR BRIEF\n\n## What this teaches\n\n- How to choose PLAIN_TEXT vs HTML input for copy-clarity vs rendered-page analysis\n- The six core methods: analyzeSentiment, analyzeEntities, analyzeEntitySentiment, analyzeSyntax, classifyText, annotateText\n- Why entity salience is the primary semantic SEO signal in NL output\n- How to frame audits around machine interpretation, not keyword presence\n## Why it matters for retrieval and machine interpretation\n\nRetrieval systems and answer engines do not read your brand intention. They read strings, entities, and statistical patterns. If Natural Language returns the wrong dominant entities, downstream systems may classify the page under the wrong category, cite the wrong concept, or skip the page entirely during grounding. The operator question is always:\n\n**What does the machine think this page is about?**CORE CONCEPTS\n\n## Core concepts\n\n### Entity salience\n\nA score indicating how central an entity is within the document. High salience means the machine treats that entity as a primary subject — not a passing mention.\n\n### PLAIN_TEXT\n\nBest for testing whether copy alone communicates intended meaning, stripped of layout and navigation noise.\n\n### HTML input\n\nUseful when you need to analyze rendered page text as extracted from DOM — closer to what some crawlers see after parsing.\n\n### content vs gcsContentUri\n\nPass text directly via content for audits; use gcsContentUri when analyzing files already stored in Google Cloud Storage.\n\n### UTF-8 encoding\n\nRequired for correct character offsets in syntax analysis — critical when auditing non-ASCII or mixed-language copy.\n\n### annotateText\n\nRuns multiple analyses in one request — the standard operator workflow for page-level briefings.\n\nEXAMPLE INPUT\n\n## Example: premium domain brokerage homepage (anonymized pattern)\n\nA boutique brokerage page targeting high-intent buyers. Human copy emphasizes “premium domain brokerage” and “advisory acquisition.”\n\n`Search our inventory of premium domains. Browse listings, compare prices, and make an offer instantly. Our marketplace connects buyers and sellers with thousands of verified domain names. Filter by category, TLD, and price. Start your domain search today.`MACHINE SIGNAL\n\n## Illustrative analyzeEntities output (pattern — not a live API dump)\n\nScores are representative of audit patterns NRLC has observed on similar page types.\n\nEntity\n\nType\n\nSalience\n\nmarketplace\n\nOTHER\n\n0.41\n\ndomain name\n\nOTHER\n\n0.28\n\nsearch\n\nOTHER\n\n0.19\n\nlisting\n\nOTHER\n\n0.12\n\nbrokerage\n\nOTHER\n\n0.06\n\nDespite human intent (“brokerage”), machine salience ranks marketplace, search, and inventory language above brokerage. The page reads as a marketplace to the API — not a high-touch advisory service.\n\nNRLC INTERPRETATION LAYER\n\n## NRLC interpretation layer\n\nGoogle Natural Language is the instrument. NRLC's value is the interpretation layer: mapping entity salience, sentiment, syntax, and classification output into SEO, schema, and retrieval decisions. The goal is not to copy an API report. The goal is to decide what the page must say, structure, and reinforce so machines interpret it correctly.\n\n## Operational application\n\n- Run PLAIN_TEXT on hero + first 500 words before touching schema — isolate copy clarity from template noise.\n- If salience leaders do not match target entities, rewrite headings and first paragraphs before adding JSON-LD.\n- Compare PLAIN_TEXT vs HTML extraction when navigation or footer boilerplate dominates entity signals.\n- Use annotateText for baseline briefings; escalate to entity-only passes when salience drift is the primary failure.\n- Document target entities (Organization, Service, Place) and required salience ordering before implementation work.\n## Additional audit patterns\n\n### AI consultancy homepage\n\nCopy mentions “AI visibility” repeatedly but salience ranks generic “marketing agency” and “SEO services” above proprietary methodology entities.\n\n### Local service page\n\nCity name and “plumber” salience low; “coupon,” “discount,” and “call now” dominate — machine reads promotional landing page, not local service entity.\n\n### SaaS landing page\n\nFeature bullets drive salience toward “software” and “tool” while product name and category entity stay below 0.08.\n\n## Common mistakes\n\n- Assuming keywords in copy guarantee entity salience in API output.\n- Adding Organization schema while body copy still signals a different business model (marketplace vs consultancy).\n- Auditing full HTML when the failure is in hero copy — boilerplate drowns signal.\n- Treating sentiment score as a ranking metric instead of a reputation-risk indicator.\n- Skipping classification — a page can have correct entities but wrong topical category.\nPRACTICAL EXERCISE\n\n## Practical exercise\n\n- Select one money page (service, product, or homepage).\n- Extract PLAIN_TEXT from the hero, H1, and first two paragraphs only.\n- Run analyzeEntities (or annotateText with ENTITY analysis).\n- List top 5 entities by salience. Circle any that conflict with your intended business entity.\n- Write one sentence: “The machine thinks this page is about ___.”\n- If that sentence is wrong, draft three copy changes before opening Schema Markup or Search Console.\nREFERENCES\n\n## Sources\n\n- Google Cloud Natural Language API Documentation (Google Cloud)\nQUIZ\n\n## Briefing quiz\n\nFive questions. Check each answer for immediate feedback. Complete the briefing to record your score.\n\n1\n\nWhat does entity salience measure?\n\nHow many times a keyword appears in the document.\n\nHow central or important an entity is within the document.\n\nThe sentiment polarity of a brand mention.\n\nWhether an entity has a Wikipedia link.\n\nCheck Answer\n\n2\n\nWhen should you use PLAIN_TEXT?\n\nWhen you need to include full navigation and footer boilerplate.\n\nWhen testing whether the copy itself communicates the intended meaning clearly.\n\nOnly when the page has no HTML version.\n\nWhen uploading files to Google Cloud Storage.\n\nCheck Answer\n\n3\n\nWhy can a page that says “premium domain brokerage” still be interpreted as a marketplace?\n\nBecause Google Natural Language does not read English.\n\nBecause other dominant entities like search, inventory, listings, and make offer may outweigh the brokerage entity.\n\nBecause brokerage is always classified as marketplace in the API.\n\nBecause PLAIN_TEXT mode ignores nouns.\n\nCheck Answer\n\n4\n\nWhich method extracts dominant entities from a page?\n\nanalyzeSentiment\n\nanalyzeSyntax\n\nanalyzeEntities\n\nclassifyText\n\nCheck Answer\n\n5\n\nWhat is annotateText useful for?\n\nGenerating JSON-LD automatically.\n\nRunning multiple Natural Language analyses in one request.\n\nSubmitting URLs directly to Google Search.\n\nTraining custom LLM models on site content.\n\nCheck Answer\n\nComplete Briefing\n\nSCORE\n\nRetry Quiz\n\n[Continue](https://nrlc.ai/neural-command/)\n\n---\n\nSource: https://nrlc.ai/neural-command/machine-understanding/natural-language-api-basics/\nPublisher: Neural Command LLC\nLicense: Editorial use with attribution\n"
    },
    "structuredData": [
        {
            "@context": "https://schema.org",
            "@graph": [
                {
                    "@type": "Organization",
                    "@id": "https://nrlc.ai/#organization",
                    "name": "Neural Command, LLC",
                    "legalName": "Neural Command, LLC",
                    "alternateName": [
                        "NRLC.ai",
                        "Neural Command"
                    ],
                    "url": "https://nrlc.ai",
                    "telephone": "+1 844-568-4624",
                    "address": {
                        "@type": "PostalAddress",
                        "streetAddress": "1639 11th St suite 110-a",
                        "addressLocality": "Santa Monica",
                        "addressRegion": "CA",
                        "postalCode": "90404",
                        "addressCountry": "US"
                    },
                    "logo": {
                        "@type": "ImageObject",
                        "url": "https://nrlc.ai/assets/images/nrlc-logo.png",
                        "width": 43,
                        "height": 43
                    },
                    "sameAs": [
                        "https://www.linkedin.com/company/neural-command/",
                        "https://www.crunchbase.com/organization/neural-command",
                        "https://g.co/kgs/EP6p5de"
                    ],
                    "description": "NRLC.ai designs semantic and knowledge architecture so organizations can be identified, related, evidenced, represented, and retrieved as reliable context for search engines, LLMs, agents, and other machine systems. Neural Command, LLC (NRLC.ai) structures identity, relationships, evidence, provenance, and machine-readable representations — Search Architecture, AI Discovery Systems, and Search Intelligence. SEO, GEO, and AI visibility remain capability modules, not the company definition."
                },
                {
                    "@type": "WebSite",
                    "@id": "https://nrlc.ai/#website",
                    "url": "https://nrlc.ai/",
                    "name": "NRLC.ai",
                    "alternateName": [
                        "Neural Command, LLC",
                        "Neural Command"
                    ],
                    "description": "NRLC.ai designs semantic and knowledge architecture so organizations can be identified, related, evidenced, represented, and retrieved as reliable context for search engines, LLMs, agents, and other machine systems. Neural Command, LLC (NRLC.ai) structures identity, relationships, evidence, provenance, and machine-readable representations — Search Architecture, AI Discovery Systems, and Search Intelligence. SEO, GEO, and AI visibility remain capability modules, not the company definition.",
                    "inLanguage": "en",
                    "publisher": {
                        "@type": "Organization",
                        "@id": "https://nrlc.ai/#organization"
                    }
                },
                {
                    "@type": "BreadcrumbList",
                    "@id": "https://nrlc.ai/neural-command/machine-understanding/natural-language-api-basics/#breadcrumb",
                    "itemListElement": [
                        {
                            "@type": "ListItem",
                            "position": 1,
                            "name": "Home",
                            "item": "https://nrlc.ai/"
                        },
                        {
                            "@type": "ListItem",
                            "position": 2,
                            "name": "Neural Command Lessons",
                            "item": "https://nrlc.ai/neural-command/"
                        },
                        {
                            "@type": "ListItem",
                            "position": 3,
                            "name": "Natural Language API Basics",
                            "item": "https://nrlc.ai/neural-command/machine-understanding/natural-language-api-basics/"
                        }
                    ]
                },
                {
                    "@type": "DefinedTerm",
                    "@id": "https://nrlc.ai/neural-command/machine-understanding/natural-language-api-basics/#definedterm",
                    "name": "Entity salience",
                    "description": "How machines interpret dominant entities in page copy."
                },
                {
                    "@type": [
                        "TechArticle",
                        "LearningResource"
                    ],
                    "@id": "https://nrlc.ai/neural-command/machine-understanding/natural-language-api-basics/#article",
                    "headline": "Natural Language API Basics",
                    "name": "Natural Language API Basics",
                    "description": "Learn how Google Natural Language API reveals what machines understand from page copy, including entities, sentiment, syntax, classification, and salience.",
                    "url": "https://nrlc.ai/neural-command/machine-understanding/natural-language-api-basics/",
                    "inLanguage": "en-US",
                    "author": {
                        "@id": "https://nrlc.ai/en-us/about/joel-maldonado/#person",
                        "@type": "Person",
                        "name": "Joel David Maldonado",
                        "url": "https://nrlc.ai/en-us/about/joel-maldonado/"
                    },
                    "publisher": {
                        "@type": "Organization",
                        "@id": "https://nrlc.ai/#organization"
                    },
                    "datePublished": "2026-06-27",
                    "dateModified": "2026-09-10",
                    "isPartOf": {
                        "@type": "WebSite",
                        "@id": "https://nrlc.ai/#website"
                    },
                    "mainEntityOfPage": {
                        "@id": "https://nrlc.ai/neural-command/machine-understanding/natural-language-api-basics/#webpage"
                    },
                    "learningResourceType": "Lesson",
                    "teaches": "How to choose PLAIN_TEXT vs HTML input for copy-clarity vs rendered-page analysis; The six core methods: analyzeSentiment, analyzeEntities, analyzeEntitySentiment, analyzeSyntax, classifyText, annotateText; Why entity salience is the primary semantic SEO signal in NL output; How to frame audits around machine interpretation, not keyword presence",
                    "about": {
                        "@id": "https://nrlc.ai/neural-command/machine-understanding/natural-language-api-basics/#definedterm"
                    }
                },
                {
                    "@type": "DefinedTermSet",
                    "@id": "https://nrlc.ai/topics/#termset",
                    "name": "NRLC AI Search & Visibility Taxonomy",
                    "url": "https://nrlc.ai/topics/",
                    "publisher": {
                        "@id": "https://nrlc.ai/#organization"
                    },
                    "hasDefinedTerm": [
                        {
                            "@id": "https://nrlc.ai/neural-command/machine-understanding/natural-language-api-basics/#definedterm"
                        }
                    ]
                },
                {
                    "@type": "WebPage",
                    "@id": "https://nrlc.ai/neural-command/machine-understanding/natural-language-api-basics/#webpage",
                    "url": "https://nrlc.ai/neural-command/machine-understanding/natural-language-api-basics/",
                    "name": "Natural Language API Basics",
                    "isPartOf": {
                        "@type": "WebSite",
                        "@id": "https://nrlc.ai/#website"
                    },
                    "publisher": {
                        "@type": "Organization",
                        "@id": "https://nrlc.ai/#organization"
                    },
                    "description": "Learn how Google Natural Language API reveals what machines understand from page copy, including entities, sentiment, syntax, classification, and salience.",
                    "mainEntity": {
                        "@id": "https://nrlc.ai/neural-command/machine-understanding/natural-language-api-basics/#article"
                    },
                    "inLanguage": "en-US"
                }
            ]
        }
    ],
    "internalLinks": [
        {
            "url": "https://nrlc.ai/",
            "label": "Home"
        },
        {
            "url": "https://nrlc.ai/neural-command/",
            "label": "← Back to Neural Command"
        },
        {
            "url": "https://nrlc.ai/en-us/ai-labs/",
            "label": "AI Labs"
        },
        {
            "url": "https://nrlc.ai/en-us/llm-compute-leak/",
            "label": "LLM Compute Leak"
        },
        {
            "url": "https://nrlc.ai/ai-optimization/",
            "label": "AI Optimization"
        },
        {
            "url": "https://nrlc.ai/en-us/generative-engine-optimization/",
            "label": "GEO Research"
        },
        {
            "url": "https://nrlc.ai/services/",
            "label": "Services"
        }
    ],
    "representations": {
        "html": "https://nrlc.ai/neural-command/machine-understanding/natural-language-api-basics/",
        "markdown": "https://nrlc.ai/neural-command/machine-understanding/natural-language-api-basics.md",
        "json": "https://nrlc.ai/neural-command/machine-understanding/natural-language-api-basics.json"
    },
    "publisher": {
        "@id": "https://nrlc.ai/#organization",
        "name": "Neural Command, LLC"
    }
}