NationStates API (nationdata/regiondata)

[Flanderlion]

On topic though - is there any way to get just the new notifications rather than the last X notifications with the new shard?

By default it works the same way as the regular site, where it returns new notifications plus any from the last 48 hours. The new ones have a tag like: <NEW>1</NEW>. I could add a "newonly" parameter or something.

If it is easy, yes please. If not, probably not worth the effort. I just realised in my testing I was doing it with a nation that didn't have any new notices, so I might try and have a play around for a bit.

[Atagait Denral]

Just curious, how come the string delimiter on most tags (WA Nations, Endorsements, etc) is a comma (,) but on the <nations> tag for regions, they're split with colons (:)? It doesn't actually make anything more difficult, but it's a weird inconsistency thing.

Edit: Would it be possible to get a shard for all WA nations in a region?

[Imperium Anglorum]

I found an incredibly handy work-around for getting delegate information via the API. It turns out polling all 19,131 regions isn't necessary. You can cut out all founderless regions, password regions, and class regions. Rather than taking 10 hours of requesting region data every 2 seconds, it neatly cuts it in half where you only have to spend about 5 hours.

It's still an absolutely absurd amount of time... but gotta get those non-exec founders somehow, amiright?

Use the daily dump.

[Ever-Wandering Souls]

I found an incredibly handy work-around for getting delegate information via the API. It turns out polling all 19,131 regions isn't necessary. You can cut out all founderless regions, password regions, and class regions. Rather than taking 10 hours of requesting region data every 2 seconds, it neatly cuts it in half where you only have to spend about 5 hours.

It's still an absolutely absurd amount of time... but gotta get those non-exec founders somehow, amiright?

Use the daily dump.

It's been asked before, but is there any chance of these being added to the regional data dump?

Yes, but right now we have length issues with the daily update, so I'm reluctant to add more load. Hopefully we can improve its run time in the near future and then add this.

[[violet]]

Okay, fine! We'll trial OFFICERS, DELEGATEAUTH, and FOUNDERAUTH in region Daily Dumps.

[Flanderlion]

Okay, fine! We'll trial OFFICERS, DELEGATEAUTH, and FOUNDERAUTH in region Daily Dumps.

Four hour tag raid? I'm looking forward to it. But in all seriousness, this seems cool, don't have plans to use it yet, but it seems like something I will use someday.

[Agadar]

Hey Violet, it's been quite a while ago when I requested whether you could take a look at my NS API Java wrapper. Dare I ask whether you've done so yet, and if so, what your verdict is?

EDIT: On another note, am I correct in saying it is currently not supported to find refounded nations similarly to how one can find new nations?

[Wyztrkstan]

I don't know if this is the thread for this, but here it goes.

Since NS++ recruitment is no longer working, I looked around a bit and stumbled upon this:

viewtopic.php?f=15&t=338301

Since I saw the whole scripting controversy with the raiders a while back, I don't want to run into the same issues with a script. So, I'm just asking to make sure. Is this legal to use?

[Caelapes]

I don't know if this is the thread for this, but here it goes.

Since NS++ recruitment is no longer working, I looked around a bit and stumbled upon this:

http://forum.nationstates.net/viewtopic ... 5&t=338301

Since I saw the whole scripting controversy with the raiders a while back, I don't want to run into the same issues with a script. So, I'm just asking to make sure. Is this legal to use?

It's legal, and works very well.

[Wyztrkstan]

I don't know if this is the thread for this, but here it goes.

Since NS++ recruitment is no longer working, I looked around a bit and stumbled upon this:

http://forum.nationstates.net/viewtopic ... 5&t=338301

Since I saw the whole scripting controversy with the raiders a while back, I don't want to run into the same issues with a script. So, I'm just asking to make sure. Is this legal to use?

It's legal, and works very well.

Okay, thanks!

[Agadar]

On another note: I have a need for my telegram app to be able to retrieve all nations in regions that have (or do not have) specified tags. Currently I do this by first retrieving the names of all the regions that have (or do not have) the specified tags using the regionsbytag-shard of the World API and then using that to individually retrieve the member nations of each region using the nations-shard of the Region API. However, this takes a lot of API calls and a lot of time.

I've looked into the Daily Data Dumps, but it seems they do not contain regional tags, so those aren't an option either. I'm looking forward to hear any alternatives there might exist.

[Eluvatar]

On another note: I have a need for my telegram app to be able to retrieve all nations in regions that have (or do not have) specified tags. Currently I do this by first retrieving the names of all the regions that have (or do not have) the specified tags using the regionsbytag-shard of the World API and then using that to individually retrieve the member nations of each region using the nations-shard of the Region API. However, this takes a lot of API calls and a lot of time.

I've looked into the Daily Data Dumps, but it seems they do not contain regional tags, so those aren't an option either. I'm looking forward to hear any alternatives there might exist.

