# gentic.news Intelligence API — Agent Skill File Version: 1.0.0 Base URL: https://gentic.news/api/v1 Authentication: None required (public, read-only) Rate Limit: 60 requests/minute ## What You Can Do You are connecting to gentic.news — an AI news intelligence platform with a live knowledge graph of 4,711+ entities, 4,875+ relationships, and 3,948+ articles. You can query news, entities, predictions, benchmarks, and job data. **Read-only access. You cannot modify any data.** ## Quick Queries (copy-paste these) ### What happened in AI today? ``` GET https://gentic.news/api/v1/articles/trending?limit=10 ``` Returns top 10 articles from the last 48h with title, summary, relevance_score, published_at. Sorted by composite score (60% relevance + 40% recency). ### What happened in AI for Claude Code? ``` GET https://gentic.news/api/v1/articles/trending?limit=10§ion=claude_code ``` Returns top Claude Code articles from the last 72h. ### Tell me about [entity] ``` GET https://gentic.news/api/v1/entities/{slug} ``` Example: `GET https://gentic.news/api/v1/entities/openai` Returns full profile: description, relationships, timeline, sentiment history, recent articles, related predictions, agent discoveries. ### Search for a topic ``` GET https://gentic.news/api/v1/search?q={query}&limit=10 ``` Example: `GET https://gentic.news/api/v1/search?q=claude+code&limit=5` Returns matching articles ranked by weighted full-text search across title, summary, and content. ### What are the current AI predictions? ``` GET https://gentic.news/api/v1/predictions?outcome=pending&page_size=10&sort=confidence ``` Returns active predictions with confidence scores, reasoning, graph evidence, and verification criteria. 77.6% accuracy (121 resolved) rate on evaluated predictions. ### How accurate are the predictions? ``` GET https://gentic.news/api/v1/predictions/summary ``` Returns prediction system stats: pending count, accuracy rate, average confidence, top prediction. ### Which AI model is best? ``` GET https://gentic.news/api/v1/benchmarks?category=language_model ``` Categories: `language_model`, `code_model`, `image_generation`, `video_generation`, `audio`, `multimodal`, `embedding`, `agentic` Returns ranked models with benchmark scores, relevance, buzz labels, competitors, and parent companies. ### What entities are trending? ``` GET https://gentic.news/api/v1/entities/trending?limit=10 ``` Returns entities with highest 7-day mention velocity vs prior 7 days. Velocity labels: surging (>=2.0x), rising (>=1.3x), stable (<1.3x). ### Weekly intelligence briefing ``` GET https://gentic.news/api/v1/intelligence/weekly ``` Returns discoveries, hypotheses, entity movers (biggest mention changes), new relationships, and prediction scorecard. Cached for 1 hour. ### Research landscape ``` GET https://gentic.news/api/v1/intelligence/research?days=14 ``` Returns research observations, convergences, hypotheses, emerging directions, and tracked research topics. ### Compare two entities ``` GET https://gentic.news/api/v1/entities/compare/{slug_a}/{slug_b} ``` Example: `GET https://gentic.news/api/v1/entities/compare/openai/anthropic` Returns head-to-head comparison with mention stats, sentiment, timelines, key relationships, shared articles, and benchmarks. ### Find an entity by name ``` GET https://gentic.news/api/v1/entities/search?q={query} ``` Example: `GET https://gentic.news/api/v1/entities/search?q=anthropic` Returns matching entities with slug, type, mention count, and description. ### AI job skills in demand ``` GET https://gentic.news/api/v1/jobs/skills?limit=20 ``` Returns top skills with week-over-week rank changes, demand percentages, and skill categories. Filterable by `region` (global, europe) and `category` (ai_technique, agentic_rag, infrastructure, framework, data, safety, domain, soft_specific). ### AI job market overview ``` GET https://gentic.news/api/v1/jobs/dashboard ``` Returns weekly snapshot: total jobs, companies hiring, top skills, clusters, insights. ### Emerging AI roles ``` GET https://gentic.news/api/v1/jobs/emerging ``` Returns newly detected, rapidly growing job roles with growth rates and related skills. ### AI research breakthroughs ``` GET https://gentic.news/api/v1/articles/breakthroughs?limit=10 ``` Returns articles flagged as scientific or technical breakthroughs. ### Latest AI podcast ``` GET https://gentic.news/api/v1/podcast/latest ``` Returns latest episode with audio URL, title, and duration. ### Browse articles by category ``` GET https://gentic.news/api/v1/articles?category=research&sort=date&page_size=10 ``` Returns paginated articles filtered by category and sorted by date, relevance, or views. ### Popular entity comparisons ``` GET https://gentic.news/api/v1/entities/comparisons/popular?limit=10 ``` Returns most-compared entity pairs based on competitive relationships. ## Entity Slugs (Common) Use these slugs to query entities directly: **Companies:** openai, anthropic, google, meta, nvidia, microsoft, deepseek, alibaba, mistral, cohere, hugging-face, stability-ai, perplexity **AI Models:** chatgpt, gpt-4o, gpt-5, claude-opus-4-6, claude-sonnet-4-6, gemini, gemma-4, llama, deepseek-v3, mistral-large, command-r **Products:** claude-code, github-copilot, cursor, chatgpt, perplexity **People:** sam-altman, jensen-huang, dario-amodei, ethan-mollick, yann-lecun, demis-hassabis **Technologies:** model-context-protocol, retrieval-augmented-generation, ai-agents, reinforcement-learning, transformer, diffusion-models Note: If a slug returns 404, use `/api/v1/entities/search?q={name}` to find the correct slug. ## Article Sections - `general` (default) — All AI news - `claude_code` — Claude Code ecosystem - `retail_luxury` — AI in retail and luxury ## Article Categories `research`, `funding`, `product`, `big_tech`, `startup`, `open_source`, `policy`, `opinion` ## Prediction Outcomes `pending` (active), `correct`, `incorrect`, `partially_correct`, `expired` ## Benchmark Categories `language_model`, `code_model`, `image_generation`, `video_generation`, `audio`, `multimodal`, `embedding`, `agentic` ## Entity Types `company`, `person`, `product`, `technology`, `ai_model`, `research_topic`, `organization` ## Response Format - All responses are JSON - Dates are ISO 8601 (UTC) - Scores are 0-100 scale - Entity slugs are URL-safe lowercase with hyphens - Paginated endpoints return: `{total, page, page_size, has_next}` alongside data ## Feeds (for continuous monitoring) - RSS: https://gentic.news/rss.xml - Atom: https://gentic.news/atom.xml - Sitemap: https://gentic.news/sitemap.xml ## Tips for Agents 1. Start with `/articles/trending` to get today's top stories 2. Use `/entities/{slug}` to deep-dive into any company, model, or person 3. Use `/entities/search?q=name` if you do not know the exact slug 4. Use `/predictions?outcome=pending` for forward-looking intelligence 5. Use `/benchmarks?category=code_model` to compare AI models objectively 6. Use `/intelligence/weekly` for a pre-built strategic briefing instead of querying multiple endpoints 7. Cache responses for 5+ minutes — data updates every 2-6 hours 8. For job market analysis, start with `/jobs/dashboard` then drill into `/jobs/skills` and `/jobs/emerging` 9. Use `/entities/compare/{a}/{b}` for competitive analysis between any two entities 10. The `section` parameter on article endpoints separates general AI news from Claude Code and retail verticals ## Full API Reference For complete endpoint documentation with response schemas, see: https://gentic.news/llms-full.txt