API docs

Use the citation-gap API.

Public calls return two sample rows per query. A full-access key unlocks the complete JSON/CSV dump and raises API search to 100 rows per query.

Public search

GET https://citations-needed.granot.io/api/search?q=renewable%20energy&limit=2

Returns sample rows, total match count, and whether more results are locked.

Full-access search

export WCG_KEY="YOUR_KEY"curl -H "Authorization: Bearer $WCG_KEY" "https://citations-needed.granot.io/api/search?q=renewable%20energy&limit=100"

Email me an access key

Full data

curl -H "Authorization: Bearer $WCG_KEY" "https://citations-needed.granot.io/api/all"curl "https://citations-needed.granot.io/api/all.csv?access_key=YOUR_KEY"

The direct CSV link is included in the access email for no-code downloads.

Stats endpoint

GET https://citations-needed.granot.io/api/stats

Returns corpus counts, freshness, and the public cap.

Response fields

results: visible rows.
total_matches: total matching opportunities.
has_more: true when more are locked.
searched_only_existing_tags: true.