{"data":{"api_version":"v1","base_url":"https://api.newsspoiler.com/api/v1","authentication":{"required":false,"note":"Authorization: Bearer KEY or api_key query parameter may be supplied for attribution and integration tracking."},"endpoints":[{"path":"/status.php","method":"GET","description":"API and public snapshot status.","parameters":[]},{"path":"/articles.php","method":"GET","description":"Public-safe article list.","parameters":["category","source_domain","city","state_region","has_image","limit"]},{"path":"/images.php","method":"GET","description":"Public-safe articles with image_url.","parameters":["limit"]},{"path":"/search.php","method":"GET","description":"Controlled public-safe article search.","parameters":["q","category","source_domain","city","state_region","has_image","published_after","published_before","limit"]},{"path":"/article.php","method":"GET","description":"Single public-safe article by public id.","parameters":["id"]},{"path":"/related.php","method":"GET","description":"Related public-safe articles for a public id.","parameters":["id","limit"]},{"path":"/topics.php","method":"GET","description":"Public-safe topic directory.","parameters":["type","limit"]},{"path":"/topic.php","method":"GET","description":"Single public-safe topic by slug.","parameters":["slug"]},{"path":"/topic-articles.php","method":"GET","description":"Public-safe articles connected to a topic slug.","parameters":["slug","limit"]},{"path":"/entities.php","method":"GET","description":"Public-safe entity directory.","parameters":["type","limit"]},{"path":"/entity.php","method":"GET","description":"Single public-safe entity by slug.","parameters":["slug"]},{"path":"/entity-articles.php","method":"GET","description":"Public-safe articles connected to an entity slug.","parameters":["slug","limit"]},{"path":"/trending-topics.php","method":"GET","description":"Public-safe topic velocity ranked by article count.","parameters":["window","limit"]},{"path":"/trending-entities.php","method":"GET","description":"Public-safe entity velocity ranked by article count.","parameters":["window","limit"]},{"path":"/rising-topics.php","method":"GET","description":"Public-safe rising topics ranked by velocity.","parameters":["window","limit"]},{"path":"/rising-entities.php","method":"GET","description":"Public-safe rising entities ranked by velocity.","parameters":["window","limit"]},{"path":"/trending-categories.php","method":"GET","description":"Trending public categories from snapshot articles.","parameters":["limit"]},{"path":"/trending-sources.php","method":"GET","description":"Trending public sources from snapshot articles.","parameters":["limit"]},{"path":"/trending-locations.php","method":"GET","description":"Trending public locations from snapshot articles.","parameters":["limit"]}],"response_examples":{"list_envelope":{"data":[],"pagination":{"limit":25,"returned":0,"next_cursor":null},"meta":{"request_id":"example_request_id","api_version":"v1"}},"single_article_envelope":{"data":{"id":"public_article_id","title":"Example headline","excerpt":"Example public-safe excerpt.","url":"https://publisher.example/article","image_url":"https://publisher.example/image.jpg","source":{"name":"Publisher","domain":"publisher.example"},"category":{"name":"Gaming","slug":"gaming"},"location":{"city":"Philadelphia","state_region":"Pennsylvania","country":"United States"},"published_at":"2026-05-16T12:00:00+00:00","snapshot_updated_at":"2026-05-16T12:05:00+00:00"},"meta":{"request_id":"example_request_id","api_version":"v1"}},"error_envelope":{"error":{"code":"invalid_request","message":"The request could not be completed."},"meta":{"request_id":"example_request_id","api_version":"v1"}}},"notes":["The JSON API provides public-safe structured news snapshot data.","Operational ingestion systems remain internal to the platform.","The JSON API is a read-only content delivery layer.","Widget delivery is handled separately by https://widgets.newsspoiler.com."]},"meta":{"request_id":"6f5e72b2a40ba08c7ea714fd2b03c091","api_version":"v1"}}