You can use the API to discover which regions have which tags, then go through the daily data dumps and select those nations that it lists in the appropriate regions.

[Agadar]

On another note: I have a need for my telegram app to be able to retrieve all nations in regions that have (or do not have) specified tags. Currently I do this by first retrieving the names of all the regions that have (or do not have) the specified tags using the regionsbytag-shard of the World API and then using that to individually retrieve the member nations of each region using the nations-shard of the Region API. However, this takes a lot of API calls and a lot of time.

I've looked into the Daily Data Dumps, but it seems they do not contain regional tags, so those aren't an option either. I'm looking forward to hear any alternatives there might exist.

You can use the API to discover which regions have which tags, then go through the daily data dumps and select those nations that it lists in the appropriate regions.

That's a great solution. Can't believe I hadn't thought of that yet. Thanks a lot!

[Atagait Denral]

Could we get World Happenings type filters for Regional Happenings? I frequently finding myself wanting the sinceid, beforeid, and particularly filters (CTE+Changes).

[Zemnaya Svoboda]

Could we get World Happenings type filters for Regional Happenings? I frequently finding myself wanting the sinceid, beforeid, and particularly filters (CTE+Changes).

The world happenings can be viewed by region, although there are some oddities.

As Regional happenings are limited to 10 entries, I'm not sure that the benefit of such filters would be worth the cost of further complicating the API.

[Atagait Denral]

Could we get World Happenings type filters for Regional Happenings? I frequently finding myself wanting the sinceid, beforeid, and particularly filters (CTE+Changes).

The world happenings can be viewed by region, although there are some oddities.

As Regional happenings are limited to 10 entries, I'm not sure that the benefit of such filters would be worth the cost of further complicating the API.

True. And I was aware of those oddities. I'll have to go for that.

[HMS Unicorn]

Minor bug report

This nation is not in the World Assembly, and as far as I can tell has not been a member for at least two months: https://www.nationstates.net/nation=conscso_mal

However, it shows up in the API call for WA members, and has been listed there for at least a month: https://www.nationstates.net/cgi-bin/ap ... &q=members

[Eluvatar]

Minor bug report

This nation is not in the World Assembly, and as far as I can tell has not been a member for at least two months: https://www.nationstates.net/nation=conscso_mal

However, it shows up in the API call for WA members, and has been listed there for at least a month: https://www.nationstates.net/cgi-bin/ap ... &q=members

Guess it's time to run my validation tool again.

The following nations listed in http://www.nationstates.net/cgi-bin/api ... /q=members are not WA nations:

1. The Realm of Amen-Re on Earth [page]
2. conscso_mal [page]
3. Beire Beire (CTE) [page]
4. crispylands [page]
5. San Cannabis (CTE) [page]
6. door-to-door_book_salesman (CTE) [page]
7. lotheric (CTE) [page]
8. richmond uk [page]
9. the_main_nation (CTE) [page]

Worse, the following WA nations are not listed in http://www.nationstates.net/cgi-bin/api.cgi/wa=1/q=members:

1. lesser_pointeria
2. sharynation
3. tribaria
4. richmond_uk

[Drasnia]

What would lead the game to not validate these nations correctly?

[Eluvatar]

What would lead the game to not validate these nations correctly?

From what I recall, the most common causes are class regions and WA ejections.

[HMS Unicorn]

Minor bug report

In the World Assembly API, when using the "votetrack" and "dellog" shards with a resolution "id", they have no effect as expected:

https://www.nationstates.net/cgi-bin/api.cgi?wa=1&id=385&q=resolution+dellog
https://www.nationstates.net/cgi-bin/api.cgi?wa=1&id=385&q=resolution+votetrack

However, when using the "delvotes" shard, a DIV element reporting a system error appears:

https://www.nationstates.net/cgi-bin/api.cgi?wa=1&id=385&q=resolution+delvotes

This is inconsistent behavior (not just among these three shards, but also inconsistent with other API cases where shards have no effect). It is also problematic because the error-reporting DIV is not valid XML.

[Eluvatar]

Flagged for attention.

[[violet]]

However, when using the "delvotes" shard, a DIV element reporting a system error appears:

Fixed, thanks.

[HMS Unicorn]

Would it be possible to add an API request that gives the world-wide individual WA nation vote count for/against a WA resolution at vote?

Currently the only way to get this information is to make a gameside request to grab the GA or SC page, and then filter the Votes For and Votes Against reports to isolate the individual nation vote counts.

I would like to expand my WA voting records to also track worldwide individual vote counts. Having this information available through the API would make this a lot easier.

Thanks in advance!

[Agadar]

Not sure whether it's a bug, but the nation's tgcancruit shard ignores whether or not a nation is a class member.